RHCOPY(1)						      General Commands Manual							 RHCOPY(1)

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  neces-
       sary, 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  cer-
       tain 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)

RADIANCE
							      1/15/99								 RHCOPY(1)