REPLMARKS(1)
NAME
replmarks - replace triangular markers in a RADIANCE scene description
SYNOPSIS
replmarks [ -e ][ -m newmod ][ -s scale ] { -x objfile | -i octree | -I
mesh } modname .. [ file .. ]
DESCRIPTION
Replmarks replaces triangular markers identified by the modifier modname in each scene description file and writes the result to the standard output. The -x option indicates that each marker should be
replaced by an appropriate xform(1) command on objfile. The -i option
indicates that each marker should be replaced by an instance of octree.
The -I option indicates that each marker should be replaced by an
instance of the Radiance mesh mesh. One of these three options must
appear on the command line, along with modname, the modifier used by
markers in the file.
Multiple modifiers may be given, as long as each one is preceded by its
own -x or -i option.
The transformation for each marker is determined by its location and
orientation. A marker should be a right triangle pointing like a halfarrow in the direction of the transformed x-axis, x'. The longest side
is the hypoteneuse, the second longest side is the x'-axis, and the
third longest side indicates the direction of the y'-axis. Any additional sides will be ignored (ie. a quadrilateral may be used instead
of a triangle if the extra side is small). The z'-axis is determined
by the cross product of the x' and y' axes, and the origin is the common vertex between x' and y'.
The size of the marker is ignored unless the -s option is used, where
scale is a multiplier for the x'-axis length to indicate the total
scale factor. For example, a scale value of 5 with a marker length of
.5 would result in a total scale factor of 2.5 to be used in the transformation.
The -e option causes commands in the file to be expanded, and is
required to replace markers from commands in the input file. Even with
this option, replmarks will not examine objects for markers. Specifically, an object included by replmarks as a result of a -x expansion
will be transferred verbatim, without regard to any surfaces therein
that might have been considered as marks if they were on the main
input.
The -m option causes all replaced objects to be given the modifier newmod. Otherwise, the new object surfaces will use their originally
defined modifiers. A different replacement modifier may be given for
each marker type. The marker modifier name itself is only used to
identify markers, and will not appear in the output in any form.
If no input file is given, the standard input is read.
EXAMPLE
- To replace all polygons with the modifier ``knobs'' in the file input
with a transformed ``knob.rad'' and write the result to output:
- replmarks -x knob.rad knobs input > output
- To use instances of ``tree.oct'' with scaling set to three times the tree marker length:
replmarks -s 3 -i tree.oct tree input > output
AUTHOR
Greg Ward