Name
rtpp — raytrace an mged model, writing a GIFT-style Pretty Picture file
DESCRIPTION
rtpp
operates on the indicated
objects
in the input
model.g
and produces a GIFT-style "pretty picture" format file
on standard output.
The orientation of the rays to be fired may be specified by
the
-a
and
-e
options, in which case the model will be autosized, and the grid
will be centered on the centroid of the model, with ray spacing
chosen to span the entire set of
objects.
Alternatively,
with the
-M
option, a transformation matrix may be provided on standard input
which maps model-space to view-space.
In this case, the grid ranges from -1.0 <= X,Y <= +1.0 in view space,
with the size of the grid (number of pixels) specified with
-f
This option is most useful when
rtpp
is being invoked from a shell script created by an
mged(1)
saveview command.
The following options are recognized.
-f#
Number of pixels in X and Y directions (square grid). Default is 512 (512x512), maximum is 1024 (1024x1024).
-a#
Select azimuth in degrees. Used with
-e
and conflicts With-M
-e#
Select elevation in degrees. Used with
-a
and conflicts with-M
-M
Read model2view matrix from standard input. Conflicts with
-a
and-e
-x#
Set debug flags to (hexadecimal) number. Not generally useful.
The rtpp program is a simple front-end to librt(3) which is most useful when used with mged(1). In order to display a pretty-picture file, the programs pp-ik(1) and pp-fb(1) are used.
SEE ALSO
gift(1V), mged(1), pp-ik(1), pp-fb(1), rt(1), rayplot(1), rayvect(1), rtpp(1), rtray(1), librt(3), ray(5V)
DIAGNOSTICS
Numerous error conditions are possible. Descriptive messages are printed on standard error (file descriptor 2).
BUGS
Most deficiencies observed while using the rtpp program are usually with the librt(3) package instead.