Go to: Synopsis. Return value. Keywords. Flags. MEL examples.

Synopsis

matrixUtil [-inverse] [-quaternion float float float float] [-relative] [-rotation float float float] [-scale float float float] [-shear float float float] [-translation float float float] [-transpose]

matrixUtil is undoable, queryable, and editable.

Command to deal with matrix, composition and decomposition

Return value

stringCommand result

In query mode, return type is based on queried flag.

Keywords

matrix, decomposeMatrix, decomposeMatrix

Flags

inverse, quaternion, relative, rotation, scale, shear, translation, transpose
Long name (short name) Argument types Properties
-inverse(-iv) createqueryedit
Compose or query will return the inversed matrix.
-quaternion(-qt) float float float float createqueryedit
Compose, edit or query a matrix using specified quaternion values as rotation components.
-relative(-rt) createqueryedit
Add translation, rotation, scale or shear, instead of seting it as absolute.
-rotation(-r) float float float createqueryedit
Compose, edit or query a matrix using specified values as rotation components.
-scale(-s) float float float createqueryedit
Compose, edit or query a matrix using specified values as scale components.
-shear(-sh) float float float createqueryedit
Compose, edit or query a matrix using specified values as shear components.
-translation(-t) float float float createqueryedit
Compose a matrix using specified values as translation components.
-transpose(-tp) createqueryedit
Compose or query will return the transposed matrix.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

//compose a matrix from translation, rotation, scale and shear
matrixUtil -t 10 20 30 -r 90 0 90 -s 2 3 4 -sh 1 0 0

//get translation
matrixUtil -q -t 1 0 0 0  0 1 0 0  0 0 1 0  0 0 0 1

//get rotation
matrixUtil -q -r 1 0 0 0  0 1 0 0  0 0 1 0  0 0 0 1