REPLMARKS(1)						      General Commands Manual						      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 stan-
       dard 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)

RADIANCE							      3/24/94							      REPLMARKS(1)