DBOT_DUMP(nged)

💖 NAME — DBOT_DUMP(nged)

dbot_dump — export currently displayed BOT objects to a mesh file format ✨

🦋 SYNOPSIS

dbot_dump [-b] [-n|--normals] [-F|--full-precision]
          [-m|--output-directory dir] [-o|--output-file file]
          [-t dxf|glb|gltf|obj|sat|stl] [-u unit]
          [--no-materials]

🎀 DESCRIPTION

Okay so the dbot_dump command exports the currently displayed BOT (Bag-of-Triangles) objects to an external mesh file. It’s giving “display-list-only” main character energy: unlike bot_dump, which takes explicit object names or operates on all BOTs in the database, dbot_dump operates on the set of objects currently drawn in the MGED display.

It automatically passes —displayed, —viewdata, and —materials to the underlying bot_dump implementation:

• —displayed — restricts export to currently drawn objects.
• —viewdata — writes view-related metadata alongside the geometry output.
• —materials — includes displayed color/material information in the output.

No BOT names are taken as arguments; the set of objects to export is determined by the display list. Periodt.

All other options are identical to bot_dump, including —no-materials (--no-materials in the synopsis) to explicitly suppress color/material export. Ngl, that’s the “no color drama” button.

🌸 Options 🌸

• -b — write output in binary format where supported.
• -n, --normals — write per-vertex normals if the output format supports them.
• -F, --full-precision — write full floating-point precision for coordinate values.
• -m dir, --output-directory dir — write each BOT to a separate file in the specified directory dir. Mutually exclusive with -o.
• -o file, --output-file file — write all output to the single specified file. Mutually exclusive with -m.
• -t fmt — specify the output format type: dxf, glb, gltf, obj, sat, or stl (default: stl).
• -u unit — output coordinate units (e.g., mm, cm, in, ft).
• --no-materials — explicitly suppress color/material export (also spelled —no-materials in the description above, bestie).

🔥 EXAMPLES

💫 Example 1. Export all currently displayed BOTs to STL

mged> draw hull.bot turret.bot mged> dbot_dump -o displayed.stl

Draws two BOTs, then exports them both (with view data and displayed color/material info) to displayed.stl.

💫 Example 2. Export displayed geometry to OBJ format

mged> dbot_dump -t obj -o scene.obj

Exports all currently drawn BOT objects to Wavefront OBJ format, including displayed color/material properties.

🦋 SEE ALSO

bot_dump(nged), who(nged), draw(nged) — go read these next, bestie. Iykyk.

👑 AUTHOR

BRL-CAD Team

🐛 BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org.

---

💖 That’s the whole page. Source/version: BRL-CAD; page: DBOT_DUMP(nged). The footer date slot is giving empty on this one, so I’m not inventing a date — no cap. 🫶