man SoUnits () - node that scales to convert units of length

NAME

SoUnits - node that scales to convert units of length

INHERITS FROM

SoBase > SoFieldContainer > SoNode > SoTransformation > SoUnits

SYNOPSIS

#include <Inventor/nodes/SoUnits.h> enum Units { c } c }



c } c }



c } c }



c } c }



c } c }



c } c }



c } c }



c } c }



c } c }



c } c }



c } c }



c } c }



c } c }



c } c }



} Fields from class SoUnits: c } c } units Methods from class SoUnits: c } c } SoUnits()

c } c } getClassTypeId() Methods from class SoNode: c } c } setOverride(SbBool state)

c } c } isOverride() const

c } c } copy(SbBool copyConnections = FALSE) const

c } c } affectsState() const

c } c } getByName(const SbName &name)

c } c } getByName(const SbName &name, SoNodeList &list) Methods from class SoFieldContainer: c } c } setToDefaults()

c } c } hasDefaultValues() const

c } c } fieldsAreEqual(const SoFieldContainer *fc) const

c } c } copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)

c } c } set(const char *fieldDataString)

c } c } get(SbString &fieldDataString)

c } c } getFields(SoFieldList &resultList) const

c } c } getField(const SbName &fieldName) const

c } c } getFieldName(const SoField *field, SbName &fieldName) const

c } c } isNotifyEnabled() const

c } c } enableNotify(SbBool flag) Methods from class SoBase: c } c } ref()

c } c } unref() const

c } c } unrefNoDelete() const

c } c } touch()

c } c } getTypeId() const

c } c } isOfType(SoType type) const

c } c } setName(const SbName &name)

c } c } getName() const

DESCRIPTION

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.

FIELDS

c } c } units

Defines the current unit.

METHODS

c } c } SoUnits()

Creates a unit conversion node with default settings. c } c } getClassTypeId()

Returns type identifier for this class.

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. SoGetMatrixAction

Returns the matrix corresponding to the units scaling.

FILE FORMAT/DEFAULTS

Units {
units	METERS
}

SEE ALSO

SoScale, SoTransform