rtregis — register overlay of a UNIX-Plot onto a rendered image.
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.
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
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).