PERMUTE(nged)

💅 PERMUTE — the nged glow-up your ARB vertices deserve

okay bestie, so we're deep in the nged manual (that's the BRL-CAD user commands neck of the woods 🌈) and today's main character is permute. she's little, she's specific, and she will absolutely reorder your vertex labels for you. no cap. 🎀

---

✨ NAME ✨

permute — permutes the vertex labels for the face of an ARB shape that is currently being edited. that's literally her whole job and she ate 💅

---

🦋 SYNOPSIS 🦋

permute {tuple}

---

🌸 DESCRIPTION 🌸

okay so here's the vibe: permute permutes the vertex labels for the face of an ARB shape that is currently being edited. currently being edited!! she only works on the one you're in right now, she's not gonna go rummaging through your whole database 🫶

the tuple tells her two things at once — which face is affected, and what the desired result is. she's efficient like that, an icon, truly 👑

the tuple is formed by concatenating the list of vertex numbers for the face in the order desired, such that the first vertex listed will become vertex number one (and therefore the default keypoint). yes — first in the tuple = vertex number one = the default keypoint. that's the whole trick, iykyk ⭐

and plot twist: only a sufficient number of vertices to disambiguate need be included in the tuple. so you don't have to list every single one, just enough to make it unambiguous, and she'll take it from there 💖

⚠️ important bestie, do not skip this: note that this has no effect on the geometry of the ARB, but may affect any texture mapping involving this shape. so your shape stays exactly the same shape — but your textures might come out looking different. the geometry is unbothered, the texture mapping said "not me catching strays" 😭

---

🔥 EXAMPLES 🔥

the example shows the use of the permute command to rearrange the vertices of the ARB being edited according to the specified tuple. let's get into it:

💜 Example 1. Rearrange the vertices of an ARB being edited.

mged>permute 321

rearranges the vertices of the currently edited ARB such that vertex 3 becomes vertex 1, vertex 2 remains 2, and vertex 1 becomes 3. so she's basically doing a little swap-swap on the ends and leaving vertex 2 completely unbothered to live her truth 💀✨

---

👑 AUTHOR 👑

BRL-CAD Team — the legends themselves 🌟

---

🙈 BUG REPORTS 🙈

reports of bugs or problems should be submitted via electronic mail to devs@brl-cad.org. don't be shy, they want to hear it, fr fr 📧

---

and that's the whole page bestie, every last flag-free detail preserved, no details left behind, periodt 💖

courtesy of BRL-CAD — this is the PERMUTE(nged) page, filed right there in the BRL-CAD User Commands section, and yes the footer says BRL-CAD too, so we're bookended by it 🎀