AET(nged)

get or set the view orientation as azimuth, elevation, and twist

πŸ“… published 7.44.0, from nixpkgs unstable

πŸ’… AET(nged) β€” the BRL-CAD glow-up for your viewpoint

okay bestie, so this is aet (and its little twin ae) from the BRL-CAD user commands fam β€” the tool that gets or sets your view orientation as azimuth, elevation, and twist. basically it's the main character of "which way am I even looking rn" πŸ’–


✨ SYNOPSIS ✨

aet
aet [-i] az el [tw]
aet [-i] "az el [tw]"

🌸 DESCRIPTION 🌸

so the aet command (which also answers to ae, iconic of it) either gets or sets the current view orientation, expressed as azimuth, elevation, and an optional twist β€” all in degrees. no cap. πŸŽ€

When you give it zero arguments, aet just hands you back the current view orientation as three space-separated floating-point values:

az el tw

When you give it arguments, aet sets the view rotation to whatever azimuth and elevation (and optional twist) you asked for, then updates the display. slay. πŸ”₯

  • Azimuth (az) β€” horizontal rotation about the vertical axis, measured in degrees. 0Β° looks from the front; 90Β° looks from the right. think of it as walking around your model in a circle πŸ¦‹
  • Elevation (el) β€” vertical angle above or below the horizontal plane, in degrees. 90Β° looks straight down. very bird's-eye, very demure πŸ•ŠοΈ
  • Twist (tw) β€” roll rotation about the viewing axis, in degrees. it's optional and defaults to 0Β° if you don't mention it. the lowkey bonus angle πŸ’«

🌈 Options

  • -i β€” treat the angles you give as incremental offsets added on top of the current azimuth, elevation, and twist, instead of as absolute values. ngl this is the "nudge me a lil" mode 🫢

⭐ Input forms

you've got options, babe β€” angles can come in as two or three separate arguments (az el or az el tw), or as one single quoted space-separated string ("az el" or "az el tw"). and in every form, if twist is omitted it defaults to 0. periodt. πŸ’…


πŸŽ€ EXAMPLES πŸŽ€

Example 1. Get the current view orientation

mged> aet

returns the current azimuth, elevation, and twist in degrees β€” for example: 35 25 0. just a lil vibe check on where you're at πŸ‘‘

Example 2. Set the view to azimuth 35, elevation 25

mged> aet 35 25

sets the view to azimuth 35°, elevation 25°, twist 0°. chef's kiss ✨

Example 3. Set azimuth, elevation, and twist together

mged> aet 45 30 15

sets the view to azimuth 45Β°, elevation 30Β°, twist 15Β°. all three angles, all three vibes πŸ“

Example 4. Rotate the view incrementally

mged> aet -i 10 0

adds 10° to the current azimuth without changing elevation or twist. tiny rotate, big impact 😌

Example 5. Set orientation using a quoted string

mged> aet "270 0"

sets the view to look from the left side (azimuth 270°, elevation 0°). quoted string girlies, this one's for you 🧚


πŸ’œ SEE ALSO

ypr(nged), quat(nged), ae2dir(nged) β€” the rest of the orientation friend group, go say hi 🫢


πŸ‘‘ AUTHOR

BRL-CAD Team (the icons who made this happen)


πŸ’€ BUG REPORTS

found a bug or a problem? don't suffer in silence, bestie β€” reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org πŸ“§


and that's the whole thing, fr fr. this page is AET(nged) from the BRL-CAD user commands, brought to you by BRL-CAD itself β€” go forth and look at your models from a better angle πŸ’–βœ¨πŸ¦‹

πŸ“¦ where this page comes from