com.openinventor.inventor.engines

Class SoDecomposeMatrix

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.engines.SoEngine

com.openinventor.inventor.engines.SoDecomposeMatrix

All Implemented Interfaces:

SafeDisposable

public class SoDecomposeMatrix
extends SoEngine

Decomposes transformation matrices into values for translation, rotation, and scale. This engine takes as input a transformation matrix and a center of transformation. As output the engine produces the translation, rotation and scale values derived from the matrix.

The input fields can have multiple values, allowing the engine to decompose several matrices in parallel. One of the inputs may have more values than the other. In that case, the last value of the shorter input will be repeated as necessary.

File format/default:

DecomposeMatrix {

matrix	1 0 0 0
	0 1 0 0
	0 0 1 0
	0 0 0 1
center	0 0 0

}

See also:

SoComposeMatrix, SoEngineOutput

Nested Class Summary

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoMFVec3f	center The center of transformations.
SoMFMatrix	matrix The 4x4 transformation matrix.
SoEngineOutput	rotation ( SoMFRotation ) Derived rotation.
SoEngineOutput	scaleFactor ( SoMFVec3f ) Derived scale values in x, y, and z.
SoEngineOutput	scaleOrientation ( SoMFRotation ) Derived rotational space for scaling.
SoEngineOutput	translation ( SoMFVec3f ) Derived translation in x, y, and z.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoDecomposeMatrix() Default Constructor.

Method Summary

Methods inherited from class com.openinventor.inventor.engines.SoEngine

copy, getByName, getOutput, getOutputName

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, touch

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

matrix

public final SoMFMatrix matrix

The 4x4 transformation matrix.

center

public final SoMFVec3f center

The center of transformations.

translation

public final SoEngineOutput translation

( SoMFVec3f ) Derived translation in x, y, and z.

rotation

public final SoEngineOutput rotation

( SoMFRotation ) Derived rotation.

scaleFactor

public final SoEngineOutput scaleFactor

( SoMFVec3f ) Derived scale values in x, y, and z.

scaleOrientation

public final SoEngineOutput scaleOrientation

( SoMFRotation ) Derived rotational space for scaling.

Constructor Detail

SoDecomposeMatrix

public SoDecomposeMatrix()

Default Constructor.