Up    Next

off_util - utilities for OFF files

Usage    |    Examples    |    Notes

Usage

Synopsis

off_util [options] input_files

Description

Read one or more files in OFF format, combine them into a single file and process it. Operations take place in the order they are listed below.

Options

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

-h
program help

-M <elems>
Sort and merge elements whose coordinates are the same to the number of decimal places given by option -d, elems can include v, e, or f to merge vertices, edges (digons) and faces, or s to sort without merging (default: vef if option -l set)

-l <lim>
minimum distance for unique vertex locations as exponent 1e-lim (default: 8 giving 1e-8, if option -M set)

-O
orient the faces (if possible), flip orientation if oriented

-E
turn edges into (non-planar) faces

-s
skeleton, remove faces and write edges as two-edged faces (digons)

-F <filt>
Two-vertex faces (digons): D - remove, d - keep only
One-vertex faces ("vertices"): V - remove, v - keep only
One- and two-vertex faces: A - remove, a - keep only

-S
project onto unit sphere centred at origin

-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

Examples

Merge two file into a third
   off_util -o file3.off file1.off file2.off

Notes

Option -E is like the join operation in Conway Notation.

The digon filter can used in conjuction with off_color -e to strip the coloured edges, or extract them into a separate file.

The face sorting performed by option -M orients faces in a particular way. Option -O will generally reorient some of the sorted faces, and this will always be true if the input is a polyhedron.

Up: Programs and Documentation
Next: off_report - report global measures maxima and counts

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