blender-archive/doc/python_api/examples/mathutils.Matrix.py

import mathutils
import math

# create a location matrix
mat_loc = mathutils.Matrix.Translation((2.0, 3.0, 4.0))

# create an identitiy matrix
mat_sca = mathutils.Matrix.Scale(0.5, 4, (0.0, 0.0, 1.0))

# create a rotation matrix
mat_rot = mathutils.Matrix.Rotation(math.radians(45.0), 4, 'X')

# combine transformations
mat_out = mat_loc @ mat_rot @ mat_sca
print(mat_out)

# extract components back out of the matrix as two vectors and a quaternion
loc, rot, sca = mat_out.decompose()
print(loc, rot, sca)

# recombine extracted components
mat_out2 = mathutils.Matrix.LocRotScale(loc, rot, sca)
print(mat_out2)

# it can also be useful to access components of a matrix directly
mat = mathutils.Matrix()
mat[0][0], mat[1][0], mat[2][0] = 0.0, 1.0, 2.0

mat[0][0:3] = 0.0, 1.0, 2.0

# each item in a matrix is a vector so vector utility functions can be used
mat[0].xyz = 0.0, 1.0, 2.0
PyAPI - added new mathutils.Color() type, use with rna so we can do for eg: material.diffuse_color.r = 1.0 # also has hsv access material.diffuse_color.s = 0.6 - made Mathutils and Geometry module names lowercase. 2010-04-11 14:22:27 +00:00			`import mathutils`
docs / clenup (no functional code changes) - added API examples for mathutils.Color/Euler/Quaternion/Matrix. - corrected own bad spelling matricies --> matrices. - minor pep8 edits. - update CMake ignore file list. 2011-10-17 02:20:53 +00:00			`import math`
PyAPI - added new mathutils.Color() type, use with rna so we can do for eg: material.diffuse_color.r = 1.0 # also has hsv access material.diffuse_color.s = 0.6 - made Mathutils and Geometry module names lowercase. 2010-04-11 14:22:27 +00:00
docs / clenup (no functional code changes) - added API examples for mathutils.Color/Euler/Quaternion/Matrix. - corrected own bad spelling matricies --> matrices. - minor pep8 edits. - update CMake ignore file list. 2011-10-17 02:20:53 +00:00			`# create a location matrix`
			`mat_loc = mathutils.Matrix.Translation((2.0, 3.0, 4.0))`

			`# create an identitiy matrix`
			`mat_sca = mathutils.Matrix.Scale(0.5, 4, (0.0, 0.0, 1.0))`

			`# create a rotation matrix`
			`mat_rot = mathutils.Matrix.Rotation(math.radians(45.0), 4, 'X')`

			`# combine transformations`
Python API Docs: fix some examples 2019-06-06 17:12:49 +02:00			`mat_out = mat_loc @ mat_rot @ mat_sca`
docs / clenup (no functional code changes) - added API examples for mathutils.Color/Euler/Quaternion/Matrix. - corrected own bad spelling matricies --> matrices. - minor pep8 edits. - update CMake ignore file list. 2011-10-17 02:20:53 +00:00			`print(mat_out)`

Mathutils: add a Matrix.LocRotScale constructor for combining channels. Combining location, rotation and scale channels into a matrix is a standard task, so while it is easily accomplished by constructing and multiplying 3 matrices, having a standard utility allows for more clear code. The new constructor builds a 4x4 matrix from separate location, rotation and scale values. Rotation can be represented as a 3x3 Matrix, Quaternion or Euler value, while the other two inputs are vectors. Unneeded inputs can be replaced with None. Differential Revision: https://developer.blender.org/D11264 2021-05-14 19:46:19 +03:00			`# extract components back out of the matrix as two vectors and a quaternion`
docs / clenup (no functional code changes) - added API examples for mathutils.Color/Euler/Quaternion/Matrix. - corrected own bad spelling matricies --> matrices. - minor pep8 edits. - update CMake ignore file list. 2011-10-17 02:20:53 +00:00			`loc, rot, sca = mat_out.decompose()`
			`print(loc, rot, sca)`

Mathutils: add a Matrix.LocRotScale constructor for combining channels. Combining location, rotation and scale channels into a matrix is a standard task, so while it is easily accomplished by constructing and multiplying 3 matrices, having a standard utility allows for more clear code. The new constructor builds a 4x4 matrix from separate location, rotation and scale values. Rotation can be represented as a 3x3 Matrix, Quaternion or Euler value, while the other two inputs are vectors. Unneeded inputs can be replaced with None. Differential Revision: https://developer.blender.org/D11264 2021-05-14 19:46:19 +03:00			`# recombine extracted components`
			`mat_out2 = mathutils.Matrix.LocRotScale(loc, rot, sca)`
			`print(mat_out2)`

docs / clenup (no functional code changes) - added API examples for mathutils.Color/Euler/Quaternion/Matrix. - corrected own bad spelling matricies --> matrices. - minor pep8 edits. - update CMake ignore file list. 2011-10-17 02:20:53 +00:00			`# it can also be useful to access components of a matrix directly`
			`mat = mathutils.Matrix()`
			`mat[0][0], mat[1][0], mat[2][0] = 0.0, 1.0, 2.0`

			`mat[0][0:3] = 0.0, 1.0, 2.0`

			`# each item in a matrix is a vector so vector utility functions can be used`
			`mat[0].xyz = 0.0, 1.0, 2.0`