'\" t
.\"     Title: TOL
.\"    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 "TOL" "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"
tol \- Used with no arguments, \fBtol\fR lists the current tolerance settings\&.
.SH "SYNOPSIS"
.HP \w'\fBtol\fR\ 'u
\fBtol\fR [abs\fI#\fR] [rel\fI#\fR] [norm\fI#\fR] [dist\fI#\fR] [perp\fI#\fR] []
.SH "DESCRIPTION"
.PP
The
\fBtol\fR
command, with no arguments, lists the current tolerance settings\&. If the command line includes any of the keywords followed by a number, then that tolerance setting will be modified\&. The keywords are as follows:
.PP
\fBTessellation tolerances:\fR
The tessellation tolerances are used to control the facetization of primitive shapes\&. If more than one tolerance value is specified, the tessellation is performed to meet the most stringent\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
abs \-\- This
\fIabsolute\fR
tolerance is specified in model units and represents the maximum allowable error in the distance from the actual shape surface to the tessellated surface\&. An
\fIabsolute\fR
tolerance of 0 means that the
\fIabsolute\fR
tolerance should be ignored\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
rel \-\- This
\fIrelative\fR
tolerance is specified in terms of a fraction of the shape size\&. The value is multiplied by the size of the shape to determine another bound on the maximum allowable error in the distance from the actual shape surface to the tessellated surface\&. A
\fIrelative\fR
tolerance of 0 means that the
\fIrelative\fR
tolerance should be ignored\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
norm \-\- This
\fInormal\fR
tolerance is specified in degrees and represents the maximum angle between the actual shape surface normal and the tessellated surface normal\&. A
\fInormal\fR
tolerance of 0 means that the
\fInormal\fR
tolerance should be ignored\&.
.RE
.PP
\fBCalculational tolerances:\fR
The calculational tolerances are used in evaluating the Boolean operations specified in a combination\&. This is used, for example, in the
\fBev, facetize,\fR
and
\fBbev\fR
commands\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
dist \-\- The
\fIdistance\fR
tolerance is specified in model units and represents the minimum distance required between two vertices to consider them distinct\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
perp \-\- The
\fIperpendicularity\fR
tolerance is specified as the cosine of an angle\&. Two objects will be considered perpendicular if the cosine of the angle between them is less than the
\fIperpendicularity\fR
tolerance\&. Similarly, two objects will be considered parallel if the cosine of the angle between them is greater than 1\&.0, the
\fIperpendicularity\fR
tolerance\&.
.RE
.SH "EXAMPLES"
.PP
The example shows the use of the
\fBtol\fR
command to set the relative and perpendicularity tolerances\&.
.PP
\fBExample\ \&1.\ \&Set the relative and perpendicularity tolerances.\fR
.PP

mged>\fBtol rel \&.05 perp 1e\-6\fR
.PP
Sets the
\fIrelative\fR
tolerance to 5% and the
\fIperpendicularity\fR
tolerance to 1e\-06 (cosine of 89\&.9999\(de)\&.
.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
