Up    Next

antiview - interactive OFF file viewer

Usage    |    Viewing    |    Examples    |    Notes

Usage

Synopsis

antiview [options] input_files

Description

Display OFF files in an interactive viewer.

Options

input_files
input files in OFF format, or if not given the program reads from standard input

-h
program help

-v <rad>
radius of vertex spheres, or 'b' to have radius of balls in the first file 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_val,g_val,b_val (values 0.0-1.0, or 0-255) or hex xFFFFFF (default: 1.0,0.5,0.0)

-E <col>
colour for edges, in form r_val,g_val,b_val (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_val,g_val,b_val (values 0.0-1.0, or 0-255) or hex xFFFFFF (default: 0.8,0.9,0.9)

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

-n <elems>
show element index number labels. The element string can include v, e and f to label vertices, edges and faces

-m <map>
map colour indexes into colour values, map is given as 'file,elems,conv_type' for colour map file, conv_type is (default 3) elements to map are v, e or f

-w <width>
width of sphere containing points (default: calculated)

-I <dist>
maximum distance from origin for viewable points (default: ignored)
Scene 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)

-B <col>
background colour, in form r_val,g_val,b_val (values 0.0-1.0, or 0-255) or hex xFFFFFF

Viewing

There are four main viewing control modes - rotation (default), drag, zoom, slice. Select a different mode with the following keys, or right-click on the window and select from the menu

Click and drag on the window with the mouse to move the model, or use the arrow keys. The zoom and slice are controlled by forward and backward dragging, or the up and down arrow keys.

Menu Items

r - Rotate
turn the model about its centre

d - Drag
drag the model around the screen

z - Zoom
Zoom in or out

s - Spin Control
set or stop the model spinning

S - Slice
Slice into the model. There is a slicing plane just in front of the screen which can be moved forward and backwards. It may take a couple of forward drags with the mouse (or hold down the the up-arrow key for a few seconds) until this plane reaches the model and starts slicing into it.

P - Projection Type
Toggle display between perspective and orthogonal projection

V - Show/Hide Vertices
Toggle display of vertex spheres

E - Show/Hide Edges
Toggle display of edge rods

F - Show/Hide Faces
Toggle display of faces

n - Show/Hide Vertex Numbers
Toggle display of vertex number labels

N - Show/Hide Face Numbers
Toggle display of face number labels

M - Show/Hide Edge Numbers
Toggle display of edge number labels

T - Show/Hide Transparency
Toggle display of transparency (for input containing alpha values)

R - Reset
Reset to the initial viewing options
Q - Quit

Other Keys

J - Increase Vertex and Edge Size
j - Decrease Vertex and Edge Size
K - Increase Vertex Size
k - Decrease Vertex Size
L - Increase Edge Size
l - Decrease Edge Size
c - Toggle label colours between light and dark
C - Invert label colours

Examples

Display some polyhedra
   antiview poly1.off poly2.off poly3.off
Colour a polyhedron by polygon type and display it
   unipoly truncated cubo | off_color -f N -s 60| antiview
Display a ball pack as balls
   packer 0.2 | antiview -v b
Draw an icosahedron without its faces
   unipoly icosahedron | antiview -x f
Display a proper coloured icosahedron without its vertex or edge elements
   unipoly icosahedron | off_color -f P | antiview -x ve 
Display an icosahedron with thin vertex and edge elements
   unipoly icosahedron | antiview -v 0.01 -e 0.008
Display an icosahedron-based weave, excluding faces, and showing the edges in the face colour
   unipoly icosahedron | poly_weave | off_color -f U -e F | antiview -v 0.1 -x f

Notes

Use -v b to draw ball packs.

Up: Programs and Documentation
Next: off2pov - converts an OFF file to POV format

Antiprism Documentation 16.11.2007 - http://www.antiprism.com/