CPI(nged)

💅 NAME 💅

okay bestie, welcome to the CPI(nged) page from the BRL-CAD User Commands manual — this is the cpi command, and it is so specific but honestly kind of iconic. ✨

cpi copies old_tgc (an existing TGC shape) to a new TGC shape, new_tgc, positions that new TGC so its base vertex is coincident with the center of the top of old_tgc, and then puts mged into the primitive edit state with new_tgc selected for editing. it's giving “copy, stack, edit” energy, no cap. 💖

---

✨ SYNOPSIS ✨

cpi {old_tgc new_tgc}

---

🦋 DESCRIPTION 🦋

so here's the tea: cpi copies old_tgc — which is an existing TGC shape — to a new TGC shape called new_tgc. then it positions the new TGC such that its base vertex is coincident with the center of the top of old_tgc, and it puts mged into the primitive edit state with new_tgc selected for editing. literally base vertex meets center-of-top, and then you're editing the new one. 🫶

back in the day, this command was typically used in creating models of wiring or piping runs. but plot twist: a pipe primitive has since been added to BRL-CAD to handle such requirements. so that's the lore. 🌸

---

🌸 EXAMPLES 🌸

the example shows the use of the cpi command to copy an existing TGC shape to a new TGC shape and position the new shape with its base vertex coincident with the center of the top of the existing shape. yes bestie, exactly that. 💅

🎀 Example 1. Copy an existing TGC shape to a new TGC shape. 🎀

mged>cpi tgc_a tgc_b

Copies tgc_a to tgc_b and translates tgc_b to the end of tgc_a. slay. 🔥

---

👑 AUTHOR 👑

BRL-CAD Team — iconic behavior, honestly. 💖

---

💌 BUG REPORTS 💌

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. don't be shy, bestie — they wanna know. 🐛✨

---

source/version tag situation: BRL-CAD; page name: CPI(nged); date: not listed on this footer, so that's the whole footer tea. bye bestie 🫶💖🎀