Up    Next

off_align - alignment of OFF files

Usage    |    Examples    |    Notes

Usage

Synopsis

off_align [options] input_files

Description

Read a file in OFF format (the base) and use its vertices to position copies of itself or another file in OFF format (the brick).

Options

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

-h
program help

-p <pts>
two, four or six points given as the vertex index number in the OFF files (starting at 0), and separated by commas. The base points are all given first and then the brick points. Formats:

-f <idxs>
align by face index, up to three numbers separated by commas: base face index, brick face index (default: 0), polygon vertex offset (default: 0) to rotate the face

-F <idxs>
align and combine polyhedra by face index, up to three numbers separated by commas: base face index, brick face index (default: 0), polygon vertex offset (default: 0) to rotate the face. Brick after base, merge bond vertices, remove bond faces

-b <file>
brick file (default: base file)

-M <mrg>
merge files. 0 (default) don't merge, 1 brick after base, 2 brick before base

-R
Reverse orientation of brick, make it bond on other side of face

-x
don't scale the brick if the first base edge and brick edge are different lengths

-o <file>
write output to file, if this option is not used the program writes to standard output

Examples

Bond vertices 4, 5 and 6 of poly1.off to the first three vertices of poly2.off and write them into a single file in order poly1 then poly2.
   off_align -M 2 -p 0,1,2,4,5,6 -b poly1.off poly2.off
Augment face 1 of an icosahedron, making a polyhedron with 22 faces
   off_align -F 1 -b tet icosa 

Notes

This can be used to build larger structures using polyhedra as bricks.

When using -F the specified faces are deleted from the output. Faces in the base polyhderon that come after the bonding face will have their index numbers decreased by one in the output.

Up: Programs and Documentation
Next: off_util - utilities for OFF files

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