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)