off_color - adds colours to an OFF file

Usage | Examples | Notes

Usage

Description

Read a file in OFF format and add colours to it.

Options

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

-h

program help

-v <col>

colour the vertices according to

one integer - colour index for all vertices
three integers (0 - 255) - colour value for all vertices
three floats (0.0 - 1.0 - colour value for all vertices
u - unique colour using colour indexes
U - unique colour using colour values
p - minimal proper colouring using colour indexes
P - minimal proper colouring using colour values
n - different colour index for each order of vertex
N - different colour for each order of vertex
G - hue gradient on Y coordinate

-f <col>

colour the faces according to

one integer - colour index for all faces
three integers (0 - 255) - colour value for all faces
three floats (0.0 - 1.0 - colour value for all faces
u - unique colour using colour indexes
U - unique colour using colour values
p - minimal proper colouring using colour indexes
P - minimal proper colouring using colour values
n - different colour index for each polygon type (num of sides)
N - different colour for each polygon type (num of sides)
G - hue gradient on Y coordinate of normal
C - hue gradient on Y coordinate of centroid

-s <sch>

use the colour scheme given by a number (all numbers have a scheme), or if 0 then use a scheme chosen at random

-m <file>

map colour indexes into colour values using colour map file, which contains a list of mappings in the format index_number = colour e.g.

   9 = 0.5 1.0 0.0

with one mapping per line (implies -c which defaults to 2).

-c <conv>

convert indexes after all processing, can be:

1 - use only colours in the colour map file
2 - use colour scheme for index numbers not in the map file

-H <range>

range for hue in generated color map, one or two values, (separated by a comma) between 0.0 and 1.0 (default:0.0,1.0)

-S <range>

range for saturation in generated color map, one or two values, (separated by a comma) between 0.0 and 1.0 (default:0.7,1.0)

-V <range>

range for hue in generated color map, one or two values, (separated by a comma) between 0.0 and 1.0 (default:0.7,1.0)

-o <file>

write output to file, if this option is not used the program writes to standard output

Examples

Make a cuboctahedron with the triangle faces a different colour to the square faces

   unipoly cuboctahedron | off_color -f N -o cubo.off

Same again, but make the colours black and white. Create a file called my_colormap.txt with these two lines which convert index numbers into colour values (with the -f n option faces have an index number the same as their number of sides).

   3 = 0.0 0.0 0.0
   4 = 1.0 1.0 1.0

Now the command is

   unipoly cuboctahedron | off_color -f n -m my_colormap.txt -o cubo.off

Notes

Up: Programs and Documentation
Next: off_trans - transformations (rotations, etc) of OFF files

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