Documentation

This page is a short user manual. The first few chapters explain the concepts, which is followed by some examples.

You can find the documentation generated from the source code here.

Coordinate system

Coordinate System

fig: Coordinate System

Our coordinate system is right handed; with the x-axis pointing to the right, the y-axis moving away from us and the z-axis pointing up. Rotation has a right handed grip, which means that if you look from the origin of a vector the rotation is clock wise around this vector.

The left-near-bottom corner of voxel space is its origin. If you designed your object with its center in the origin, you will need to translate this object to vit inside voxel space.

Layers

The voxel space has 8 layers, each CSG object can belong to one or more of these layers. Each layer has a specific meaning:

Layer 1: Objects that should not be touched, like: Table, clamps, spruse and tools
Layer 2: The model; when hitting this layer the tool-path should be calculated from the actual CSG model.
Layer 3: The finishing layer around the model; it will be used to keep track of what parts of the model has been finished. During roughing this layer must be untouched.
Layer 4: The material to be removed after finishing; To detach the model from the spruse.
Layer 5: The material to be removed after later 6.
Layer 6..29: The material to be removed at different sections.
Layer 30: The first material to be removed, for example cutting of excess material before clamping the material securely.

Voxel value

Because memory is at a premium for voxel space a single voxel occupies 32 bits. These 32 bits have different meanings in different contexts.

1nnnnnnn nnnnnnnn nnnnnnnn nnnnnnnn	This is a non-leaf node in the oct-tree. n = node number
01llllll llllllll llllllll llllllll	This is a leaf node in the oct-tree. l = The 30 layers
00000000 00000000 00000000 00000000	This value is used internally to mean that not all childs have the same value.