DB(nged)

💅 DB(nged) — the database-manipulation interface, bestie edition

okay so this is from the BRL-CAD MGED Commands manual set, and it's genuinely one of my fave utility commands because it just... does everything?? like it's the main character of database manipulation fr fr 🫶

---

✨ NAME ✨

db — provides an interface to a number of database manipulation routines.

---

🌸 SYNOPSIS 🌸

db {command} [arguments]

---

🦋 DESCRIPTION 🦋

So db gives you an interface to a whole bunch of database manipulation routines. Lowkey iconic.

⚠️ heads up bestie: this command always operates in units of millimeters. no cap. every single time.

The {command} you pass has to be one of the following, each with its own appropriate arguments:

• match [regular_exp] — returns a list of all the objects in that database that match the list of regular expressions. it's giving search bar energy 🔍.
• get shape_or_path [attribute] — returns info about the primitive shape sitting at the end of the shape_or_path. if you hand it a path, the transformation matrices you run into along that path get accumulated and then applied to the leaf shape before it shows you the information. if you don't specify an attribute, you get all the details about the shape. if you do list a specific attribute, then only that info comes back. choose your fighter 💅.
• put shape_name shape_type attributes — creates a shape named shape_name of type shape_type, with attributes exactly as listed in attributes. the arguments to put are the same ones that get gives you back — they're matching besties 🫶.
• adjust shape_name attribute new_value1 [new_value2 new_value3...] — modifies the shape named shape_name by adjusting the value of its attribute to the new_values.
• form object_type — displays the format used to display objects of type object_type.
• tops — returns all top-level objects. the popular kids 👑.
• close — closes the previously opened database and deletes the associated command. it's giving goodbye, it's giving closure, it's giving self-care 😭.

---

🎀 EXAMPLES 🎀

These examples show off using the db command to list various objects and attributes from the database, plus creating new TGC shapes, adjusting a vertex attribute, and displaying command formats. let's gooo 🔥

Example 1. List all objects in the database that end with .s

mged> db match *.s

Gets a list of all objects in the database that end with .s. no thoughts, just shapes ✨

Example 2. List all attributes and their values for cone.s

mged>db get cone.s

Gets a list of all the attributes and their values for shape cone.s. the full lore drop 📖

Example 3. Get the value of the vertex attribute of cone.s

mged>db get cone.s V

Gets the value of the V (vertex) attribute of shape cone.s. just the one detail, very minimal, very demure 💅

Example 4. Create a new TGC shape named new_cone.s with specified attributes.

mged>db put new_cone.s tgc V {0 0 0} H {0 0 1} A {1 0 0} B {0 1 0} C {5 0 0} D {0 5 0}

Creates a new TGC shape named new_cone.s with the specified attributes. look at her go, a star is born ⭐

Example 5. Adjust the vertex attribute of new_cone.s to a given value.

mged>db adjust new_cone.s V {0 0 10}

Adjusts the V (vertex) attribute of new_cone.s to the value {0 0 10}. glow-up arc complete 🌈

Example 6. Display the format used by the get and put commands for the TGC shape type.

mged>db form tgc

Displays the format used by the get and put commands for the TGC shape type. iykyk 🧚

---

💜 AUTHOR 💜

BRL-CAD Team — they ate and left no crumbs.

---

🍓 BUG REPORTS 🍓

got a bug? a problem? a little situation? 🙈 reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. they want to hear from you, bestie, fr fr.

---

and that's the whole page! brought to you by BRL-CAD and the DB(nged) manual page — big slay, no date on this one, we're living in the moment ✨💖🎀