RHOPTIMIZE(1)						      General Commands Manual						     RHOPTIMIZE(1)

NAME

       rhoptimize - optimize beam locations in holodeck file

SYNOPSIS

       rhoptimize [ -u ] src_holo [ dest_holo ]

DESCRIPTION

       Rhoptimize  optimizes  beam positions and eliminates fragment waste in the holodeck file src_holo, writing the result to dest_holo, or back
       into src_holo if only one argument is given.  This may improve rendering 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 rhinfo(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.

EXAMPLE

       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

NOTES

       If rhoptimize 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.

FILES

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

AUTHOR

       Greg Ward Larson

ACKNOWLEDGMENT

       This work was supported by Silicon Graphics, Inc.

SEE ALSO

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

RADIANCE
							      1/25/99							     RHOPTIMIZE(1)