Antiprism Up Next
Home
Programs
Examples
Album
Download
Development
Forum
About

off2vrml - convert OFF files to VRML format

Usage    |    Examples    |    Notes

Usage



Usage: off2vrml [options] input_files

Convert files in OFF format to VRML format. If input_files are 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
  -v <rad>  radius of vertex spheres, or 'b' to have radius of balls
            of the maximum size without overlap (default: ball_rad/15)
  -e <rad>  radius of edge cylinders (default: vertex_rad/1.5)
  -V <col>  default vertex colour, in form 'R,G,B,A' (3 or 4 values
            0.0-1.0, or 0-255) or hex 'xFFFFFF' (default: 1.0,0.5,0.0)
  -E <col>  default edge colour, in form 'R,G,B,A' (3 or 4 values
            0.0-1.0, or 0-255) or hex 'xFFFFFF', 'x' to hide implicit edges
            (default: 0.8,0.6,0.8)
  -F <col>  default face colour, in form 'R,G,B,A' (3 or 4 values
            0.0-1.0, or 0-255) or hex 'xFFFFFF' (default: 0.8,0.9,0.9)
  -x <elms> hide elements. The element string can include v, e and f
            to hide vertices, edges and faces
  -n <elms> show element index number labels. The element string can
            include v, e and f to label vertices, edges and faces
  -s <syms> show symmetry elements. The element string can include
               x - rotation axes
               m - mirror planes
               r - rotation-reflection planes
               a - all elements (same as xmr)
  -m <maps> a comma separated list of colour maps used to transform colour
            indexes, a part consisting of letters from v, e, f, selects 
            the element types to apply the map list to (default 'vef').
  -t <disp> select face parts to display according to winding number from:
            odd, nonzero (default), positive, negative, no_triangulation
            (use native polygon display)

  -l        use lines for edges, points for vertices, in default colours
  -o <file> write output to file (default: write to standard output)

  Scene options
  -D <dist> distance to camera
  -C <cent> centre of points, in form 'X,Y,Z'
  -L <look> point to look at, in form 'X,Y,Z'
            (default, points centre)
  -R <rot>  rotate about axes through centre of points, in
            form 'X-ang,Y-ang,Z-ang' (degrees)
  -B <col>  background colour, in form 'R,G,B,A' (3 or 4 values
            0.0-1.0, or 0-255) or hex 'xFFFFFF'


  Precision options
  -d <dgts> number of significant digits (default 17) or if negative
            then the number of digits after the decimal point


Examples

Display a ball pack as balls
lat_grid bcc |  off2vrml -xef -v b -o pack.wrl


Display an icosahedron without its faces
off2vrml -x f -o icosa.wrl icosahedron


Display an icosahedron without its vertex or edge elements
off2vrml -x ef -o icosa.wrl icosahedron


Display an icosahedron with thin vertex and edge elements
off2vrml -v 0.01 -e 0.008 -o icosa.wrl icosahedron


Display a polyhedron with self-intersecting polygons, using transparent faces
polygon anti 5/3 | off2vrml -F 0.3,0.6,0.8,0.5 -o anti.wrl


Notes

When viewing in the VRML browser the rotation centre will most likely be assigned to the Look At point. Rotations given with option -R happen prior to viewing and use the actual rotation centre.

Use -v b to draw ball packs.

OFF files with a lot of elements will produce large VRML files that may be difficult to render on some machines. Excluding vertex and edge elements will greatly reduce the resources required to render the VRML file.


     Next: off2dae - convert an OFF file to Collada (DAE) format
     Up: Programs and Documentation


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

Contact: adrian@antiprism.com      -      Modified 27.5.2023