'\" t
.\"     Title: RT
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 04/13/2022
.\"    Manual: BRL-CAD MGED Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "RT" "nged" "04/13/2022" "BRL\-CAD" "BRL\-CAD MGED Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
rt \- Executes the BRL\-CAD \fIrt\fR program with the default options of "\-s50 M\&."
.SH "SYNOPSIS"
.HP \w'\fBrt\fR\ 'u
\fBrt\fR [\fIoptions\fR] [\fI\-\-objects\fR]
.SH "DESCRIPTION"
.PP
Executes the BRL\-CAD
\fIrt\fR
program with the default options of "\-s50 M\&." If perspective is turned on, then the
\fI\-p\fR
option will be included with the value of the perspective angle\&. The current database name is added to the end of the
\fBrt\fR
command line along with either the specified
\fI objects\fR
or, if none is specified, the list of currently displayed objects\&. The
\fIrt\fR
program is written such that options may be repeated, and the last occurrence of an option will override any earlier occurrences\&. This allows the user to specify other
\fIsize (\-s)\fR
options\&. The
\fBrrt\fR
command performs a similar function, but may be used to execute other programs as well\&. The
\fI\-M\fR
option tells
\fIrt\fR
to read the viewing parameters from standard input\&. See the
\fIman\fR
page on
\fIrt\fR
for details\&. A related command is
\fBsaveview\fR, which can be used to create a shell script (batch job) to raytrace this view in the background\&.
.SH "EXAMPLES"
.PP
The first example shows the use of the
\fBrt\fR
command to run the rt program to produce a color\-shaded image of the current view\&. The second example shows the use of the
\fBrt\fR
command to produce a color\-shaded image of an object using MGED\*(Aqs current viewing parameters\&.
.PP
\fBExample\ \&1.\ \&Run the \fIrt\fR program to produce a color-shaded image of the current view in MGED.\fR
.PP

mged>\fBrt \-s1024 \-F/dev/Xl\fR
.PP
Runs the
\fIrt\fR
program to produce a color\-shaded image of the current view in the MGED display\&. The image will be 1024 pixels square and will be displayed on a lingering
\fIX\fR
framebuffer\&.
.PP
\fBExample\ \&2.\ \&Run the \fIrt\fR program to produce a color-shaded image of an object using MGED's current viewing parameters.\fR
.PP

mged>\fBrt \-C 200/200/255 \-\- roof\fR
.PP
Runs the
\fIrt\fR
program to produce a color\-shaded image of the object
\fIroof\fR
using MGED\*(Aqs current viewing parameters\&. The image will have a sky\-blue background and will be displayed on the framebuffer specified by the FB_FILE shell variable\&.
.SH "AUTHOR"
.PP
BRL\-CAD Team
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
