'\" t
.\"     Title: GR/DG
.\"    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 "GR/DG" "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"
gr, dg \- Add or remove primitives or primitive parents from a group using a GUI selection box\&. dg exits grouper mode\&.
.SH "SYNOPSIS"
.HP \w'\fBgr\fR\ 'u
\fBgr\fR {\fIGroupName\fR} {\fI+\fR | \fI\-\fR} [\fIListLimit\fR] [\fI\-p\fR]
.SH "DESCRIPTION"
.PP
Allows primitives or primitive parents to be added or removed from a group by selecting them on the MGED display using a selection box\&. Objects are identified by the location of their vertices on the display\&. For example, a portion of a object may be within the selection box but if none of its vertices are then it is not considered within the section box\&. Because of this, objects can only be selected if they are displayed in wireframe\&. Drawing a selection box (left to right), objects completely in the box are selected\&. Drawing the selection box (right to left), objects completely and partly in the box are selected\&. To start grouper use the command \*(Aqgr\*(Aq or \*(Aqgrouper\*(Aq\&. Press and hold the center mouse button then drag the mouse to create the selection box\&. If there are a large number of vertices on the display, there will be a delay before the selected objects are highlighted and control of MGED is returned to the user\&. To exit grouper mode, hold down the \*(Aqctrl\*(Aq key and single\-click the center mouse button\&. You can also exit grouper mode with the \*(Aqdg\*(Aq or \*(Aqdone_grouper\*(Aq commands\&. Objects in the group, while in grouper mode, will be displayed (i\&.e\&. highlighted) in yellow wireframe\&. When entering grouper mode, if the chosen group already contains objects, these existing objects will be immediately displayed in yellow wireframe\&. As objects are added to the group, they will also be highlighted in yellow\&. When you exit grouper mode, the yellow highlights will be removed\&.
.PP
Caveats: This command will not function as expected if a selected object has matrices applied\&. The xpush command can resolve this limitation\&.
.SH "OPTIONS"
.PP
\fBGroupName\fR
.RS 4
The name of the group to add/remove primitives or primitive parents\&.
.RE
.PP
\fB+\fR, \fB\-\fR
.RS 4
Indicates if to add or remove from group\&.
.RE
.PP
\fBListLimit\fR
.RS 4
As primitives/parents are selected using a selection box, the names of the selected objects can be listed\&. This option controls the number of entries which will be listed\&. By default this value is zero\&. All selected objects will be listed, assuming the \*(AqListLimit\*(Aq is high enough, even if they are not added to the group\&. This will happen if some of the selected objects are already in the group\&.
.RE
.PP
\fB\-p\fR
.RS 4
Places the parent of the selected primitives in the group instead of the primitives\&. With the \*(Aq\-p\*(Aq option, if the primitive does not have a parent (i\&.e\&. is in the root) it will be ignored\&.
.RE
.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
