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()
Empty stack and set to identity.
- 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 of 2 or 3 floats) – Scale the current stack matrix.
- 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 of 2 or 3 floats) – Translate the current stack matrix.