xenial (1) replmarks.1.gz

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)