Up    Next

off2pov - converts an OFF file to POV format

Usage    |    Examples    |    Notes

Usage

Synopsis

off2pov [options] [input_file]

Description

Convert an OFF file to POV format for display in povray.

Options

input_file
input file in OFF format, or if not given the program reads from stdin

-h
program help

-v <rad>
radius of vertex spheres (0 for no vertex sphere), or 'b' to have radius of balls of the maximum size without overlap (default: ball_rad/8)

-e <rad>
radius of edge cylinders (default: vertex_rad/2)

-x <elems>
hide elements. The element string can include v, e and f to hide, respectively, vertices, edges and faces

-n
show vertex numbers

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

-o <file>
write output to file, if this option is not used the program writes to standard output
Viewing Options
-D <dist>
distance to camera

-C <cent>
centre of points, in form "x_val,y_val,z_val" (default: calculated)

-L <look>
point to look at, in form "x_val,y_val,z_val" (default: points centre)

-R <rot>
rotate about axes through centre of points, in form "x_val,y_val,z_val" (degrees)

-P <pers>
narrow the angle of perspective (range 0-100, default: 2 mono, 4 stereo)

-W <shad>
use lighting with shadows can be 0 (default) yes for mono no for stereo, 1 yes, 2 no

-S <ster>
produce stereo output, val is 0 (default) mono, 1 stereo with one image file, 2 stereo with two image files (use something like povrays +KFF2 option for output), 3 mono with four views around the object

Precision Options

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

-t
triangulate POV polygons by joining each edge to a centre point. (Incomplete solution to rendering non-coplanar and non-simple polygons. Will not render all polygons correctly.)

Examples

Draw a ball pack as balls
   off2pov -v b -o pack.pov pack.off
Draw the other side of it
   off2pov -v b -R 0,180,0 -o pack.pov pack.off
Draw an icosahedron without its faces
   unipoly icosahedron | off2pov -x f -o icosa.pov
Draw an icosahedron without its vertex or edge elements
   unipoly icosahedron | off2pov -x ve -o icosa.pov
Draw an icosahedron with thin vertex and edge elements
   unipoly icosahedron | off2pov -v 0.01 -e 0.008 -o icosa.pov

Notes

The output POV file is easy to edit in a text editor. Many of the program options which are used when creating the file can also be set afterwards by editing the file.

Points coinciding, or very close together, may cause no elements to be drawn for the vertices or edges if default sizes are used. Instead, a value can be set with -v or -e.

Use -v b to draw ball packs.

Non-planar faces can be drawn with the -t option. Self-intersecting faces also need the -t option. However this option may draw parts of the face outside of the edges.

Up: Programs and Documentation
Next: off_color - adds colours to an OFF file

Packinon Documentation 15.6.2005 - http://packinon.sourceforge.net/