com.openinventor.inventor.nodes

Class SoUnits

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoTransformation

com.openinventor.inventor.nodes.SoUnits

All Implemented Interfaces:

SafeDisposable

public class SoUnits
extends SoTransformation

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoUnits.UnitsType Units.

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	ANGSTROMS Deprecated. Use SoUnits.UnitsType.ANGSTROMS instead.
static int	CENTIMETERS Deprecated. Use SoUnits.UnitsType.CENTIMETERS instead.
static int	FEET Deprecated. Use SoUnits.UnitsType.FEET instead.
static int	INCHES Deprecated. Use SoUnits.UnitsType.INCHES instead.
static int	KILOMETERS Deprecated. Use SoUnits.UnitsType.KILOMETERS instead.
static int	METERS Deprecated. Use SoUnits.UnitsType.METERS instead.
static int	MICROMETERS Deprecated. Use SoUnits.UnitsType.MICROMETERS instead.
static int	MICRONS Deprecated. Use SoUnits.UnitsType.MICRONS instead.
static int	MILES Deprecated. Use SoUnits.UnitsType.MILES instead.
static int	MILLIMETERS Deprecated. Use SoUnits.UnitsType.MILLIMETERS instead.
static int	NANOMETERS Deprecated. Use SoUnits.UnitsType.NANOMETERS instead.
static int	NAUTICAL_MILES Deprecated. Use SoUnits.UnitsType.NAUTICAL_MILES instead.
static int	POINTS Deprecated. Use SoUnits.UnitsType.POINTS instead.
SoSFEnum<SoUnits.UnitsType>	units Defines the current unit.
static int	YARDS Deprecated. Use SoUnits.UnitsType.YARDS instead.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoUnits() Creates a unit conversion node with default settings.

Method Summary

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

METERS

@Deprecated
public static final int METERS

Deprecated. Use SoUnits.UnitsType.METERS instead.

CENTIMETERS

@Deprecated
public static final int CENTIMETERS

Deprecated. Use SoUnits.UnitsType.CENTIMETERS instead.

MILLIMETERS

@Deprecated
public static final int MILLIMETERS

Deprecated. Use SoUnits.UnitsType.MILLIMETERS instead.

MICROMETERS

@Deprecated
public static final int MICROMETERS

Deprecated. Use SoUnits.UnitsType.MICROMETERS instead.

MICRONS

@Deprecated
public static final int MICRONS

Deprecated. Use SoUnits.UnitsType.MICRONS instead.

NANOMETERS

@Deprecated
public static final int NANOMETERS

Deprecated. Use SoUnits.UnitsType.NANOMETERS instead.

ANGSTROMS

@Deprecated
public static final int ANGSTROMS

Deprecated. Use SoUnits.UnitsType.ANGSTROMS instead.

KILOMETERS

@Deprecated
public static final int KILOMETERS

Deprecated. Use SoUnits.UnitsType.KILOMETERS instead.

FEET

@Deprecated
public static final int FEET

Deprecated. Use SoUnits.UnitsType.FEET instead.

INCHES

@Deprecated
public static final int INCHES

Deprecated. Use SoUnits.UnitsType.INCHES instead.

POINTS

@Deprecated
public static final int POINTS

Deprecated. Use SoUnits.UnitsType.POINTS instead.

YARDS

@Deprecated
public static final int YARDS

Deprecated. Use SoUnits.UnitsType.YARDS instead.

MILES

@Deprecated
public static final int MILES

Deprecated. Use SoUnits.UnitsType.MILES instead.

NAUTICAL_MILES

@Deprecated
public static final int NAUTICAL_MILES

Deprecated. Use SoUnits.UnitsType.NAUTICAL_MILES instead.

units

public final SoSFEnum<SoUnits.UnitsType> units

Defines the current unit. Use enum Units. Default is METERS.

Constructor Detail

SoUnits

public SoUnits()

Creates a unit conversion node with default settings.