boxespy

BoxesPy pour instance Profouzors

Go to file

Florian Festi c4b0971d03 topEdges: Give better names to variables		2022-10-01 13:35:51 +02:00
.github/ISSUE_TEMPLATE	Add issue templates	2022-09-23 21:44:34 +02:00
boxes	topEdges: Give better names to variables	2022-10-01 13:35:51 +02:00
documentation	FingerJointEdges: Better deal with short edges	2022-09-30 19:28:01 +02:00
examples	examples/generate.sh: Remove no longer existing generator "box"	2020-03-07 20:22:27 +01:00
inkex	Build and ship inkscape inx files	2017-02-25 20:01:03 +01:00
locale	Remove backslash from description	2022-03-12 18:24:11 +01:00
po	Update .pot file	2022-07-31 00:33:34 +02:00
scripts	Announce menu collapse and expand	2022-09-08 09:03:56 +02:00
static	New generator: HalfBox	2022-09-30 19:28:01 +02:00
.gitattributes	Create .gitattributes	2022-09-06 18:52:06 +02:00
.gitignore	ignore vscode and venv	2020-05-18 22:30:28 +02:00
.travis.yml	Add fillHoles() function	2022-07-23 09:53:11 +02:00
CODE_OF_CONDUCT.md	Code of Conduct	2018-09-24 13:31:36 +02:00
CONTRIBUTING.rst	Document where all to add new dependencies	2022-07-17 14:11:25 +02:00
LICENSE.txt	Licence the code under GPLv3	2014-03-16 18:26:12 +01:00
MANIFEST.in	Add translations files from zanata to the repository	2019-08-22 12:19:23 +02:00
README.rst	More tables	2021-05-23 19:08:38 +02:00
requirements.txt	Add fillHoles() function	2022-07-23 09:53:11 +02:00
setup.py	Add fillHoles() function	2022-07-23 09:53:11 +02:00

README.rst

About Boxes.py
==============

+----------------------------------------------+----------------------------------------------+----------------------------------------------+----------------------------------------------+----------------------------------------------+
| .. image:: static/samples/NotesHolder.jpg | .. image:: static/samples/OttoBody.jpg | .. image:: static/samples/PaintStorage.jpg | .. image:: static/samples/ShutterBox.jpg | .. image:: static/samples/TwoPiece.jpg |
+----------------------------------------------+----------------------------------------------+----------------------------------------------+----------------------------------------------+----------------------------------------------+

* Boxes.py is an online box generator

* https://www.festi.info/boxes.py/index.html

* Boxes.py is an Inkscape plug-in
* Boxes.py is library to write your own
* Boxes.py is free software licensed under GPL v3+
* Boxes.py is written in Python and runs with Python 3

Boxes.py comes with a growing set of ready-to-use, fully parametrized
generators. See https://florianfesti.github.io/boxes/html/generators.html for the full list.

Features
--------

Boxes.py generates SVG images that can be viewed directly in a web browser but also
postscript and - with pstoedit as external helper - other vector formats
including dxf, plt (aka hpgl) and gcode.

Of course the library and the generators allow selecting the "thickness"
of the material used and automatically adjusts lengths and width of
joining fingers and other elements.

The "burn" parameter compensates for the material removed by the laser. This
allows fine tuning the gaps between joins up to the point where plywood
can be press fitted even without any glue.

Finger Joints are the work horse of the library. They allow 90° edges
and T connections. Their size is scaled up with the material
"thickness" to maintain the same appearance. The library also allows
putting holes and slots for screws (bed bolts) into finger joints,
although this is currently not supported for the included generators.

Dovetail joints can be used to join pieces in the same plane.

Flex cuts allows bending and stretching the material in one direction. This
is used for rounded edges and living hinges.

+----------------------------------------------+----------------------------------------------+----------------------------------------------+
| .. image:: static/samples/TypeTray.jpg | .. image:: static/samples/BinTray.jpg | .. image:: static/samples/DisplayShelf.jpg |
+----------------------------------------------+----------------------------------------------+----------------------------------------------+
| .. image:: static/samples/AgricolaInsert.jpg | .. image:: static/samples/HeartBox.jpg | .. image:: static/samples/Atreus21.jpg |
+----------------------------------------------+----------------------------------------------+----------------------------------------------+

Documentation
-------------

Boxes.py comes with Sphinx based documentation for usage, installation
and development.

The rendered version can be viewed at <https://florianfesti.github.io/boxes/html/index.html>.