GR(nged)

🌸 NAME 🌸

Okay bestie, this is the GR(nged) page from BRL-CAD User Commands — manual name folded in near the top, no copy-pasted header line, we’re classy like that. 💅

gr — add or remove primitives or primitive parents from a group using a GUI selection box. dg exits grouper mode. Periodt.

✨ SYNOPSIS ✨

gr {GroupName} {+ | -} [ListLimit] [-p]

🦋 DESCRIPTION 🦋

Okay so gr lets you add primitives or primitive parents to a group — or remove them — by selecting them on the MGED display using a selection box. Very “drag a box, collect objects,” highkey iconic.

Objects are identified by the location of their vertices on the display. For example, a portion of an 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. Direction matters, bestie — vibe check your drag. 🌈

To start grouper, use gr or grouper. 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 — like when your group chat takes a sec to load. 😭

To exit grouper mode, hold down the ctrl key and single-click the center mouse button. You can also exit grouper mode with the dg or done_grouper 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. Yellow = “in the group” energy, apparently. 💛

Caveats: This command will not function as expected if a selected object has matrices applied. The xpush command can resolve this limitation. 🚨

👑 OPTIONS 👑

• GroupName — the name of the group to add/remove primitives or primitive parents.
• + - — indicates if to add or remove from group.
• ListLimit — 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 ListLimit 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.
• -p — places the parent of the selected primitives in the group instead of the primitives. With the -p option, if the primitive does not have a parent (i.e. is in the root) it will be ignored.

🎀 EXAMPLES 🎀

💖 Example 1. Add selected primitive parents to a group.

mged> gr hull_parts.c + 25 -p

Starts grouper mode, lists up to 25 selected entries, and adds the selected primitives' parent combinations to hull_parts.c.

💖 Example 2. Remove selected primitives from a group.

mged> gr hull_parts.c - 10

Starts grouper mode for removing selected primitives from hull_parts.c, listing up to 10 selected entries.

✨ AUTHOR ✨

BRL-CAD Team — yes, the whole team. 🫶

📬 BUG REPORTS 📬

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. No cap, that’s the address. 💌

---

💖 That’s the GR(nged) page, bestie — source/version: BRL-CAD; manual: GR(nged); date: not listed in the footer, and I’m not out here inventing one. Byeee 🫶✨