RHOPTIMIZE(1)                                                    RHOPTIMIZE(1)



NNAAMMEE
       rhoptimize - optimize beam locations in holodeck file

SSYYNNOOPPSSIISS
       rrhhooppttiimmiizzee [ --uu ] ssrrcc__hhoolloo [ ddeesstt__hhoolloo ]

DDEESSCCRRIIPPTTIIOONN
       _R_h_o_p_t_i_m_i_z_e  optimizes  beam  positions and eliminates fragment waste in
       the holodeck file _s_r_c___h_o_l_o_, writing the result to  _d_e_s_t___h_o_l_o_,  or  back
       into  _s_r_c___h_o_l_o if only one argument is given.  This may improve render-
       ing speed on large holodecks, which tend to have widely dispersed  beam
       positions that cause delays due to long file seeks.  It may also reduce
       the size of the file, since large holodecks become fragmented  as  they
       fill  up with new ray samples.  (Use the _r_h_i_n_f_o_(_1_) program to determine
       holodeck file fragmentation.)  The _-_u option adds a check to make  sure
       that  each  ray  sample is unique, i.e., the same sample is never given
       twice.  This check is usually unnecessary, but may eliminate  redundant
       samples from some holodeck files.

EEXXAAMMPPLLEE
       To optimize the beam order in old.hdk and write the results to new.hdk:

         rhoptimize old.hdk new.hdk

       To optimize beam order in scene.hdk:

         rhoptimize scene.hdk

NNOOTTEESS
       If _r_h_o_p_t_i_m_i_z_e is given only one file argument, it creates  a  temporary
       file in the same directory, and moves it onto the original file once it
       has successfully completed its operation.  If the operation  fails  for
       some reason, the temporary file is removed and the original holodeck is
       left unchanged.

       This program generally takes several  minutes  to  run  and  offers  no
       progress reports.

FFIILLEESS
       rho????.hdk    temporary file to hold new holodeck

AAUUTTHHOORR
       Greg Ward Larson

AACCKKNNOOWWLLEEDDGGMMEENNTT
       This work was supported by Silicon Graphics, Inc.

SSEEEE AALLSSOO
       getinfo(1),   pfilt(1),   psign(1),   rhcopy(1),  rhinfo(1),  rholo(1),
       rpict(1)



RADIANCE                            1/25/99                      RHOPTIMIZE(1)
