NAME

       rhcopy - copy ray information into a holodeck

SYNOPSIS

       rhcopy dest_holo [ -u ][ -d ] -h src_holo ..
       or
       rhcopy dest_holo [ -u ][ -d ] -p src_pic src_zbf ..

DESCRIPTION

       Rhcopy  adds  ray  sample data to the existing holodeck dest_holo.  In the first form, the
       ray samples are taken from one or more holodeck files given after the -h option.   In  the
       second  form,  the ray samples are taken from one or more RADIANCE picture files and their
       depth buffers, which must be paired on the command line after the -p option.

       The -u option turns on duplicate ray checking.  In some cases, the same  ray  may  already
       exist  in  the  destination  holodeck,  and  it would be redundant to add it.  By default,
       rhcopy does not check for duplicates, because it takes extra time, and in many invocations
       is not necessary, as when copying into an empty holodeck.

       The -d option turns off depth checking.  Normally, rhcopy checks the OBSTRUCTIONS variable
       of the destination holodeck, and if it is set to True, makes sure  that  all  contributing
       rays  start outside each section.  If OBSTRUCTIONS is set to False, then rhcopy makes sure
       that any contributing rays end outside each section.  If OBSTRUCTIONS  is  not  set,  then
       this  option  has  no  effect.   (See  the  rholo(1)  man  page  for  a  definition of the
       OBSTRUCTIONS variable.)

       Rcopy cannot be used to create a holodeck -- use rholo for this purpose.  For example,  to
       create  an  empty  holodeck,  run  rholo  without  either  the  -n or -o option.  Whatever
       variables are set by rholo when the new holodeck is created are the ones  that  will  have
       effect  when  later rendering or viewing.  Since the ray sample data may be taken from any
       source, rholo and rhcopy may be used  together  to  change  certain  unalterable  holodeck
       parameters, such as the section grid geometry.

EXAMPLE

       To take data from an existing holodeck after changing the section grid:

         rholo new.hdk new.hif
         rhcopy new.hdk -h old.hdk

       To add ray samples from two pictures to the new holodeck:

         rhcopy new.hdk -p view1.hdr view1.zbf view2.hdr view2.zbf

NOTES

       Rhcopy  attempts  to place the beams in the holodeck in a good order for quick access, but
       if the data comes from multiple sources, the  results  may  not  be  optimal.   For  large
       holodecks, it is sometimes useful to run the rhoptimize(1) program once all runs of rhcopy
       are through.

AUTHOR

       Greg Ward Larson

ACKNOWLEDGMENT

       This work was supported by Silicon Graphics, Inc.

SEE ALSO

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