rtpp — raytrace an mged model, writing a GIFT-style Pretty Picture file


rtpp [options...] model.g objects... > model.pp


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.


Number of pixels in X and Y directions (square grid). Default is 512 (512x512), maximum is 1024 (1024x1024).


Select azimuth in degrees. Used with -e and conflicts With -M


Select elevation in degrees. Used with -a and conflicts with -M


Read model2view matrix from standard input. Conflicts with -a and -e


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.


gift(1V), mged(1), pp-ik(1), pp-fb(1), rt(1), rayplot(1), rayvect(1), rtpp(1), rtray(1), librt(3), ray(5V)


Numerous error conditions are possible. Descriptive messages are printed on standard error (file descriptor 2).


Most deficiencies observed while using the rtpp program are usually with the librt(3) package instead.




This software is Copyright (c) 1986-2016 by the United States Government as represented by U.S. Army Research Laboratory.


Reports of bugs or problems should be submitted via electronic mail to <>.