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 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 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 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
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).