UNITS(nged)

Sets the units being used in mged. Without arguments, returns the current units being used in mged.

📅 published 7.44.0, from nixpkgs unstable

🌸 NAME 🌸

units — sets the units being used in mged. And if you give it no arguments at all, it just hands you back the current units being used in mged. 💅

✨ SYNOPSIS ✨

units [-s] [units_type]

💖 DESCRIPTION 💖

okay so, bestie, listen: with no arguments, it returns the current type of units that mged is using. That's it. That's the whole vibe check. 🎀

But if you pass the -s option, the current unit name gets reported tersely — like, without the surrounding explanatory sentence. Just the name, straight to the point, no extra commentary. Iconic behavior honestly.

Now the main character part: if you actually specify a units_type, mged switches to editing in the units you indicated. Important lore 🧚 — the actual database is always stored in millimeters, and the display is adjusted to whatever units you chose. So the real data stays in mm, only the display changes. Periodt.

And if the units_type you specified on the command line is one of the types allowed, it will be written to the database file as the preferred units, and succeeding invocations will use those units. It remembers. 🫶

The units_type strings that will be remembered as the preferred editing unit are as follows:

  • mm — millimeters
  • millimeter — millimeters
  • cm — centimeters
  • centimeter — centimeters
  • m — meters
  • meter — meters
  • in — inches
  • inch — inches
  • ft — feet
  • foot — feet
  • feet — feet
  • um — micrometers

units_type strings that may be used, but will not be remembered as the preferred editing units, are as follows:

  • angstrom
  • decinanometer
  • nanometer
  • nm
  • micron
  • micrometer
  • km
  • kilometer
  • cubit
  • yd
  • yard
  • rd
  • rod
  • mi
  • mile
  • nmile
  • nautical mile
  • au
  • astronomical unit
  • lightyear
  • pc
  • parsec
💀 lowkey important: those second-list units work fine, they just don't get saved as your preferred editing unit. Don't come for me when it doesn't stick, okay? 🙈

🔥 EXAMPLES 🔥

The example shows the use of the units command with a units_type argument to switch the editing units.

Example 1. Switch the editing units to inches.

mged>units in

Switch to editing in inches and remember this as the preferred editing units for this database. Slay. ✨

👑 AUTHOR 👑

BRL-CAD Team 💜

🦋 BUG REPORTS 🦋

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

okay that's the whole thing, bestie — this has been UNITS(nged) from BRL-CAD (that's the source/version, no cap), and we are so done here. go forth and measure things correctly 💅💖🌈

📦 where this page comes from