ARB(nged)

Okay bestie, welcome to ARB(nged) from the BRL-CAD User Commands set — manual name right there, vibe fully immaculate. We're doing ARB shape operations today, and yes it's giving CAD but make it cute. 💅✨

✨ NAME ✨

arb — does operations on ARB shapes, such as creation and repair. 🛠️🦋

🌈 SYNOPSIS 🌈

Two usage lines, bestie — one for create, one for repair:

arb create {arb_name} {rotation} {fallback}

arb repair [-h] [-t tol] [-o output_name] {arb_name} [arb_name...]

💖 DESCRIPTION 💖

arb does operations on ARB shapes, and which operation happens depends on the subcommand you pick. Simple as that. ✨

🎀 create 🎀

Creates a new ARB shape with the specified arb_name. The new ARB is 20 inches by 20 inches and 2 inches thick. Its square faces are perpendicular to the direction defined by the rotation and fallback angles. You can figure out that direction by reading the rotation angle as an azimuth and the fallback angle as an elevation, just like in the ae command. 🧚

Legacy alert 🚨: the old syntax arb arb_name rotation fallback is deprecated and will be removed in a future release.

🛠️ repair 🛠️

repair tries to repair and canonicalize an existing ARB primitive. If you pass -o output_name, the repaired ARB is saved as a new object; if not, the repair happens in-place. You can supply a distance tolerance for snapping vertices with -t tol; if it's omitted, the default BRL-CAD editing tolerance is used. 💅

• -h — this flag shows up in the synopsis as arb repair [-h] ..., but this manual doesn't describe it separately, so I'm not inventing a whole personality for it. 🙈
• -t tol — distance tolerance for snapping vertices. Omit it and the default BRL-CAD editing tolerance is used. 🎯
• -o output_name — save the repaired ARB as a new object named output_name; without it, the repair happens in-place. 🫶

🧪 EXAMPLES 🧪

The first example shows the arb command creating a new ARB shape with a specified name. The second example shows the ae command determining the view orientation of the arb. The third example demonstrates repairing a degenerate ARB. And yep, there's a fourth example too, for a tight tolerance. 💖

🌸 Example 1. Create new_arb with a specific rotation angle and fallback angle.

mged>arb create new_arb 35 25

Creates new_arb with a rotation angle of 35° and a fallback angle of 25°. Slay. ✨

🦋 Example 2. Using the ae command to determine the view orientation of the arb

mged>ae 35 25

Rotates the view to look straight on at the square face of new_arb. 👀

🎀 Example 3. Repair an existing ARB and save it to a new object

mged>arb repair -o fixed_arb broken_arb

Attempts to canonicalize and repair broken_arb, and saves the result to fixed_arb. 💅

🔥 Example 4. Repair an ARB using a tight tolerance

mged>arb repair -t 1e-7 broken_arb

Attempts to canonicalize and repair broken_arb in-place, using a tight 1e-7 tolerance to strictly enforce planar faces — matching the default tolerance of the lint command. 🎯

👑 AUTHOR 👑

BRL-CAD Team — iconic. 💜

🐛 BUG REPORTS 🐛

Got bugs or problems? Report them via electronic mail to devs@brlcad.org. Don't be shy, bestie. 📬

---

Cute little footer sign-off: source/version is BRL-CAD, manual name is ARB(nged), and this page doesn't show a date, so I'm not making one up. Byeee, go make some repaired ARBs 💖✨