GPU Matrix Utilities (gpu.matrix)¶
This module provides access to the matrix stack.
- gpu.matrix.get_model_view_matrix()¶
Return a copy of the model-view matrix.
- Returns:
A 4x4 view matrix.
- Return type:
- gpu.matrix.get_normal_matrix()¶
Return a copy of the normal matrix.
- Returns:
A 3x3 normal matrix.
- Return type:
- gpu.matrix.get_projection_matrix()¶
Return a copy of the projection matrix.
- Returns:
A 4x4 projection matrix.
- Return type:
- gpu.matrix.load_identity()¶
Load an identity matrix into the stack.
- gpu.matrix.load_matrix(matrix)¶
Load a matrix into the stack.
- Parameters:
matrix (
mathutils.Matrix) – A 4x4 matrix.
- gpu.matrix.load_projection_matrix(matrix)¶
Load a projection matrix into the stack.
- Parameters:
matrix (
mathutils.Matrix) – A 4x4 matrix.
- gpu.matrix.multiply_matrix(matrix)¶
Multiply the current stack matrix.
- Parameters:
matrix (
mathutils.Matrix) – A 4x4 matrix.
- gpu.matrix.pop()¶
Remove the last model-view matrix from the stack.
- gpu.matrix.pop_projection()¶
Remove the last projection matrix from the stack.
- gpu.matrix.push()¶
Add to the model-view matrix stack.
- gpu.matrix.push_pop()¶
Context manager to ensure balanced push/pop calls, even in the case of an error.
- gpu.matrix.push_pop_projection()¶
Context manager to ensure balanced push/pop calls, even in the case of an error.
- gpu.matrix.push_projection()¶
Add to the projection matrix stack.
- gpu.matrix.reset()¶
Empty stack and set to identity.
- gpu.matrix.scale(scale)¶
Scale the current stack matrix.
- Parameters:
scale (Sequence[float]) – Scale the current stack matrix with 2 or 3 floats.
- gpu.matrix.scale_uniform(scale)¶
- Parameters:
scale (float) – Scale the current stack matrix.
- gpu.matrix.translate(offset)¶
Scale the current stack matrix.
- Parameters:
offset (Sequence[float]) – Translate the current stack matrix with 2 or 3 floats.