TransformationMatrix

Syntax

<Path>.TransformationMatrix:real[4,4]/real:[16]

The attribute TransformationMatrix sets the transformation matrix of the designated graphic group of the graphic designated by <Path>.

Note:

When you assign the attribute, Plant Simulation deactivates graphic inheritance.

Note:

You cannot assign the attribute when the graphic is located in an automatically generated graphic group.

Data Type of the Value You Can Assign

To set the entire transformation matrix, you can:

  • Enter a two-dimensional array of data type real with 4 times 4 values.

    For the two-dimensional array the matrix looks like this:

    m11

    m12

    m13

    0

    m21

    m22

    m23

    0

    m31

    m32

    m33

    0

    x

    y

    z

    1

    The sub-matrix m contains the rotation and the scaling. The values x, y, z designate the position.

  • Enter a one-dimensional array of data type real with 16 values.

    For the one-dimensional array the above values are arranged in the following sequence:

    m11 m12 m13 0 m21 m22 m23 0 m31 m32 m33 0 x y z 1

Return Value

The return value is an array of data type real with four times four values.

Example

MyStation._3D.getGraphic("default", [1]).TransformationMatrix := [1,0,0,0, 0,1,0,0, 0,0,1,0, 3,4,0,1]
var m := MyStation._3D.getGraphic("default", [1]).TransformationMatrix
m[2,4] += 3
MyStation._3D.getGraphic("default", [2]).TransformationMatrix  := m

Related Topics

Tab Transformation

_3D.addGraphicTransformation

_3D.transformationMatrix