SoUnits Class Reference
[Transforms]

Node that scales to convert units of length. More...

#include <Inventor/nodes/SoUnits.h>

Inheritance diagram for SoUnits:

List of all members.

Public Types
enum	Units {   METERS,   CENTIMETERS,   MILLIMETERS,   MICROMETERS,   MICRONS,   NANOMETERS,   ANGSTROMS,   KILOMETERS,   FEET,   INCHES,   POINTS,   YARDS,   MILES,   NAUTICAL_MILES }
Public Member Functions
virtual SoType	getTypeId () const
	SoUnits ()
Static Public Member Functions
static SoType	getClassTypeId ()
Public Attributes
SoSFEnum	units

---

Detailed Description

Node that scales to convert units of length.

This node defines a uniform 3D scale about the origin relative to the previously defined units. The default units for all data are meters. Adding a units node with the value INCHES will have the same effect as adding an SoScale node with the scaleFactor of (.0254, .0254, .0254). Any subsequent SoUnits node will take the previous units into account. When building a composite object out of a bunch of pieces, it would be a good practice to add an SoUnits node at the beginning of each of the pieces, under an SoSeparator node, to make sure all the pieces fit together with the same scale.

FILE FORMAT/DEFAULT

Units {

units

METERS

}

ACTION BEHAVIOR

SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction, SoRayPickAction
Accumulates the scale that is the ratio of the size from the previous unit to the current unit into the current transformation. Sets: SoModelMatrixElement, SoUnitsElement

SoGetMatrixAction
Returns the matrix corresponding to the units scaling.

SEE ALSO

SoScale, SoTransform

---

Member Enumeration Documentation

enum SoUnits::Units

Units.

Enumerator:

METERS	METERS.
CENTIMETERS	CENTIMETERS.
MILLIMETERS	MILLIMETERS.
MICROMETERS	MICROMETERS.
MICRONS	MICRONS.
NANOMETERS	NANOMETERS.
ANGSTROMS	ANGSTROMS.
KILOMETERS	KILOMETERS.
FEET	FEET.
INCHES	INCHES.
POINTS	POINTS.
YARDS	YARDS.
MILES	MILES.
NAUTICAL_MILES	NAUTICAL_MILES.

---

Constructor & Destructor Documentation

SoUnits::SoUnits

(

)

Creates a unit conversion node with default settings.

---

Member Function Documentation

static SoType SoUnits::getClassTypeId

(

)

[static]

Returns the type identifier for this class.

Reimplemented from SoTransformation.

virtual SoType SoUnits::getTypeId

(

)

const [virtual]

Returns the type identifier for this specific instance.

Reimplemented from SoTransformation.

---

Member Data Documentation

SoSFEnum SoUnits::units

Defines the current unit.

Use enum Units. Default is METERS.

---

The documentation for this class was generated from the following file:

• Inventor/nodes/SoUnits.h