Skip to documentation
BRL-CAD
DocumentationAll documentsEnglish

UNITS(nged)

NAME

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

On this page

SYNOPSIS

units [-s] [units_type]

DESCRIPTION

Without arguments, returns the current type of units that mged is using. If the -s option is supplied, the current unit name is reported tersely without the surrounding explanatory sentence.

If a units_type is specified, mged switches to editing in the indicated units. The actual database is always stored in millimeters, and the display is adjusted to the user’s choice of units. If the units_type 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. 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

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.

AUTHOR

BRL-CAD Team

BUG REPORTS

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