Antiprism Up Next
Home
Programs
Examples
Album
Download
Development
Forum
About

off_normals - utility for working with normals

Usage    |    Examples    |    Notes

Usage



Usage: off_normals [options] [input_file]

Display normals of faces, implicit edges, and vertices
If input_file is not given the program reads from standard input.

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)

Scene Options
  -t        normal position. n - natural, a - add element centers (default: n)
  -u        unit normals
  -e        connect to element centroid (for reference)
  -p <opt>  force polarity. o - outward, i - inward
               r - reverse both inward and outward
  -i <elms> include normals. The element string can include o, i and h
               to show outward, inward and hemispherical
               note: exclusion occurs before -p (default: oih)
  -s <elms> include elements. The element string can include v, e and f
               to show vertices, edges and faces (default: f)
  -d <opt>  delete elements. f - delete faces of excluded normals
               a - delete all of original model
  -c <opts> average pattern string for edge and vertex normals. Done before -p
               r - raw, o - outward, i - inward, u - unit (default: r)
  -a        alternate calculation for vertex normals
  -x <opt>  face normals: n - Newell's, t - triangles, q - quads (default: n)
  -C <xyz>  center of model for normals, three comma separated coordinates
               0 for origin  (default: centroid)

Coloring Options (run 'off_util -H color' for help on color formats)
  -O <col>  outward normal vertex color
  -I <col>  inward normal vertex color
               default: vertex color is negative of outward col
  -H <col>  hemispherical normal vertex color  (default: gray50)
  -E <col>  normal vector color. connected to element centroid
               default: color of normal vertex
               keyword: r take random color
  -B <col>  normal vector base color. color at element centroid
               keyword: b take color of element (default)
               keyword: n take color of normal vertex

Examples

Show the normals of a dodecahedron. Outward normals will be colored white
off_normals dod -O white | antiview -v 0.075


Show the normals of a rhombic triacontahedron which has been oriented for negative volume so normals are reversed. Normals are joined to face centres with an edge of random colour, making it easier to see which normal belongs to which face
off_util -O n rt | off_normals -e -E r | antiview -v 0.075 -x f


Show the edge normals of an icosidodecahedron
off_normals icosidodecahedron -s e -O white -e | off_color -r A0.3,f | antiview -v 0.02


Notes

off_normals was written by Roger Kaufman.


     Next: conv_hull - convex hulls (using Qhull)
     Up: Programs and Documentation


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

Contact: adrian@antiprism.com      -      Modified 27.3.2019