YPR(nged)

get or set the view orientation as yaw, pitch, and roll angles

📅 published 7.44.0, from nixpkgs unstable

👑 YPR (nged) — the yaw/pitch/roll glow-up ✨

okay bestie, this is the ypr page from the BRL-CAD User Commands set, and it's literally the view-orientation command. it gets or sets your current view orientation as yaw, pitch, and roll angles. no cap, that's the whole vibe. 💅

✨ SYNOPSIS ✨

ypr
ypr yaw pitch roll

🌸 DESCRIPTION 🌸

so ypr gets or sets the current view orientation, expressed as yaw, pitch, and roll angles — all in degrees. it's giving "just tell me where the camera is pointing" and honestly? iconic. 🎀

no arguments at all? ypr returns the current view orientation as three space-separated floating-point values: yaw pitch roll, in degrees. literally just hands you the numbers, no small talk. 🫶

three arguments? ypr sets the view rotation to the yaw, pitch, and roll values you gave it, and updates the display. boom, camera moved. 🔥

Angles are in degrees, and here's the tea on each one:

  • Yaw — rotation about the vertical (Z) axis. positive yaw rotates the view to the right. ➡️
  • Pitch — rotation about the lateral (Y) axis. positive pitch tilts the view upward. ⬆️
  • Roll — rotation about the depth (X) axis. positive roll rotates the view clockwise. 🔄
⚠️ bestie, listen: any number of arguments other than 0 or 3 returns a usage error. not 1, not 2, not 4. zero or three. that's the whole rule. 💀

This command is also accessible as a subcommand of view_func:

view_func ypr [yaw pitch roll]

so if you're already hanging out in view_func land, you can slide right in. 🦋

🎀 EXAMPLES 🎀

Example 1. Get the current view orientation

mged> ypr

Returns the current view yaw, pitch, and roll in degrees, for example: 35.0 25.0 0.0. cute little triplet. 🌈

Example 2. Set the view to a specific yaw/pitch/roll

mged> ypr 45 30 0

Sets the view to a yaw of 45°, pitch of 30°, and roll of 0°. look at you, directing the whole scene. 👑

Example 3. Save and restore view orientation

mged> set orientation [ypr] mged> ypr 90 0 0 mged> ypr
{*}$orientation

Saves the current orientation, applies a temporary 90° yaw, then restores the original orientation. it's giving "screenshot the outfit, try on something chaotic, then change back". 🧚✨

💖 SEE ALSO 💖

  • aet(nged)
  • quat(nged)
  • view_func(nged)

go read those next, iykyk. 📚

🌸 AUTHOR 🌸

BRL-CAD Team — the icons behind it all. 💜

💅 BUG REPORTS 💅

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

🍓 that's the page!! this one's YPR(nged) from BRL-CAD, tag teaming with the rest of the user commands — go point your camera somewhere cute bestie 💖🎀
📦 where this page comes from