Blender V5.3
mathutils.hh File Reference
#include <Python.h>
#include "BLI_array.hh"
#include "BLI_vector.hh"
#include "mathutils_Color.hh"
#include "mathutils_Euler.hh"
#include "mathutils_Matrix.hh"
#include "mathutils_Quaternion.hh"
#include "mathutils_Vector.hh"

Go to the source code of this file.

Classes

struct  blender::BaseMathObject
struct  blender::Mathutils_Callback

Namespaces

namespace  blender
 BMesh Iterators.

Macros

#define BASE_MATH_NEW(struct_name, root_type, base_type)
#define BASE_MATH_FLAG_DEFAULT   0
#define BASE_MATH_MEMBERS(_data)
#define BaseMathObject_CheckExact(v)
#define BaseMath_CheckCallback(_self)
#define BaseMath_ReadCallback(_self)
#define BaseMath_WriteCallback(_self)
#define BaseMath_ReadIndexCallback(_self, _index)
#define BaseMath_WriteIndexCallback(_self, _index)
#define BaseMath_ReadCallback_ForWrite(_self)
#define BaseMath_ReadIndexCallback_ForWrite(_self, _index)
#define BaseMath_Prepare_ForWrite(_self)
#define BaseMathObject_Prepare_ForHash(_self)
#define BaseMathObject_Prepare_ForResize(_self, error_prefix)
#define BaseMath_Prepare_ForBufferAccess(_self, _view, _flags)
#define MU_ARRAY_ZERO   (1u << 30)
#define MU_ARRAY_SPILL   (1u << 31)
#define MU_ARRAY_FLAGS   (MU_ARRAY_ZERO | MU_ARRAY_SPILL)

Typedefs

using blender::BaseMathCheckFunc = int (*)(BaseMathObject *)
using blender::BaseMathGetFunc = int (*)(BaseMathObject *, int)
using blender::BaseMathSetFunc = int (*)(BaseMathObject *, int)
using blender::BaseMathGetIndexFunc = int (*)(BaseMathObject *, int, int)
using blender::BaseMathSetIndexFunc = int (*)(BaseMathObject *, int, int)

Enumerations

enum  { blender::BASE_MATH_FLAG_IS_WRAP = (1 << 0) , blender::BASE_MATH_FLAG_IS_FROZEN = (1 << 1) , blender::BASE_MATH_FLAG_HAS_BUFFER_VIEW = (1 << 2) }

Functions

PyObject * blender::_BaseMathObject_new_impl (PyTypeObject *root_type, PyTypeObject *base_type)
PyObject * blender::BaseMathObject_owner_get (BaseMathObject *self, void *)
PyObject * blender::BaseMathObject_is_wrapped_get (BaseMathObject *self, void *)
PyObject * blender::BaseMathObject_is_frozen_get (BaseMathObject *self, void *)
PyObject * blender::BaseMathObject_is_valid_get (BaseMathObject *self, void *)
PyObject * blender::BaseMathObject_freeze (BaseMathObject *self)
int blender::BaseMathObject_traverse (BaseMathObject *self, visitproc visit, void *arg)
int blender::BaseMathObject_clear (BaseMathObject *self)
void blender::BaseMathObject_dealloc (BaseMathObject *self)
int blender::BaseMathObject_is_gc (BaseMathObject *self)
PyMODINIT_FUNC blender::PyInit_mathutils ()
int blender::EXPP_FloatsAreEqual (float af, float bf, int maxDiff)
int blender::EXPP_VectorsAreEqual (const float *vecA, const float *vecB, int size, int floatSteps)
uchar blender::Mathutils_RegisterCallback (Mathutils_Callback *cb)
int blender::_BaseMathObject_CheckCallback (BaseMathObject *self)
int blender::_BaseMathObject_ReadCallback (BaseMathObject *self)
int blender::_BaseMathObject_WriteCallback (BaseMathObject *self)
int blender::_BaseMathObject_ReadIndexCallback (BaseMathObject *self, int index)
int blender::_BaseMathObject_WriteIndexCallback (BaseMathObject *self, int index)
int blender::_BaseMathObject_ResizeOkOrRaiseExc (BaseMathObject *self, const char *error_prefix)
int blender::_BaseMathObject_RaiseBufferViewExc (BaseMathObject *self, Py_buffer *view, int flags)
void blender::_BaseMathObject_RaiseFrozenExc (const BaseMathObject *self)
void blender::_BaseMathObject_RaiseNotFrozenExc (const BaseMathObject *self)
int blender::mathutils_array_parse (float *array, int array_num_min, int array_num_max, PyObject *value, const char *error_prefix)
int blender::mathutils_array_parse_alloc (float **array, int array_num_min, PyObject *value, const char *error_prefix)
int blender::mathutils_array_parse_alloc_v (float **array, int array_dim, PyObject *value, const char *error_prefix)
int blender::mathutils_int_array_parse (int *array, int array_dim, PyObject *value, const char *error_prefix)
int blender::mathutils_array_parse_alloc_vi (int **array, int array_dim, PyObject *value, const char *error_prefix)
bool blender::mathutils_array_parse_alloc_viseq (PyObject *value, const char *error_prefix, Array< int > &r_offsets, Array< int > &r_data)
int blender::mathutils_any_to_rotmat (float rmat[3][3], PyObject *value, const char *error_prefix)
bool blender::mathutils_slice_is_subset (Py_ssize_t start, Py_ssize_t step, Py_ssize_t slice_length, Py_ssize_t array_num)
Py_hash_t blender::mathutils_array_hash (const float *array, size_t array_len)
int blender::column_vector_multiplication (float r_vec[4], VectorObject *vec, MatrixObject *mat)
PyObject * blender::mathutils_dynstr_to_py (DynStr *ds)

Macro Definition Documentation

◆ BASE_MATH_FLAG_DEFAULT

◆ BASE_MATH_MEMBERS

#define BASE_MATH_MEMBERS ( _data)
Value:
\
PyObject_HEAD \
float *_data; \ \
PyObject *cb_user; \ \
unsigned char cb_type; \ \
unsigned char cb_subtype; \ \
unsigned char flag

Definition at line 56 of file mathutils.hh.

◆ BASE_MATH_NEW

◆ BaseMath_CheckCallback

#define BaseMath_CheckCallback ( _self)
Value:
(((_self)->cb_user ? _BaseMathObject_CheckCallback((BaseMathObject *)_self) : 0))

Definition at line 145 of file mathutils.hh.

Referenced by blender::BaseMathObject_is_valid_get().

◆ BaseMath_Prepare_ForBufferAccess

#define BaseMath_Prepare_ForBufferAccess ( _self,
_view,
_flags )
Value:
_BaseMathObject_RaiseBufferViewExc((BaseMathObject *)_self, _view, _flags)

Ensure #BASE_MATH_FLAG_HAS_BUFFER_VIEW is supported.

Parameters
_viewThe view argument forwarded from #PyBufferProcs::bf_getbuffer.
_flagsThe flags argument forwarded from #PyBufferProcs::bf_getbuffer.
Returns
-1 and set an exception if the vector _self does not support buffer access.

Definition at line 189 of file mathutils.hh.

Referenced by blender::Color_getbuffer(), blender::Euler_getbuffer(), blender::Matrix_getbuffer(), blender::Quaternion_getbuffer(), and blender::Vector_getbuffer().

◆ BaseMath_Prepare_ForWrite

◆ BaseMath_ReadCallback

#define BaseMath_ReadCallback ( _self)
Value:
(((_self)->cb_user ? _BaseMathObject_ReadCallback((BaseMathObject *)_self) : 0))

Definition at line 147 of file mathutils.hh.

Referenced by blender::bpy_bmesh_transform(), blender::C_Matrix_LocRotScale(), blender::Color_add(), blender::Color_channel_hsv_get(), blender::Color_copy(), blender::Color_div(), blender::Color_getbuffer(), blender::Color_hash(), blender::Color_hsv_get(), blender::Color_iadd(), blender::Color_isub(), blender::Color_mul(), blender::Color_neg(), blender::Color_repr(), blender::Color_richcmpr(), blender::Color_slice(), blender::Color_str(), blender::Color_sub(), blender::Euler_copy(), blender::Euler_getbuffer(), blender::Euler_hash(), blender::Euler_order_get(), blender::Euler_repr(), blender::Euler_richcmpr(), blender::Euler_slice(), blender::Euler_str(), blender::Euler_to_matrix(), blender::Euler_to_quaternion(), float_array_from_PyObject(), blender::mathutils_any_to_rotmat(), blender::mathutils_array_parse(), blender::mathutils_array_parse_alloc(), blender::mathutils_matrix_col_check(), blender::mathutils_matrix_col_get(), blender::mathutils_matrix_col_get_index(), blender::mathutils_matrix_row_check(), blender::mathutils_matrix_row_get(), blender::mathutils_matrix_row_get_index(), blender::mathutils_matrix_translation_check(), blender::mathutils_matrix_translation_get(), blender::mathutils_matrix_translation_get_index(), blender::Matrix_add(), blender::Matrix_copy(), blender::Matrix_decompose(), blender::Matrix_determinant(), blender::Matrix_getbuffer(), blender::Matrix_hash(), blender::Matrix_imatmul(), blender::Matrix_imul(), blender::Matrix_invert(), blender::Matrix_inverted(), blender::Matrix_inverted_safe(), blender::Matrix_is_identity_get(), blender::Matrix_is_negative_get(), blender::Matrix_is_orthogonal_axis_vectors_get(), blender::Matrix_is_orthogonal_get(), blender::Matrix_item_col(), blender::Matrix_item_row(), blender::Matrix_lerp(), blender::Matrix_matmul(), blender::Matrix_median_scale_get(), blender::Matrix_mul(), blender::Matrix_ParseCheck(), blender::Matrix_repr(), blender::Matrix_richcmpr(), blender::Matrix_slice(), blender::Matrix_str(), blender::Matrix_sub(), blender::Matrix_to_2x2(), blender::Matrix_to_3x3(), blender::Matrix_to_4x4(), blender::Matrix_to_euler(), blender::Matrix_to_quaternion(), blender::Matrix_to_scale(), blender::Matrix_to_translation(), blender::Matrix_translation_get(), blender::pygpu_shader_uniform_float(), blender::Quaternion_add(), blender::Quaternion_angle_get(), blender::Quaternion_axis_vector_get(), blender::Quaternion_copy(), blender::Quaternion_cross(), blender::Quaternion_dot(), blender::Quaternion_getbuffer(), blender::Quaternion_hash(), blender::Quaternion_imatmul(), blender::Quaternion_imul(), blender::Quaternion_magnitude_get(), blender::Quaternion_matmul(), blender::Quaternion_mul(), blender::Quaternion_neg(), blender::Quaternion_repr(), blender::Quaternion_richcmpr(), blender::Quaternion_rotation_difference(), blender::Quaternion_slerp(), blender::Quaternion_slice(), blender::Quaternion_str(), blender::Quaternion_sub(), blender::Quaternion_to_axis_angle(), blender::Quaternion_to_euler(), blender::Quaternion_to_exponential_map(), blender::Quaternion_to_matrix(), blender::Quaternion_to_swing_twist(), blender::row_vector_multiplication(), blender::validate_array(), Vec2f_ptr_from_Vector(), Vec3f_ptr_from_Color(), Vec3f_ptr_from_Vector(), Vec3r_ptr_from_Color(), Vec3r_ptr_from_Vector(), blender::Vector_add(), blender::Vector_angle(), blender::Vector_angle_signed(), blender::Vector_copy(), blender::Vector_cross(), blender::Vector_div(), blender::Vector_dot(), blender::Vector_getbuffer(), blender::Vector_hash(), blender::Vector_iadd(), blender::Vector_imul(), blender::Vector_isub(), blender::Vector_length_get(), blender::Vector_length_squared_get(), blender::Vector_lerp(), blender::Vector_matmul(), blender::Vector_mul(), blender::Vector_neg(), blender::Vector_negate(), blender::Vector_orthogonal(), blender::Vector_project(), blender::Vector_reflect(), blender::Vector_repr(), blender::Vector_resized(), blender::Vector_richcmpr(), blender::Vector_rotation_difference(), blender::Vector_slerp(), blender::Vector_slice(), blender::Vector_str(), blender::Vector_sub(), blender::Vector_swizzle_get(), blender::Vector_to_2d(), blender::Vector_to_3d(), blender::Vector_to_4d(), blender::Vector_to_track_quat(), and blender::Vector_to_tuple().

◆ BaseMath_ReadCallback_ForWrite

#define BaseMath_ReadCallback_ForWrite ( _self)
Value:
(UNLIKELY((_self)->flag & BASE_MATH_FLAG_IS_FROZEN) ? \
(_BaseMathObject_RaiseFrozenExc((BaseMathObject *)_self), -1) : \
#define BaseMath_ReadCallback(_self)
Definition mathutils.hh:147

Definition at line 157 of file mathutils.hh.

Referenced by blender::Color_ass_slice(), blender::Color_channel_hsv_set(), blender::Color_iadd(), blender::Color_idiv(), blender::Color_imul(), blender::Color_isub(), blender::Euler_ass_slice(), blender::Euler_make_compatible(), blender::Euler_rotate(), blender::Euler_rotate_axis(), blender::mathutils_matrix_col_set(), blender::mathutils_matrix_col_set_index(), blender::mathutils_matrix_row_set(), blender::mathutils_matrix_row_set_index(), blender::mathutils_matrix_translation_set(), blender::mathutils_matrix_translation_set_index(), blender::Matrix_adjugate(), blender::Matrix_ass_item_col(), blender::Matrix_ass_item_row(), blender::Matrix_ass_slice(), blender::Matrix_identity(), blender::Matrix_invert(), blender::Matrix_invert_safe(), blender::Matrix_inverted_noargs(), blender::Matrix_normalize(), blender::Matrix_rotate(), blender::Matrix_translation_set(), blender::Matrix_transpose(), blender::MatrixAccess_ass_slice(), blender::Quaternion_angle_set(), blender::Quaternion_ass_slice(), blender::Quaternion_axis_vector_set(), blender::Quaternion_conjugate(), blender::Quaternion_identity(), blender::Quaternion_invert(), blender::Quaternion_make_compatible(), blender::Quaternion_negate(), blender::Quaternion_normalize(), blender::Quaternion_rotate(), blender::Vector_ass_slice(), blender::Vector_iadd(), blender::Vector_idiv(), blender::Vector_imul(), blender::Vector_isub(), blender::Vector_length_set(), blender::Vector_normalize(), blender::Vector_rotate(), and blender::Vector_swizzle_set().

◆ BaseMath_ReadIndexCallback

#define BaseMath_ReadIndexCallback ( _self,
_index )
Value:
(((_self)->cb_user ? _BaseMathObject_ReadIndexCallback((BaseMathObject *)_self, _index) : 0))

Definition at line 151 of file mathutils.hh.

Referenced by blender::Color_item(), blender::Euler_item(), blender::Quaternion_item(), and blender::vector_item_internal().

◆ BaseMath_ReadIndexCallback_ForWrite

#define BaseMath_ReadIndexCallback_ForWrite ( _self,
_index )
Value:
(UNLIKELY((_self)->flag & BASE_MATH_FLAG_IS_FROZEN) ? \
(_BaseMathObject_RaiseFrozenExc((BaseMathObject *)_self), -1) : \
(BaseMath_ReadIndexCallback(_self, _index)))
#define BaseMath_ReadIndexCallback(_self, _index)
Definition mathutils.hh:151

Definition at line 162 of file mathutils.hh.

◆ BaseMath_WriteCallback

#define BaseMath_WriteCallback ( _self)
Value:
(((_self)->cb_user ? _BaseMathObject_WriteCallback((BaseMathObject *)_self) : 0))

Definition at line 149 of file mathutils.hh.

Referenced by blender::_BaseMathObject_RaiseBufferViewExc(), blender::Color_ass_slice(), blender::Color_channel_hsv_set(), blender::Color_hsv_set(), blender::Color_iadd(), blender::Color_idiv(), blender::Color_imul(), blender::Color_isub(), blender::Color_releasebuffer(), blender::Euler_ass_slice(), blender::Euler_make_compatible(), blender::Euler_order_set(), blender::Euler_releasebuffer(), blender::Euler_rotate(), blender::Euler_rotate_axis(), blender::Euler_zero(), blender::mathutils_matrix_col_set(), blender::mathutils_matrix_col_set_index(), blender::mathutils_matrix_row_set(), blender::mathutils_matrix_row_set_index(), blender::mathutils_matrix_translation_set(), blender::mathutils_matrix_translation_set_index(), blender::Matrix_adjugate(), blender::Matrix_ass_item_col(), blender::Matrix_ass_item_row(), blender::Matrix_ass_slice(), blender::Matrix_identity(), blender::Matrix_imatmul(), blender::Matrix_imul(), blender::Matrix_invert(), blender::Matrix_invert_safe(), blender::Matrix_inverted_noargs(), blender::Matrix_normalize(), blender::Matrix_releasebuffer(), blender::Matrix_rotate(), blender::Matrix_translation_set(), blender::Matrix_transpose(), blender::Matrix_zero(), blender::MatrixAccess_ass_slice(), blender::Quaternion_angle_set(), blender::Quaternion_ass_slice(), blender::Quaternion_axis_vector_set(), blender::Quaternion_conjugate(), blender::Quaternion_identity(), blender::Quaternion_imatmul(), blender::Quaternion_imul(), blender::Quaternion_invert(), blender::Quaternion_make_compatible(), blender::Quaternion_negate(), blender::Quaternion_normalize(), blender::Quaternion_releasebuffer(), blender::Quaternion_rotate(), blender::Vector_ass_slice(), blender::Vector_iadd(), blender::Vector_idiv(), blender::Vector_imul(), blender::Vector_isub(), blender::Vector_length_set(), blender::Vector_negate(), blender::Vector_normalize(), blender::Vector_releasebuffer(), blender::Vector_rotate(), blender::Vector_swizzle_set(), and blender::Vector_zero().

◆ BaseMath_WriteIndexCallback

#define BaseMath_WriteIndexCallback ( _self,
_index )
Value:
(((_self)->cb_user ? _BaseMathObject_WriteIndexCallback((BaseMathObject *)_self, _index) : 0))

Definition at line 153 of file mathutils.hh.

Referenced by blender::Color_ass_item(), blender::Euler_ass_item(), blender::Quaternion_ass_item(), and blender::vector_ass_item_internal().

◆ BaseMathObject_CheckExact

#define BaseMathObject_CheckExact ( v)
Value:
(Py_TYPE(v)->tp_dealloc == (destructor)BaseMathObject_dealloc)

Definition at line 85 of file mathutils.hh.

Referenced by blender::BaseMathObject_dealloc(), and blender::py_msgbus_rna_key_from_py().

◆ BaseMathObject_Prepare_ForHash

#define BaseMathObject_Prepare_ForHash ( _self)
Value:
(UNLIKELY(((_self)->flag & BASE_MATH_FLAG_IS_FROZEN) == 0) ? \
(_BaseMathObject_RaiseNotFrozenExc((BaseMathObject *)_self), -1) : \
0)

Definition at line 172 of file mathutils.hh.

Referenced by blender::Color_hash(), blender::Euler_hash(), blender::Matrix_hash(), blender::Quaternion_hash(), and blender::Vector_hash().

◆ BaseMathObject_Prepare_ForResize

#define BaseMathObject_Prepare_ForResize ( _self,
error_prefix )
Value:
_BaseMathObject_ResizeOkOrRaiseExc((BaseMathObject *)_self, error_prefix)

Helper to de-duplicate checks for in-place resizing.

Returns
-1 and set an exception if the vector _self cannot be resized.

Definition at line 180 of file mathutils.hh.

Referenced by blender::Matrix_resize_4x4(), blender::Vector_resize(), blender::Vector_resize_2d(), blender::Vector_resize_3d(), and blender::Vector_resize_4d().

◆ MU_ARRAY_FLAGS

#define MU_ARRAY_FLAGS   (MU_ARRAY_ZERO | MU_ARRAY_SPILL)

◆ MU_ARRAY_SPILL

◆ MU_ARRAY_ZERO