xenial (1) rhcopy.1.gz

Provided by: radiance_4R1+20120125-1.1_amd64 bug

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)