Antiprism Up Next
Home
Programs
Examples
Album
Download
Development
Forum
About

stellate - polyhedron stellations

Usage    |    Examples    |    Notes

Usage



Usage: stellate [options] [input_file]

Stellate a polyhedron.

Options
  -h,--help this help message (run 'off_util -H help' for general help)
  --version version information
  -l <lim>  minimum distance for unique vertex locations as negative exponent
              (default: 12 giving 1e-12)
  -o <file> write output to file (default: write to standard output)

Program Options
  -f <fnos> face number of input file for stellation diagram (default: 0)
            followed by face numbers of stellation diagram for stellation
            model separated by commas. multiple -n parameters as needed
  -s <sym>  symmetry subgroup (Schoenflies notation)
  -M        do not merge stellation facelets
  -I        do not remove inline vertices (if not -M)
  -S        do not split pinched faces (if not -M)
  -R        resolve stellation facelets
  -D        remove multiples occurrences (sets -R)
  -r        rebuild compound model to separate vertices

Scene Options
  -O <args> output s - stellation, d - diagram, i - input model (default: s)
              (one of: D - diagram faces used highlighted, R - resolved faces
               used for stellation, S - expanded for symmetry)
              F - highlight used faces only (when using D, S or R)
  -z        move first diagram to face front (out of symmetry alignment)
  -w <int>  width to project stellation diagram (default: 500)
  
Coloring Options (run 'off_util -H color' for help on color formats)
keyword: none - sets no color
  -F <col>  color the faces according to: (default: q)
              a color value - apply to all faces
              k - sets of faces connected by face edges (compounds)
              s - symmetric colouring [,sub_group,conj_type]
              q - from stellation diagram
              h - face/face connection count (model is altered with kis)
  -E <col>  color the edges according to: (default: invisible)
              a color value - apply to all edges
              f - color with average adjacent face color
              q - from stellation diagram
              n - colour by number of faces connected to each edge
  -V <col>  color the vertices according to: (default: invisible)
              a color value - apply to all vertices
              e - color with average adjacent edge color
              f - color with average adjacent face color
              q - from stellation diagram
              n - color by order of vertex
  -T <t,e>  transparency. from 0 (invisible) to 255 (opaque). element is any
            or all of, v - vertices, e - edges, f - faces, a - all (default: f)
  -m <maps> a comma separated list of color maps used to transform color
            indexes (default: compound), a part consisting of letters from
            v, e, f, selects the element types to apply the map list to
            (default 'vef'). use map name of 'index' to output index numbers
              compound:   yellow,red,darkgreen,blue,magenta,cyan,darkorange1

Examples

Display the stellation diagram for the icosahedron in I symmetry
stellate ico -f 0 -s I | antiview


Create a torroid stellation from the icosahedron. off_trans is used to position the icosahedron in D5 symmetry. Then face 18 is used from stellation diagram for icosahedron face 0. Faces 4 and 47 are used from stellation diagram for icosahedron face 3. -s D5v specifies which sub-symmetry to use.
off_trans -y D5 ico | stellate -f 0,18 -f 3,4,47 -s D5v | antiview


Notes

stellate was written by Roger Kaufman.

It offers a way to generate stellation diagrams and build off of these to generate stellations.


     Next: conway - Conway Notation transformations
     Up: Programs and Documentation


Home   |   Programs   |   Examples   |   Album   |   Download   |   Development   |   Forum   |   About

Contact: adrian@antiprism.com      -      Modified 27.3.2019