PROTATE(nged)

rotate a vector attribute of a primitive by Euler angles

📅 published 7.44.0, from nixpkgs unstable

💅 protate (nged) 💅

okay bestie, welcome to the protate page from the nged manual — BRL-CAD user commands, but make it group-chat cute. We're rotating a vector attribute of a primitive by Euler angles, and it's giving geometry glow-up. ✨🌀

✨ NAME ✨

protate — rotate a vector attribute of a primitive by Euler angles. 💫

✨ SYNOPSIS ✨

protate obj attribute "rx ry rz"

✨ DESCRIPTION ✨

The protate command rotates a specific vector attribute of the BRL-CAD primitive obj by the Euler angles rx, ry, rz (in degrees). 🌀 The rotation is applied to an individual geometric attribute (a specific vector field) of the primitive rather than to the whole object. The modified object is written back to the database. 💾

The three arguments are:

  • obj — the name of the primitive to edit. May include a path prefix (e.g. comb/part.s), in which case the trailing component name is used. Only BRLCAD-type primitives are supported; combinations are rejected. 🚫
  • attribute — a single letter identifying which vector field of the primitive to rotate. Valid attributes depend on the primitive type (see the list below 💅).
  • "rx ry rz" — the rotation angles in degrees, as a single quoted space-separated string of three floating-point values. The rotation matrix is constructed from these Euler angles. 🔢

✨ Supported primitive types and attributes ✨

  • ETO (Elliptical Torus) — attribute c or C: rotate the semi-minor axis vector of the elliptical cross-section. 🍩
  • TGC (Truncated General Cone) — attribute h or H: rotate the height vector of the cone. 📐
  • EXTRUDE — attribute h or H: rotate the extrusion direction vector. 🧵
  • HYP (Hyperboloid) — attribute h or H: rotate the height (axis) vector of the hyperboloid. 🦋

Other primitive types are not currently supported and will return an error. 💀

✨ EXAMPLES ✨

Example 1. Rotate the height vector of a TGC cone by 45° about Z 🌈

mged> protate cone.s h "0 0 45"

Rotates the height vector of the TGC primitive cone.s by 45° about the Z axis. 🎯

Example 2. Rotate the cross-section axis of an ETO 🌸

mged> protate ring.s c "30 0 0"

Rotates the semi-minor axis vector of the ETO primitive ring.s by 30° about the X axis. 💖

✨ AUTHOR ✨

BRL-CAD Team 👑

✨ BUG REPORTS ✨

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. 📬

💖 source/version: BRL-CAD": manual: PROTATE(nged) · date: not listed in the original footer, so no invented date here — just the classic footer energy. 🫶

📦 where this page comes from