'\" t
.\"     Title: RTCHECK
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 08/28/2023
.\"    Manual: BRL-CAD MGED Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "RTCHECK" "nged" "08/28/2023" "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"
rtcheck \- Executes the BRL\-CAD \fIrtcheck\fR program with the default options of "\-s50 M\&."
.SH "SYNOPSIS"
.HP \w'\fBrtcheck\fR\ 'u
\fBrtcheck\fR [\fIoptions\fR]
.SH "DESCRIPTION"
.PP
Executes the BRL\-CAD
\fIrtcheck\fR
program with the default options of "\-s50 M\&." The \-M option tells
\fIrtcheck\fR
to read the viewing parameters from standard input so that rays are only fired from the current view\&. The current database name and the list of currently displayed objects are added to the end of the
\fIrtcheck\fR
command line\&. The
\fIrtcheck\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
\fIrtcheck\fR
program uses raytracing to check for overlapping regions in the list of objects passed on the command line\&. When invoked from within MGED, any discovered overlaps along a ray are represented as yellow lines that extend only in the areas of overlap\&. Details and a count of overlaps are also reported\&. Note that overlaps of less than 0\&.1 mm are currently ignored by
\fIrtcheck\fR\&. The default option of
\fI\-s50\fR
indicates that the checking rays should be fired from a uniform square grid with 50 rays on a side\&. This is very coarse and may miss significant overlaps\&. It is recommended that the user select appropriate options for the
\fIrtcheck\fR
program and execute it for a variety viewing aspects to perform a thorough check\&. The granularity of the grid may be controlled with the
\fI\-s, \-w, \-n, \-g,\fR
and
\fI\-G\fR
options\&. See the
\fIman\fR
page on
\fIrtcheck\fR
for details\&.
.SH "EXAMPLES"
.PP
The example shows the use of the
\fBrtcheck\fR
command to run the
\fI rtcheck\fR
program with rays fired from a uniform grid with the rays spaced every 10 mm\&.
.PP
\fBExample\ \&1.\ \&Run the \fIrtcheck\fR program to fire rays from a uniform grid with the rays spaced a specified distance apart.\fR
.PP

mged>\fBrtcheck \-g10 \-G10\fR
.PP
Runs the
\fIrtcheck\fR
program with rays fired from a uniform grid with the rays spaced every 10 mm\&.
.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
