Mathutils.Matrix

Notes:

Math can be performed on Matrix classes
- mat + mat
- mat - mat
- mat * float/int
- mat * vec
- mat * mat
Comparison operators can be done:
- ==, != test numeric values within epsilon
You can access a quaternion object like a 2d sequence
- x = matrix[0][1]
- vector = matrix[2]

Attention: Quaternion data can be wrapped or non-wrapped. When a object is wrapped it means that the object will give you direct access to the data inside of blender. Modification of this object will directly change the data inside of blender. To copy a wrapped object you need to use the object's constructor. If you copy and object by assignment you will not get a second copy but a second reference to the same data. Only certain functions will return wrapped data. This will be indicated in the method description. Example:

   wrappedObject = Object.getAttribute() #this is wrapped data
   print wrappedObject.wrapped #prints 'True'
   copyOfObject = wrappedObject.copy() #creates a copy of the object
   secondPointer = wrappedObject #creates a second pointer to the same data
   print wrappedObject.attribute #prints '5'
   secondPointer.attribute = 10
   print wrappedObject.attribute #prints '10'
   print copyOfObject.attribute #prints '5'

init(list1=None, list2=None, list3=None, list4=None)
(Constructor)

Create a new matrix object from initialized values.

Example:

 matrix = Matrix([1,1,1],[0,1,0],[1,0,0])
 matrix = Matrix(mat)
 matrix = Matrix(seq1, seq2, vector)

Parameters:

list1 (PyList of int/float) - A 2d,3d or 4d list.
list2 (PyList of int/float) - A 2d,3d or 4d list.
list3 (PyList of int/float) - A 2d,3d or 4d list.
list4 (PyList of int/float) - A 2d,3d or 4d list.

Returns: New matrix object.

It depends wheter a parameter was passed:

(list1, etc.): Matrix object initialized with the given values;
(): An empty 3 dimensional matrix.

identity()

Set the matrix to the identity matrix. An object with zero location and rotation, a scale of 1, will have an identity matrix.

See http://en.wikipedia.org/wiki/Identity_matrix

Returns:: an instance of itself

invert()

Set the matrix to its inverse.

See http://en.wikipedia.org/wiki/Inverse_matrix

Returns:

an instance of itself.

Raises:

ValueError - When matrix is singular.

rotationPart()

Return the 3d submatrix corresponding to the linear term of the embedded affine transformation in 3d. This matrix represents rotation and scale. Note that the (4,4) element of a matrix can be used for uniform scaling, too.

Returns: Matrix object.: Return the 3d matrix for rotation and scale.

scalePart()

Return a the scale part of a 3x3 or 4x4 matrix.

Returns: Vector object.: Return a the scale of a matrix.

Note: This method does not return negative a scale on any axis because it is not possible to obtain this data from the matrix alone.

toEuler(eul_compat)

Return an Euler representation of the rotation matrix (3x3 or 4x4 matrix only).

Parameters:

eul_compat (Euler) - Optional euler argument the new euler will be made compatible with (no axis flipping between them). Useful for converting a series of matrices to animation curves.

Returns: Euler object

Euler representation of the rotation matrix.

Instance Variables
	colSize The column size of the matrix.
	rowSize The row size of the matrix.
	wrapped Whether or not this object wrapps internal data

Class Matrix

The Matrix Object

init(list1=None, list2=None, list3=None, list4=None)
(Constructor)

zero()

copy()

identity()

transpose()

determinant()

invert()

rotationPart()

translationPart()

scalePart()

resize4x4()

toEuler(eul_compat)

toQuat()

Class Matrix

The Matrix Object

__init__(list1=None, list2=None, list3=None, list4=None) (Constructor)

zero()

copy()

identity()

transpose()

determinant()

invert()

rotationPart()

translationPart()

scalePart()

resize4x4()

toEuler(eul_compat)

toQuat()

init(list1=None, list2=None, list3=None, list4=None)
(Constructor)