Name

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

Synopsis

rtregis plot.log pix.log > registration.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 plot3rot 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 plot3rot. They may not be used together with -a, -e, -s, -g options to plot3rot. Output is written to standard output 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 plot3rot. It also contains a call to plot3rot and can be edited to send the plot3rot output a file.



sh registration.matrix.file > file.plot3

This results in a registered plot file.

Now the registered plot file can be overlaid onto the rendered shaded image:



pix-fb file.pix

plot3-fb -o file.plot3

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), plot3-fb(1), plot3rot(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-2016 United States Government as represented by the U.S. Army Research Laboratory.

BUG REPORTS

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