G-STL(1)

NAME
g-stl - Stereolithography Translator (BRL-CAD to STL)

SYNOPSIS
g-stl [-b][-v][-i][-8] [-xX lvl] [-D calculation_tolerance ] [-a abs_tol] [-r rel_tol] [-n norm_tol] [-o STL_file | -m directory_name] database.g object(s)

DESCRIPTION
g-stl converts the specified object(s) from a BRL-CAD database.g file to the stereolithography file format. The -x option specifies an RT debug flag and the -X option specifies an NMG debug flag. The -a , -r , and -n options specifiy tesselation tolerances. The -D option specifies a calculational distance tolerance (mm). Any two vertices that are less than this distance apart will be treated as the same vertex. The -v option requests verbose output. The -i option requests the output file units to be inches (the default is mm). The -b option requests binary output (the default in ASCII). In the case of ASCII output, the region name is specified on the "solid" line of the STL file. In the case of binary output, all the regions are output as a single STL part. The -8 option tells the facetizer to use the marching cubes algorithm. The -o option specifies the name of the file to receive the output (stdout is the default). The -m option specifies the name of a directory where the output files will be placed. In this case each region converted is written to a separate file and placed in this directory. The file names are constructed from the full path names of each region (path from the specified object to the region). Any "/" characters in the path name are replaced by "@" characters, and "." and white space are replaced by "_" characters. If the -m option is not specified, then all the regions are written to the same file. The -o and -m options are mutually exclusive.

EXAMPLE
    $ g-stl -o sample.stl sample.g sample_object

DIAGNOSTICS
Error messages are intended to be self-explanatory.

BUG REPORTS
Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>.