Comb is a script to comb the extrusion hair of a gcode file.
 
To run comb, install python 2.x on your machine, which is avaliable from http://www.python.org/download/
 
To use the preferences dialog you'll also need Tkinter, which probably came with the python installation.  If it did not, look for it at:
www.tcl.tk/software/tcltk/
 
To export a GNU Triangulated Surface file from Art of Illusion, you can use the Export GNU Triangulated Surface script at:
http://members.axion.net/~enrique/Export%20GNU%20Triangulated%20Surface.bsh
 
To bring it into Art of Illusion, drop it into the folder ArtOfIllusion/Scripts/Tools/.
 
The GNU Triangulated Surface format is supported by Mesh Viewer, and it is described at:
http://gts.sourceforge.net/reference/gts-surfaces.html#GTS-SURFACE-WRITE
 
To turn an STL file into filled, combed gcode, first import the file using the STL import plugin in the import submenu of the file menu
of Art of Illusion.  Then from the Scripts submenu in the Tools menu, choose Export GNU Triangulated Surface and select the
imported STL shape.  Then type 'python slice.py' in a shell in the folder which slice & comb are in and when the dialog pops up, set
the parameters and click 'Save Preferences'.  Then type 'python fill.py' in a shell in the folder which fill is in and when the dialog
pops up, set the parameters and click 'Save Preferences'.  Then type 'python comb.py' in a shell and when the dialog pops up,
change the parameters if you wish but the default 'Comb Hair' is fine.  Then click 'Comb', choose the file which you exported in
Export GNU Triangulated Surface and the filled & combed file will be saved with the suffix '_comb'.
 
To write documentation for this program, open a shell in the comb.py directory, then type 'pydoc -w comb', then open 'comb.html' in
a browser or click on the '?' button in the dialog.  To write documentation for all the python scripts in the directory, type 'pydoc -w ./'.
To use other functions of comb, type 'python' in a shell to run the python interpreter, then type 'import comb' to import this program.
 
The computation intensive python modules will use psyco if it is available and run about twice as fast.  Psyco is described at:
http://psyco.sourceforge.net/index.html
 
The psyco download page is:
http://psyco.sourceforge.net/download.html
 
The following examples comb the files Hollow Square.gcode & Hollow Square.gts.  The examples are run in a terminal in the folder which contains
Hollow Square.gcode, Hollow Square.gts and comb.py.  The comb function will comb if 'Comb Hair' is true, which can be set in the dialog or by changing
the preferences file 'comb.csv' with a text editor or a spreadsheet program set to separate tabs.  The functions combChainFile and
getCombChainGcode check to see if the text has been combed, if not they call the getFillChainGcode in fill.py to fill the text; once they
have the filled text, then they comb.
 
 
> pydoc -w comb
wrote comb.html
 
 
> python comb.py
This brings up the dialog, after clicking 'Comb', the following is printed:
File Hollow Square.gts is being chain combed.
The combed file is saved as Hollow Square_comb.gcode
 
 
>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 comb
>>> comb.main()
This brings up the comb dialog.
 
 
>>> comb.combChainFile()
Hollow Square.gts
File Hollow Square.gts is being chain combed.
The combed file is saved as Hollow Square_comb.gcode
 
 
>>> comb.combFile()
File Hollow Square.gcode is being combed.
The combed file is saved as Hollow Square_comb.gcode
 
 
>>> comb.getCombGcode("
( GCode generated by May 8, 2008 slice.py )
( Extruder Initialization )
..
many lines of gcode
..
")
 
 
>>> comb.getCombChainGcode("
( GCode generated by May 8, 2008 slice.py )
( Extruder Initialization )
..
many lines of gcode
..
")

Modules
		cStringIO euclidean fill gcodec intercircle preferences time vectorwrite

Classes
		CombPreferences CombSkein   class CombPreferences     A class to handle the comb preferences.     Methods defined here: __init__(self) Set the default preferences, execute title & preferences filename. execute(self) Comb button has been clicked.   class CombSkein     A class to comb a skein of extrusions.     Methods defined here: __init__(self) addGcodeMovement(self, point) Add a movement to the output. addIfTravel(self, splitLine) Add travel move around loops if this the extruder is off. addLine(self, line) Add a line of text and a newline to the output. addPathBetween(self, betweenFirst, betweenSecond, loopFirst) Add a path between the perimeter and the fill. addToLoop(self, location) Add a location to loop. getOutloopLocation(self, point) Add travel move around loops if this the extruder is off. insertPathsBetween(self, nextBeginning, pathEnd) Insert paths between the perimeter and the fill. linearMove(self, splitLine) Add a linear move to the loop. parseAddTravel(self, line) Parse a gcode line and add it to the comb skein. parseGcode(self, gcodeText) Parse gcode text and store the comb gcode. parseLine(self, line) Parse a gcode line. setBetweens(self) Set betweens for the layer.

Functions
		combChainFile(filename='') Comb a gcode linear move file.  Chain comb the gcode if it is not already combed. Depending on the preferences, either arcPoint, arcRadius, arcSegment, bevel or do nothing. If no filename is specified, comb the first unmodified gcode file in this folder. combFile(filename='') Comb a gcode linear move file.  Depending on the preferences, either arcPoint, arcRadius, arcSegment, bevel or do nothing. If no filename is specified, comb the first unmodified gcode file in this folder. getCombChainGcode(gcodeText, combPreferences=None) Comb a gcode linear move text.  Chain comb the gcode if it is not already combed. getCombGcode(gcodeText, combPreferences=None) Comb a gcode linear move text. isLoopNumberEqual(betweenX, betweenXIndex, loopNumber) Determine if the loop number is equal. main(hashtable=None) Display the comb dialog.

Data
		__author__ = 'Enrique Perez (perez_enrique@yahoo.com)' __date__ = '$Date: 2008/21/04 $' __license__ = 'GPL 3.0'

Author
		Enrique Perez (perez_enrique@yahoo.com)