com.openinventor.inventor.fields

Class SoSFMatrix

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.fields.SoField

com.openinventor.inventor.fields.SoSField

com.openinventor.inventor.fields.SoSFMatrix

public class SoSFMatrix
extends SoSField

Field containing a 4x4 matrix. A field containing a transformation matrix (an SbMatrix).

SoSFMatrixs are written to file as 16 floating point numbers separated by whitespace. For example, an identity matrix is written as:

   1 0 0 0 0 1 0 0 0 0 1 0 0 0 0 1

See also:

SoField, SoSField, SoMFMatrix, SbMatrix

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.fields.SoField

SoField.FieldTypes

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

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoSFMatrix() Deprecated. As of Open Inventor 9.3 Use constructor with SoFieldContainer instead.
SoSFMatrix(SoFieldContainer fieldContainer, java.lang.String fieldName, SoField.FieldTypes fieldType, SbMatrix defaultValue) Default constructor.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
SbMatrix	getValue() Returns this field's value.
long	getValueSize() Get size of the value.
void	setValue(float a11, float a12, float a13, float a14, float a21, float a22, float a23, float a24, float a31, float a32, float a33, float a34, float a41, float a42, float a43, float a44) Sets this field to contain the matrix given by the 16 values.
void	setValue(SbMatrix newValue) Sets this field to newValue.
void	setValue(SbMatrixd md) Convenience method that allows you to specify a field value using a double precision variable.

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

appendConnection, appendConnection, appendConnection, connectFrom, connectFrom, connectFrom, disconnect, disconnect, disconnect, disconnect, enableConnection, get, getConnectedEngine, getConnectedField, getConnectedVRMLInterp, getContainer, getNumConnections, isConnected, isConnectedFromEngine, isConnectedFromField, isConnectedFromVRMLInterp, isConnectionEnabled, isDefault, isIgnored, set, setIgnored, touch

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Constructor Detail

SoSFMatrix

@Deprecated
public SoSFMatrix()

Deprecated. As of Open Inventor 9.3 Use constructor with SoFieldContainer instead.

SoSFMatrix

public SoSFMatrix(SoFieldContainer fieldContainer,
                  java.lang.String fieldName,
                  SoField.FieldTypes fieldType,
                  SbMatrix defaultValue)

Default constructor.

Method Detail

setValue

public void setValue(SbMatrix newValue)

Sets this field to newValue.

getValue

public SbMatrix getValue()

Returns this field's value.

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class SoField

setValue

public void setValue(float a11,
                     float a12,
                     float a13,
                     float a14,
                     float a21,
                     float a22,
                     float a23,
                     float a24,
                     float a31,
                     float a32,
                     float a33,
                     float a34,
                     float a41,
                     float a42,
                     float a43,
                     float a44)

Sets this field to contain the matrix given by the 16 values. For a translation matrix, the x, y and z translations should be in the a41, a42, and a43 arguments.

setValue

public void setValue(SbMatrixd md)

Convenience method that allows you to specify a field value using a double precision variable. Note that Open Inventor fields still store only single precision values, not double precision values. The specified value is converted to single precision, then stored.

getValueSize

public long getValueSize()

Get size of the value.