DRAW(nged)

💖 DRAW(nged) — BRL-CAD User Commands 💖

okay so bestie, welcome to the draw page from the BRL-CAD User Commands manual (nged flavor, obviously) ✨

✨ NAME ✨

draw — adds objects to the display list so they show up on the MGED display. and guess what? e is a synonym for draw, so you can use either one, no cap 💅

✨ SYNOPSIS ✨

draw [-A attribute name/value pairs] [-s] [-A -o attribute name/value pairs] [-C#/#/#] [-L #] [-R] [-S] [-m1] {objects}

✨ DESCRIPTION ✨

so basically draw adds objects to the display list so they appear on your MGED display. and e is a synonym for draw — same energy, different letter, iykyk 🦋

here's the tea on every single flag:

• -C — gives you a way to specify a color that overrides all other color specifications, including combination colors and region-id-based colors. like, it's the main character of color options 💅
• -s — says subtracted and intersected objects should be drawn with shape lines instead of dot-dash lines. shape lines > dot-dash, periodt ✨
• -A — tells draw that the arguments you're passing are attribute name/value pairs. only objects having the specified attributes and values get displayed. the default (when you don't use -o) is that only objects having all the specified attribute name/value pairs will be displayed. with -o, objects that match any of the specified attribute name/value pairs will be displayed. so -A alone = strict AND vibe, -A -o = chill OR vibe, got it? 🫶
• -m1 — will display BOTs shaded if the display manager is OpenGL and the zbuffer and lighting are enabled. to enable these settings, from the MGED GUI, choose Modes/Display Manager/OpenGL, Misc/Z-buffer, and Misc/Lighting. and listen — if the zbuffer and lighting are already enabled, toggle them off then back on to make sure they're actually enabled. yes, it's giving "turn it off and on again," but that's literally what the manpage says 🔥
• -L — lets you specify a face count. BoT primitives with more faces than the threshold you set will be represented in wireframe drawing by their bounding boxes instead of the full BoT wireframe. so it's like, "hey, this BoT is too extra, just show me the box" 😭
• -R — tells draw to not change the view size when drawing new objects. without this flag, draw will automatically size the view to make the new object(s) visible when the view was previously empty. so -R is for when you're like "bestie, leave my camera alone" 🙈
• -S — tells draw to be "simplified" by skipping subtraction objects when drawing, not drawing NMG interior surfaces, and potentially more. skipping subtractions is useful when an object has many large objects subtracted from it but those objects have relatively minimal impact on the shape. the catch? this results in the default wireframe bearing little resemblance to the evaluated shape. so it's a vibe, but it's lowkey not accurate, just so you know 💀

✨ EXAMPLES ✨

these examples show draw in action — drawing specific objects, specifying color, using shape lines instead of dot-dash lines, and limiting objects to those with specific attribute names and value pairs. let's go 🔥

Example 1. Draw specific objects in the MGED display.

mged> draw object1 object2

Object1 and object2 are drawn in the MGED display. slay! 🎀

Example 2. Specify the color used to draw the object.

mged>draw -C 255/255/255 object2

Object2 is drawn in white. clean, crisp, iconic 🤍

Example 3. Limit the objects to be drawn to those having specific attribute names and value pairs.

mged>draw -A -o Comment {First comment} Comment {Second comment}

objects having a Comment attribute with a value of either "First comment" or "Second comment" are drawn. see how -A -o makes it match either one? chef's kiss 👑

✨ AUTHOR ✨

BRL-CAD Team — shoutout to the legends 🫶

✨ BUG REPORTS ✨

if you find a bug or a problem, report it by electronic mail to devs@brlcad.org. don't be shy, they wanna know 💌

---

this page is from the BRL-CAD fam, DRAW(nged) style — catch you in the next manpage, bestie! 🌈💖