PSCALE(nged)

scale a scalar or vector attribute of a primitive

📅 published 7.44.0, from nixpkgs unstable

✨ PSCALE(nged) ✨

okay bestie, welcome to pscale — one of the nged girlies and honestly kind of a niche icon 💅 she scales a single scalar or vector attribute of a primitive and writes it right back into the database, no cap.

🌸 NAME 🌸

pscale — scale a scalar or vector attribute of a primitive 🎀

🦋 SYNOPSIS 🦋

pscale [-r] obj attribute sf

💖 DESCRIPTION 💖

So here's the vibe: pscale takes a specific attribute of the BRL-CAD primitive obj and scales it by the scale factor sf. The attribute gets picked by a single letter, and the modified object is written back to the database. Literally that simple, periodt. ✨

The arguments are:

  • -r — optional, babes. Relative mode: the scale factor gets applied relative to the current attribute value (multiplicative). Without -r, the scale factor is an absolute value. Either way the scale factor has to be positive and greater than zero. 🫶
  • obj — the name of the primitive you're editing. Path prefixes (like comb/part.s) are accepted — the trailing component name is what actually gets used. iykyk.
  • attribute — a single letter that selects which attribute of the primitive to scale (full menu down below 👇).
  • sf — the scale factor. Must be positive (greater than zero). no zero, no negatives, we don't do that here 💀

👑 Supported primitives and attributes 👑

Not every primitive is invited to the party — but these ones ate:

  • EHY (Elliptical Hyperboloid) — h/H, a/A, b/B, c/C — height, semi-major axis, semi-minor axis, neck-to-base distance. 🌈
  • ELL / SPH (Ellipsoid / Sphere) — a/A, b/B, c/C — the A, B, and C semi-axis vectors. Scaling A with no sub-attribute scales all three uniformly. iconic behavior fr.
  • EPA (Elliptical Paraboloid) — h/H, a/A, b/B — height, semi-major axis, semi-minor axis. 💜
  • ETO (Elliptical Torus) — r/R, d/D, c/C — major radius, tube diameter, semi-minor cross-section axis. 🍓
  • EXTRUDE — h/H — extrusion height vector magnitude. short and sweet.
  • HYP (Hyperboloid) — h/H, a/A, b/B, c/C — height, semi-major, semi-minor, and c-value. and psst: h accepts the v/V sub-attribute. 🧚
  • PARTICLE — h/H, v, h (lowercase) — total length, vertex radius, head radius. yes the lowercase h is a different thing, read it carefully bestie 😭
  • RHC (Right Hyperbolic Cylinder) — b/B, h/H, c/C, r/R — half-width, height, c-distance, radius. ⭐
  • RPC (Right Parabolic Cylinder) — b/B, h/H, r/R — half-width, height, radius. 🦋
  • SUPERELL — a/A, b/B, c/C — the A, B, C semi-axis vectors.
  • TGC (Truncated General Cone) — a/A, b/B, c/C, d/D, h/H — top/bottom radii, cross-section axes, height vector. 💅
  • TOR (Torus) — a/A, h/H — major radius, tube (minor) radius. 🎀
  • PIPE — b/B, r/R, i/I, o/O — bend radius, radius, inner radius, outer radius.
  • METABALL — f/F, s/S — field strength, strength value. 🔥
⚠️ Other primitive types return an error. she's picky, and honestly? valid.

🌟 EXAMPLES 🌟

Example 1. Scale the height of a TGC

mged> pscale cone.s h 1.5

Sets the height of the TGC primitive cone.s to 1.5 times its current absolute value. slay. 💖

Example 2. Scale a TOR major radius relatively

mged> pscale -r ring.s a 0.8

Multiplies the major radius of the torus ring.s by 0.8, shrinking it to 80% of its current size. shrinking but make it cute 🎀

Example 3. Scale the A axis of an ellipsoid

mged> pscale sphere.s a 50

Sets the A semi-axis of sphere.s to 50 (in local units). big girl numbers. ✨

💜 AUTHOR 💜

BRL-CAD Team — legends, honestly 🫶

🐛 BUG REPORTS 🐛

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org — pls do tell them, they wanna know 🙈

okay that's the whole page, bestie!! go forth and scale responsibly 💅✨ this has been PSCALE(nged) from the BRL-CAD User Commands collection — mwah, see u in the group chat 🦋💖

📦 where this page comes from