INSTANCE(nged)

add an object instance to a combination with a Boolean operator

📅 published 7.44.0, from nixpkgs unstable

💅 INSTANCE(nged) 💅

okay so bestie, you're in the nged section of the BRL-CAD User Commands manual, and today's main character is the instance command (and its lil alias i). buckle up 🎀

✨ NAME ✨

instance, i — adds an object instance to a combination with a Boolean operator 🦋

🌸 SYNOPSIS 🌸

instance obj comb [op]
i obj comb [op]

💖 DESCRIPTION 💖

The instance command (also available as i, because who has time to type all those letters) adds obj as a member of the combination comb using the Boolean operator op. And here's the tea: no transformation matrix is applied — the object is instanced at the identity position. no cap. 🔥

The optional op argument specifies the Boolean relationship:

  • u — union (this is the default if op is omitted, so you literally don't have to say anything 💅)
  • - — subtraction
  • + — intersection

The combination comb must already exist, bestie. that's the vibe check. if you wanna create a new combination at the same time, use group, comb, or region instead. 🫶

⭐ EXAMPLES ⭐

Example 1. Add an object to a combination as a union member

mged> instance wheel.r vehicle.c

Adds wheel.r to vehicle.c as a union member (default operator). iconic behavior honestly 👑

Example 2. Add an object as a subtracted member

mged> i hole.s main_body.r -

Subtracts hole.s from main_body.r using the short i alias. see, I told you the alias ate 💅

Example 3. Add an intersecting member

mged> instance clipping_box.s hull.r +

Intersects clipping_box.s with hull.r. slay 🌈

🔥 SEE ALSO 🔥

  • group(nged)
  • comb(nged)
  • region(nged)

go read those too, iykyk 💜

🧚 AUTHOR 🧚

BRL-CAD Team — literal icons, we stan 🫶

🙈 BUG REPORTS 🙈

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. not me being your personal bug hotline — but fr fr, they wanna hear from you 💖

lowkey important reminder: comb has to exist already before you instance into it. no creating combos out of thin air here, bestie 😭

and that's the whole page, mwah 💋 this was brought to you by BRL-CAD and the INSTANCE(nged) manual page itself — catch you in the next one, bye bestie 🦋✨🎀

📦 where this page comes from