BoxesPy pour instance Profouzors
Go to file
Florian Festi 1115683449 Add separating comments 2016-04-10 22:51:25 +02:00
boxes Add separating comments 2016-04-10 22:51:25 +02:00
documentation Remove obsolete entries from TODO list 2016-04-09 20:54:23 +02:00
examples Update examples 2016-04-02 20:51:41 +02:00
scripts Minor text edit 2016-04-02 18:01:10 +02:00
.gitignore Make this a proper Python package using setuptools 2016-03-26 11:12:14 +01:00
LICENSE.txt Licence the code under GPLv3 2014-03-16 18:26:12 +01:00
MANIFEST.in Make this a proper Python package using setuptools 2016-03-26 11:12:14 +01:00
README.rst Fix some typos 2016-03-30 22:15:58 +02:00
setup.py Make this a proper Python package using setuptools 2016-03-26 11:12:14 +01:00

README.rst

What is this?
=============

This is a small python library for generating SVG drawings used for
cutting out boxes or other structures using a laser cutter.

It also comes with a set of ready-to-use, fully parametrized generators:

* Various simple boxes
* Flex boxes with rounded corners and living hinges
* Type trays with and without walls and floors
* Book cover with flex spine
* Magazine file

And a few one trick ponies:

* A drill stand
* A castle tower
* A housing for a special kind of lamp
* A cutlery stand

Have a look into the examples/ directory to see how the results look like.

Features
========

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 finished generators.

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

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

Usage
=====

There are two ways to use the available generators:

* 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