instantreality 1.0

SFMatrix3f

The SFMatrix3f object provides many useful functions for performing manipulations on 3x3 matrices.

Each of element of the matrix can be accessed using C-style array dereferencing (i.e., m[0][1] is the element in row 0, column 1). The results of dereferencing a SFMatrix3f object using a single index (i.e., m[0]) are undefined. The translation elements are in the third row. For example, m[2][0] is the X offset.Additionally the individual rows of the matrix may be addressed using array-style indexing returning a SFMatrix3Row instance. The values of the SFMatrix3Row instance can be accessed using C-Style array dereferencing (e.g., m[0] is f11, [2] is f12, and [3] is f13.

Properties

TypePropertyDescriptionStandard

Functions

Return typeFunctionDescriptionStandard
voidsetTransform(SFVec2f translation, SFVec3f rotation, SFVec2f scale, SFVec3f scaleOrientation, SFVec2f center)

Sets the Matrix to the passed values.

Any of the rightmost parameters may be omitted. The function has zero to five parameters. For example, specifying zero parameters results in an identity matrix while specifying one parameter results in a translation and specifying two parameters results in a translation and a rotation. Any unspecified parameter is set to its default as specified for the Transform node. Values are applied to the matrix in the same order as the matrix field calculations for the Transform node.

Avalon
voidgetTransform(SFVec2f translation, SFVec3f rotation, SFVec2f scale)

Decomposes the Matrix and returns the components in the passed translation, rotation, and scale objects.

The types of these passed objects is the same as the first three arguments to setTransform. If any passed object is not sent, or if the null object is sent for any value, that value is not returned. Any projection or shear information in the matrix is ignored.

Avalon
SFMatrix3finverse()

Returns a new SFMatrix3f whose value is the inverse of this object.

Avalon
SFMatrix3ftranspose()

Returns a new SFMatrix3f whose value is the transpose of this object.

Avalon
SFMatrix3fmultLeft(SFMatrix3f n)

Returns a new SFMatrix3f whose value is the object multiplied by the passed matrix on the left.

Avalon
SFMatrix3fmultRight(SFMatrix3f m)

Returns a new SFMatrix3f whose value is the object multiplied by the passed matrix on the right.

Avalon
SFVec2fmultVecMatrix(SFVec2f vec)

Returns a new SFVec2f whose value is the object multiplied by the passed row vector.

Avalon
SFVec2fmultMatrixVec(SFVec2f vec)

Returns a new SFVec2f whose value is the object multiplied by the passed column vector..

Avalon
StringtoString()

Returns a String containing the matrix contents encoded using the X3D Classic VRML encoding.

Avalon