RTREGIS
1
BRL-CAD
BRL-CAD

# rtregis

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

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