skeinforge_application.skeinforge_plugins.craft_plugins.carve ($Date: 2008/02/05 $) | index /home/enrique/Desktop/backup/babbleold/script/reprap/fabmetheus/skeinforge_application/skeinforge_plugins/craft_plugins/carve.py

Previous / Next / Contents

`
Carve is a script to carve a shape into svg slice layers.
The carve manual page is at:
http://fabmetheus.crsndoo.com/wiki/index.php/Skeinforge_Carve
On the Arcol Blog a method of deriving the layer thickness is posted. That article "Machine Calibrating" is at:
http://blog.arcol.hu/?p=157
Settings
Add Layer Template to SVG
Extra Decimal Places
Import Coarseness
Infill in Direction of Bridge
Layer Thickness
Layers
Layers From
Layers To
Mesh Type
Correct Mesh
Unproven Mesh
Perimeter Width over Thickness
SVG Viewer
Examples
`

## Settings

### Add Layer Template to SVG

Default is on.
When selected, the layer template will be added to the svg output, which adds javascript control boxes. So 'Add Layer Template to SVG' should be selected when the svg will be viewed in a browser.
When off, no controls will be added, the svg output will only include the fabrication paths. So 'Add Layer Template to SVG' should be deselected when the svg will be used by other software, like Inkscape.

### Extra Decimal Places

Default is two.
Defines the number of extra decimal places export will output compared to the number of decimal places in the layer thickness. The higher the 'Extra Decimal Places', the more significant figures the output numbers will have.

### Import Coarseness

Default is one.
When a triangle mesh has holes in it, the triangle mesh slicer switches over to a slow algorithm that spans gaps in the mesh. The higher the 'Import Coarseness' setting, the wider the gaps in the mesh it will span. An import coarseness of one means it will span gaps of the perimeter width.

### Infill in Direction of Bridge

Default is on.
When selected, the infill will be in the direction of any bridge across a gap, so that the fill will be able to span a bridge easier.

### Layer Thickness

Default is 0.4 mm.
Defines the thickness of the extrusion layer at default extruder speed, this is the most important carve setting.

### Layers

Carve slices from bottom to top. To get a single layer, set the "Layers From" to zero and the "Layers To" to one. The 'Layers From' until 'Layers To' range is a python slice.

#### Layers From

Default is zero.
Defines the index of the bottom layer that will be carved. If the 'Layers From' is the default zero, the carving will start from the lowest layer. If the 'Layers From' index is negative, then the carving will start from the 'Layers From' index below the top layer.

#### Layers To

Default is a huge number, which will be limited to the highest index layer.
Defines the index of the top layer that will be carved. If the 'Layers To' index is a huge number like the default, the carving will go to the top of the model. If the 'Layers To' index is negative, then the carving will go to the 'Layers To' index below the top layer.

### Mesh Type

Default is 'Correct Mesh'.

#### Correct Mesh

When selected, the mesh will be accurately carved, and if a hole is found, carve will switch over to the algorithm that spans gaps.

#### Unproven Mesh

When selected, carve will use the gap spanning algorithm from the start. The problem with the gap spanning algothm is that it will span gaps, even if there is not actually a gap in the model.

### Perimeter Width over Thickness

Default is 1.8.
Defines the ratio of the extrusion perimeter width to the layer thickness. The higher the value the more the perimeter will be inset, the default is 1.8. A ratio of one means the extrusion is a circle, a typical ratio of 1.8 means the extrusion is a wide oval. These values should be measured from a test extrusion line.

### SVG Viewer

Default is webbrowser.
If the 'SVG Viewer' is set to the default 'webbrowser', the scalable vector graphics file will be sent to the default browser to be opened. If the 'SVG Viewer' is set to a program name, the scalable vector graphics file will be sent to that program to be opened.

## Examples

The following examples carve the file Screw Holder Bottom.stl. The examples are run in a terminal in the folder which contains Screw Holder Bottom.stl and carve.py.
> python carve.py
This brings up the carve dialog.
> python carve.py Screw Holder Bottom.stl
The carve tool is parsing the file:
Screw Holder Bottom.stl
..
The carve tool has created the file:
.. Screw Holder Bottom_carve.svg
> python
Python 2.5.1 (r251:54863, Sep 22 2007, 01:43:31)
[GCC 4.2.1 (SUSE Linux)] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import carve
>>> carve.main()
This brings up the carve dialog.
>>> carve.writeOutput('Screw Holder Bottom.stl')
The carve tool is parsing the file:
Screw Holder Bottom.stl
..
The carve tool has created the file:
.. Screw Holder Bottom_carve.svg

Previous / Next / Contents

Modules
`` |  |
__init__ fabmetheus_utilities.archive fabmetheus_utilities.euclidean fabmetheus_utilities.fabmetheus_tools.fabmetheus_interpret | fabmetheus_utilities.gcodec math os fabmetheus_utilities.settings | skeinforge_application.skeinforge_utilities.skeinforge_polyfile skeinforge_application.skeinforge_utilities.skeinforge_profile fabmetheus_utilities.svg_writer sys | time

Classes
`` |  | CarveRepository CarveSkein
class CarveRepository
`` | `A class to handle the carve settings.`
| Methods defined here: __init__(self) `Set the default settings, execute title & settings fileName.` execute(self) `Carve button has been clicked.`
class CarveSkein
`` | `A class to carve a carving.`
| Methods defined here: getCarvedSVG(self, carving, fileName, repository) `Parse gnu triangulated surface text and store the carved gcode.`

Functions
`` |  | getCraftedText(fileName, gcodeText='', repository=None) `Get carved text.` getNewRepository() `Get the repository constructor.` main() `Display the carve dialog.` writeOutput(fileName='') `Carve a GNU Triangulated Surface file.`

Data
`` |  | __author__ = 'Enrique Perez (perez_enrique@yahoo.com)' __date__ = '$Date: 2008/02/05 $' __license__ = 'GPL 3.0' absolute_import = _Feature((2, 5, 0, 'alpha', 1), (2, 7, 0, 'alpha', 0), 16384)

Author
`` |  | Enrique Perez (perez_enrique@yahoo.com)