'\" t
.\"     Title: DRAW
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 04/13/2022
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "DRAW" "nged" "04/13/2022" "BRL\-CAD" "BRL\-CAD User 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"
draw \- Adds \fIobjects\fR> to the display list so that they will appear on the \fIMGED\fR display\&. The \fBe\fR command is a synonym for \fBdraw\fR\&.
.SH "SYNOPSIS"
.HP \w'\fBdraw\fR\ 'u
\fBdraw\fR [\-A\ \fIattribute\ name/value\ pairs\fR] [\-s] [\-A\ \-o\fIattribute\ name/value\ pairs\fR] [\-C#/#/#] [\-L\ #] [\-R] [\-S] [\fI\-m1\fR] {\fIobjects\fR}
.SH "DESCRIPTION"
.PP
Adds
\fIobjects\fR
to the display list so that they will appear on the MGED display\&. The
\fBe\fR
command is a synonym for draw\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
\fI\-C\fR
option provides the user a way to specify a color that overrides all other color specifications including combination colors and region\-id\-based colors\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
\fI\-s\fR
option specifies that subtracted and intersected objects should be drawn with shape lines rather than dot\-dash lines\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
\fI\-A\fR
option specifies that the arguments provided to this command are attribute name/value pairs, and only objects having the specified attributes and values are to be displayed\&. The default (without
\fI\-o\fR) is that only objects having all the specified attribute name/value pairs will be displayed\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
\fI\-m1\fR
option will display BOTs shaded if the display manager is OpenGL and the zbuffer and lighting is enabled\&. To enable these settings, from the MGED GUI, choose "Modes/Display Manager/OpenGL", "Misc/Z\-buffer" and "Misc/Lighting"\&. If the zbuffer and lighting is already enabled, toggle them off then back on to ensure they are enabled\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
\fI\-L\fR
option allows the user to specify a face count\&. BoT primitives with more faces than the user set threshold will be represented in wireframe drawing by their bounding boxes rather than the full BoT wireframe\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
\fI\-R\fR
option tells draw to not change the view size when drawing new objects\&. Without this flag,
\fBdraw\fR
will automatically size the view to make the new object(s) visible when the view was previously empty\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
\fI\-S\fR
option tells draw to be "simplified" by skipping subtraction objects when drawing, not drawing NMG interior surfaces, and potentially more\&. Skipping subtractions is useful in situations where an object has many large objects subtracted from it but those objects have relatively minimal impact on the shape\&. This results in the default wireframe bearing little resemablance to the evaluated shape\&.
.RE
.SH "EXAMPLES"
.PP
The following examples show the use of the
\fBdraw\fR
command to draw particular objects, to specify color, to draw with shape lines rather than dot\-dash lines, and to limit the objects to be drawn to those having specific attribute names and value pairs\&.
.PP
\fBExample\ \&1.\ \&Draw specific objects in the \fIMGED\fR display.\fR
.PP
mged> \fBdraw object1 object2\fR
.RS 4
\fIObject1\fR
and
\fIobject2\fR
are drawn in the
\fIMGED\fR
display\&.
.RE
.PP
\fBExample\ \&2.\ \&Specify the color used to draw the object.\fR
.PP

mged>\fBdraw \-C 255/255/255 object2\fR
.PP
Object2 is drawn in white\&.
.PP
\fBExample\ \&3.\ \&Limit the objects to be drawn to those having specific attribute names and value pairs.\fR
.PP

mged>\fBdraw \-A \-o Comment {First comment} Comment {Second comment}\fR
.PP
Objects having a Comment attribute with a value of either "First comment" or "Second comment" are drawn\&.
.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
