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 half-arrow 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
SEE ALSO¶
arch2rad(1),
ies2rad(1),
xform(1)
