RTREGIS(1)

NAME
rtregis — register overlay of a UNIX-Plot onto a rendered image.

SYNOPSIS
rtregis plot.log pix.log > regtistration.matrix

DESCRIPTION
rtregis makes it easy and fast to overlay a UNIX-Plot file produced with rthide or rtrange onto its equivalent color shaded image produced with rt or cell-fb.

rtregis produces a script containing a call to plrot with the -m and -S parameters to supply it with a registration matrix and a space command. The registration matrix is produced by rtregis from the RT log files for a UNIX-Plot file and a rendered shaded image file. Both the UNIX-Plot image and the rendered shaded image must have been ray-traced from the same orientation. The output from rtregis is a matrix and a space command that are to be used as input parameters to plrot. They may not be used together with -a, -e, -s, -g options to plrot. Output is written to standard out unless it is redirected. The output can often be included directly in a shell script using grave accents.

EXAMPLE
This section shows the ordinary usage of rtregis. For example,
	rtregis plot.log pix.log  > registration.matrix.file
results in a file containing the registration matrix and alternate space command for plrot. It also contains a call to plrot and can be edited to send the plrot output a file.
	 sh registration.matrix.file > file.pl
This results in a registered plot file.

Now the registered plot file can be overlaid onto the rendered shaded image:
	pix-fb file.pix
	pl-fb -o file.pl
This command pair results in the plot file being overlaid on top of the rendered shaded image that was in the framebuffer. The result can then be converted to Impress or PostScript and sent to a printer:
	fb-pix | pix-bw | bw-impress (or bw-ps) | qpr

SEE ALSO
bw-impress(1), bw-ps(1), cell-fb(1), mged(1), pl-fb(1), plrot(1), pl-sgi(1), rt(1), rthide(1), pix-bw(1), pix-fb(1), librt(3), libplot3(3), plot3(5), ray(5V).

DIAGNOSTICS
Descriptive messages are printed on standard error (file descriptor 2).

AUTHORS
Susanne Muuss, J.D.

COPYRIGHT
This software is Copyright (c) 1991-2010 United States Government as represented by the U.S. Army Research Laboratory. All rights reserved.

BUG REPORTS
Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>.