REPLMARKS(1)                                                      REPLMARKS(1)



NNAAMMEE
       replmarks - replace triangular markers in a RADIANCE scene description

SSYYNNOOPPSSIISS
       rreeppllmmaarrkkss [ --ee ][ --mm nneewwmmoodd ][ --ss ssccaallee ] { --xx oobbjjffiillee | --ii ooccttrreeee | --II
       mmeesshh } mmooddnnaammee ....  [ ffiillee ....  ]

DDEESSCCRRIIPPTTIIOONN
       _R_e_p_l_m_a_r_k_s replaces triangular markers identified by the  modifier  _m_o_d_-
       _n_a_m_e  in each scene description _f_i_l_e and writes the result to the stan-
       dard output.  The _-_x  option  indicates  that  each  marker  should  be
       replaced  by an appropriate _x_f_o_r_m_(_1_) command on _o_b_j_f_i_l_e_.  The _-_i option
       indicates that each marker should be replaced by an instance of _o_c_t_r_e_e_.
       The  _-_I  option  indicates  that  each  marker should be replaced by an
       instance of the Radiance mesh _m_e_s_h_.  One of these  three  options  must
       appear  on  the  command line, along with _m_o_d_n_a_m_e_, 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 addi-
       tional 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  com-
       mon vertex between x' and y'.

       The  size  of the marker is ignored unless the _-_s option is used, where
       _s_c_a_l_e is a multiplier for the x'-axis  length  to  indicate  the  total
       scale  factor.  For example, a _s_c_a_l_e value of 5 with a marker length of
       .5 would result in a total scale factor of 2.5 to be used in the trans-
       formation.

       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, _r_e_p_l_m_a_r_k_s will not examine objects for markers.  Specifi-
       cally, an object included by _r_e_p_l_m_a_r_k_s 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 _n_e_w_-
       _m_o_d_.  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 _f_i_l_e is given, the standard input is read.

EEXXAAMMPPLLEE
       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

AAUUTTHHOORR
       Greg Ward

SSEEEE AALLSSOO
       arch2rad(1), ies2rad(1), xform(1)



RADIANCE                            3/24/94                       REPLMARKS(1)
