# Python: module skeinforge_application.skeinforge_plugins.craft_plugins.chop

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

Previous / Next / Contents

`
Chop is a script to chop a shape into svg slice layers.
Settings
Add Layer Template to SVG
Add Extra Top Layer if Necessary
Extra Decimal Places
Import Coarseness
Layer Height
Layers
Layers From
Layers To
Mesh Type
Correct Mesh
Unproven Mesh
Perimeter Width
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.

### Add Extra Top Layer if Necessary

Default is on.
When selected, chop will add an extra layer at the very top of the object if the top of the object is more than half the layer height above the first slice. This is so the cutting tool doesn't cut too deeply through the top of the object on its first pass.

### 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 height. 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 edge width.

### Layer Height

Default is 0.4 mm.
Defines the height of the layer, this is the most important chop setting.

### Layers

Chop slices from top to bottom. To get only the bottom layer, set the "Layers From" to minus one. The 'Layers From' until 'Layers To' range is a python slice.

#### Layers From

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

#### Layers To

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

### Mesh Type

Default is 'Correct Mesh'.

#### Correct Mesh

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

#### Unproven Mesh

When selected, chop 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

Default is 2 mm.
Defines the width of the edge.

### 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 chop the file Screw Holder Bottom.stl. The examples are run in a terminal in the folder which contains Screw Holder Bottom.stl and chop.py.
> python chop.py
This brings up the chop dialog.
> python chop.py Screw Holder Bottom.stl
The chop tool is parsing the file:
Screw Holder Bottom.stl
..
The chop tool has created the file:
.. Screw Holder Bottom_chop.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

``

ChopRepository
ChopSkein

class ChopRepository
`` | `A class to handle the chop settings.`

Methods defined here:

__init__(self)
  `Set the default settings, execute title & settings fileName.`

execute(self)
  `Chop button has been clicked.`

class ChopSkein
`` | `A class to chop a carving.`

Methods defined here:

addExtraTopLayerIfNecessary(self, carving, layerHeight, loopLayers)
  `Add extra top layer if necessary.`

getCarvedSVG(self, carving, fileName, repository)
  `Parse gnu triangulated surface text and store the chopped gcode.`

Functions

``

getCraftedText(fileName, gcodeText='', repository=None)
  `Get chopped text.`

getNewRepository()
  `Get new repository.`

main()
  `Display the chop dialog.`

writeOutput(fileName, shouldAnalyze=True)
  `Chop a GNU Triangulated Surface file. If no fileName is specified, chop the first GNU Triangulated Surface file in this folder.`

Data
`` |  | __author__ = 'Enrique Perez (perez_enrique@yahoo.com)' __date__ = '$Date: 2008/02/05 $' __license__ = 'GNU Affero General Public License http://www.gnu.org/licenses/agpl.html' absolute_import = _Feature((2, 5, 0, 'alpha', 1), (2, 7, 0, 'alpha', 0), 16384)

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