compose_matrix

compas.geometry.compose_matrix(scale=None, shear=None, angles=None, translation=None, perspective=None)

Calculates a matrix from the components of scale, shear, euler_angles, translation and perspective.

Parameters:

scale[float, float, float]

The 3 scale factors in x-, y-, and z-direction.

shear[float, float, float]

The 3 shear factors for x-y, x-z, and y-z axes.

angles[float, float, float]

The rotation specified through the 3 Euler angles about static x, y, z axes.

translation[float, float, float]

The 3 values of translation.

perspective[float, float, float, float]

The 4 perspective entries of the matrix.

Returns:

list[list[float]]

The 4x4 matrix that combines the provided transformation components.

See also

decompose_matrix

Examples

>>> trans1 = [1, 2, 3]
>>> angle1 = [-2.142, 1.141, -0.142]
>>> scale1 = [0.123, 2, 0.5]
>>> M = compose_matrix(scale1, None, angle1, trans1, None)
>>> scale2, shear2, angle2, trans2, persp2 = decompose_matrix(M)
>>> allclose(scale1, scale2)
True
>>> allclose(angle1, angle2)
True
>>> allclose(trans1, trans2)
True