LIST(nged)

list the attributes and parameters of database objects

πŸ“… published 7.44.0, from nixpkgs unstable

πŸ’… LIST(nged) β€” the list / l page, bestie edition

okay so this is straight out of the BRL-CAD User Commands manual, page LIST(nged), and it's genuinely one of the most useful little commands ever. sit down, we're learning πŸ’–

✨ NAME ✨

list, l β€” list the attributes and parameters of database objects πŸŽ€

✨ SYNOPSIS ✨

list [-r] [-t] [-v] object(s)
l [-r] [-t] [-v] object(s)

✨ DESCRIPTION ✨

The list command β€” which also answers to the much shorter, much cuter name l β€” reports the attributes and parameters of one or more database objects. πŸ’«

For primitive shapes, the geometric parameters get displayed in the current working units. For combinations, you get the whole Boolean tree of members shown to you. it's giving "here's the family tree, bestie" 🌳

And here's the part that's lowkey iconic: if you give it a path (like, anything containing /), the parameters of the primitive at the end of that path are displayed with the accumulated transformation matrices along the path applied β€” which is literally equivalent to the output of listeval. no cap. πŸ‘‘

πŸ¦‹ Options πŸ¦‹

  • -r β€” Recursively evaluate paths. Each named object gets resolved through the hierarchy, and the parameters of the primitives at the leaves are displayed with all transformations applied. Equivalent to calling listeval for each object. so it's listeval-core, fr fr ✨
  • -t β€” Terse mode. Suppresses verbose parameter output. When you combine it with -r, you get a compact listing of evaluated paths without parameter detail. short and sweet, we love a minimal queen πŸ’…
  • -v β€” Extra verbose mode. Increases the detail of the output, and yes, it may be specified multiple times (go off, stack it). πŸ”₯

🌸 EXAMPLES 🌸

πŸ’– Example 1. List the parameters of a primitive

mged> l sph.s

Displays the sphere's center, radius, and other geometric parameters in the current working units. the glow-up is real ⭐

πŸ’– Example 2. List the Boolean tree of a combination

mged> list hull.c

Shows the combination tree for hull.c, listing all members and their Boolean operators. iykyk 🌈

πŸ’– Example 3. List evaluated parameters via a path

mged> l vehicle.c/hull.r/hull.s

Displays the parameters of hull.s with the cumulative transformation matrices from vehicle.c through hull.r applied. path traversal ate, honestly 🫢

πŸ’– Example 4. List recursively with all transformations

mged> l -r assembly.c

Recursively evaluates all primitives under assembly.c and displays their parameters with all transformations applied. main character energy πŸ‘‘

πŸ’– Example 5. Terse recursive listing

mged> list -r -t vehicle.c

Lists all evaluated paths under vehicle.c in compact form without detailed parameter output. chef's kiss, no notes 😭


πŸ‘€ SEE ALSO πŸ‘€

  • listeval(nged)
  • ls(nged)
  • db(nged)

πŸ’œ AUTHOR πŸ’œ

BRL-CAD Team

πŸ™ˆ BUG REPORTS πŸ™ˆ

Found a bug or a problem? Reports should be submitted via electronic mail to devs@brlcad.org β€” the team genuinely wants to hear about it, so don't be shy πŸ“

okay but seriously, if something's broken, email them. that's the whole vibe check. πŸ’€

and that's the page, bestie ✨ this was BRL-CAD's LIST(nged) β€” that footer's whole personality β€” catch you in the next mged> prompt, mwah πŸ’…πŸ§šβ€β™€οΈ

πŸ“¦ where this page comes from