home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / video / render / radiance.lzh / ray / doc / cat1 / replmarks.doc < prev    next >
Encoding:
Text File  |  1991-11-24  |  2.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. REPLMARKS(1)             USER COMMANDS               REPLMARKS(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      replmarks - replace triangular markers in a  RADIANCE  scene
  10.      description
  11.  
  12. SYNOPSIS
  13.      replmarks [ -e ][ -m newmod ][ -s scale ] { -x objfile |  -i
  14.      octree } modname [ file .. ]
  15.  
  16. DESCRIPTION
  17.      Replmarks replaces  triangular  markers  identified  by  the
  18.      modifier  modname  in each scene description file and writes
  19.      the result to the standard output.  The -x option  indicates
  20.      that  each  marker  should  be  replaced  by  an appropriate
  21.      xform(1) command on objfile. The -i  option  indicates  that
  22.      each marker should be replaced by an instance of octree. One
  23.      of these two options must appear on the command line,  along
  24.      with modname, the modifier used by markers in the file.
  25.  
  26.      The transformation for each  marker  is  determined  by  its
  27.      location and orientation.  A marker should be a right trian-
  28.      gle pointing like a  half-arrow  in  the  direction  of  the
  29.      transformed  x-axis,  x'.   The  longest  side  is the hypo-
  30.      teneuse, the second longest side is  the  x'-axis,  and  the
  31.      third  longest  side indicates the direction of the y'-axis.
  32.      Any additional sides will be ignored  (ie.  a  quadrilateral
  33.      may  be  used  instead  of  a  triangle if the extra side is
  34.      small).  The z'-axis is determined by the cross  product  of
  35.      the  x'  and  y'  axes,  and the origin is the common vertex
  36.      between x' and y'.
  37.  
  38.      The size of the marker is ignored unless the  -s  option  is
  39.      used,  where scale is a multiplier for the x'-axis length to
  40.      indicate the total scale factor.  For example, a scale value
  41.      of  5  with  a  marker  length of .5 would result in a total
  42.      scale factor of 2.5 to be used in the transformation.
  43.  
  44.      The -e option causes commands in the file  to  be  expanded,
  45.      and it is recommended when replmarks is used as a command in
  46.      a scene file for efficiency.  The -e option is  required  to
  47.      replace  markers  from  commands  in the input file.  The -m
  48.      option causes all surfaces to be given the modifier  newmod.
  49.      If no file is given, the standard input is read.
  50.  
  51. EXAMPLE
  52.      To replace all polygons with the modifier ``knobs''  in  the
  53.      file  input  with  a  transformed ``knob.rad'' and write the
  54.      result to output:
  55.  
  56.        replmarks -x knob.rad knobs input > output
  57.  
  58.      To use instances of ``tree.oct'' with scaling set  to  three
  59.      times the tree marker length:
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. REPLMARKS(1)             USER COMMANDS               REPLMARKS(1)
  71.  
  72.  
  73.  
  74.        replmarks -s 3 -i tree.oct tree input > output
  75.  
  76. AUTHOR
  77.      Greg Ward
  78.  
  79. SEE ALSO
  80.      arch2rad(1), ies2rad(1), xform(1)
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.