'\" t
.\"     Title: B
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 08/28/2023
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "B" "nged" "08/28/2023" "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"
B \- Clears the \fImged\fR display of any currently displayed objects, then displays the list of objects provided in the parameter list\&.
.SH "SYNOPSIS"
.HP \w'\fBB\fR\ 'u
\fBB\fR [[\-A\ \-o] | \fIattribute\ name\fR\ {\fIvalue\fR}...] [\-s] [\-C#/#/#] [\-R] [\fIobjects\fR]
.SH "DESCRIPTION"
.PP
Clears the mged display of any currently displayed objects, then displays the list of objects provided in the parameter list\&. Equivalent to the
\fBZ\fR
command followed by the command
\fBdraw\fR
\fI<objects>\fR\&. 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\&. The
\fI\-A \fRand
\fI\-o\fR
options allow the user to select objects by attribute\&. The
\fI\-s\fR
option specifies that subtracted and intersected objects should be drawn with solid lines rather than dot\-dash lines\&. The \-R option means do not automatically resize the view if no other objects are displayed\&. See the
\fBdraw\fR
command for a detailed description of the options\&.
.SH "EXAMPLES"
.PP
The following are run from the MGED command prompt\&.
.PP
\fBExample\ \&1.\ \&Display a named object\fR
.PP
mged> \fBB some_object\fR
.RS 4
The display clears, and the object named
\fIsome_object\fR
is displayed\&.
.RE
.PP
\fBExample\ \&2.\ \&Draw objects having an attribute with a value\fR
.PP

mged>\fBB \-A \-o Comment {First comment} Comment {Second comment}\fR
.PP
The display clears, then draws objects that have a "Comment" attribute with a value of either "First comment" or "Second comment\&."
.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
