BoxesPy pour instance Profouzors
Go to file
Florian Festi c2615d4b38 TypeTray: rearrange parts 2018-12-27 17:19:10 +01:00
boxes TypeTray: rearrange parts 2018-12-27 17:19:10 +01:00
documentation create travis build script for doc 2018-11-04 13:37:52 +01:00
examples changed /bin/bash to /usr/bin/env bash 2018-11-27 19:48:16 +01:00
inkex Build and ship inkscape inx files 2017-02-25 20:01:03 +01:00
scripts Unclutter Inkscape UI 2018-11-25 23:20:59 +01:00
static Pictures for CardBox, ShutterBox, TwoPiece and UnevenHeightBox 2018-12-21 20:16:40 +01:00
.gitignore Add boxes.egg-info to gitignore 2018-10-05 15:48:38 +02:00
.travis.yml create travis build script for doc 2018-11-04 13:37:52 +01:00
CODE_OF_CONDUCT.md Code of Conduct 2018-09-24 13:31:36 +02:00
CONTRIBUTING.rst CONTRIBUTING: Remove qoting needed for md format but breaking with rst 2018-09-11 17:59:13 +02:00
LICENSE.txt Licence the code under GPLv3 2014-03-16 18:26:12 +01:00
MANIFEST.in Build and ship inkscape inx files 2017-02-25 20:01:03 +01:00
README.rst http -> https 2018-07-17 23:16:12 +02:00
setup.py Python3 compat fix 2018-11-25 23:33:12 +01:00

README.rst

Boxes.py
========

Create boxes and more with a laser cutter!

Boxes.py is python library for generating drawings to be used with a laser
cutter. It comes with a growing set of ready-to-use, fully parametrized
generators:

* Boxes in various shapes and with various lids
* Boxes using flex cuts with rounded corners and living hinges
* Type trays with and without outer walls and floors
* Shelves
* Book covers with flex spine
* Magazine files
* Timing belt pulleys and gears
* and more

And a few one trick ponies:

* A desktop arcade cabinet
* A drill stand
* A castle tower
* A cutlery stand

Have a look into the  examples/  directory <https://github.com/florianfesti/boxes/tree/master/examples/>or the online generator <https://www.festi.info/boxes.py/index.html> to see how the results look like.

Features
--------

It generates SVG images that can be viewed directly in a web brower 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.

Usage
-----

There are multiple ways to use the available generators:

* Try them out at <https://www.festi.info/boxes.py/index.html>
* Use them as Inkscape extensions under *Extensions->Boxes.py*
* Execute the scripts/boxes tool and pass the name of the generator together with the measurements on the command line.
* Run *scripts/boxesserver* which provides an web interface on port 8000.
* Add a *WSGIScriptAlias* to *scripts/boxesserver* in your httpd config.

You can also create your own generators using *boxes/generators/_template.py* or any of the generators in *boxes/generators* as a starting point.

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

The module comes with Sphinx based documentation. The rendered version can be
viewed at <https://florianfesti.github.io/boxes/html/index.html>.