archive/blender-archive
Archived
1
1
Fork 0
Code Pull Requests Packages Activity
This repository has been archived on 2023-10-09. You can view files and clone it, but cannot push or open issues or pull requests.
Files
56bfd3235c62c5fe8ae14d12c975326441f7f655
blender-archive/source/blender/python/mathutils/mathutils_Matrix.h

87 lines
3.3 KiB
C++
Raw Normal View History

Some generic modules from blender 2.4x building with py3k and mostly working. * Mathutils, Geometry, BGL, Mostly working, some //XXX comments for things to fix with py3 python import override (bpy_internal_import.c) so you can import python internal scripts from the BGE and running blender normally.
2009-06-17 20:33:34 +00:00
/*
* ***** BEGIN GPL LICENSE BLOCK *****
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software Foundation,
correct fsf address
2010-02-12 13:34:04 +00:00
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Some generic modules from blender 2.4x building with py3k and mostly working. * Mathutils, Geometry, BGL, Mostly working, some //XXX comments for things to fix with py3 python import override (bpy_internal_import.c) so you can import python internal scripts from the BGE and running blender normally.
2009-06-17 20:33:34 +00:00
*
* The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
* All rights reserved.
*
* The Original Code is: all of this file.
*
* Contributor(s): Joseph Gilbert
*
* ***** END GPL LICENSE BLOCK *****
*
*/
misc doc edits - remove recently added sphinx reference workaround. - tested doxygen, correct some warnings, set tab width and added pymathutils group. - added convenience target 'make doc_doxy'
2011-11-05 01:48:10 +00:00
/** \file blender/python/mathutils/mathutils_Matrix.h
* \ingroup pymathutils
doxygen: blender/python tagged.
2011-02-27 20:10:08 +00:00
*/
unify include guard defines, __$FILENAME__ without the underscores these clogged up the namespace for autocompleation which was annoying.
2012-02-17 18:59:41 +00:00
#ifndef __MATHUTILS_MATRIX_H__
#define __MATHUTILS_MATRIX_H__
Some generic modules from blender 2.4x building with py3k and mostly working. * Mathutils, Geometry, BGL, Mostly working, some //XXX comments for things to fix with py3 python import override (bpy_internal_import.c) so you can import python internal scripts from the BGE and running blender normally.
2009-06-17 20:33:34 +00:00
extern PyTypeObject matrix_Type;
mathtils, convenience attributes added 'row' and 'col', this makes the row/col swap a lot easier to deal with, since now you can still use column access previously... mat[2] = 1, 2, 3 needed to be converted into... mat[0][2] = 1 mat[1][2] = 2 mat[2][2] = 3 but with column access you can do... mat.col[2] = 1, 2, 3 Having 'row' attribute is a bit redundant since direct indexing on a matrix uses row but included for completeness.
2011-12-24 07:03:19 +00:00
extern PyTypeObject matrix_access_Type;
Python API Mathutils support for subclassing Vector, Quat, Euler and Matrix types. Removed C docstrings, prefer to make sure our epydocs are well maintained rather then duplicate, vague doc strings. Will convert scripts to detect missing docs from the BGE.
2009-06-30 00:42:17 +00:00
#define MatrixObject_Check(_v) PyObject_TypeCheck((_v), &matrix_Type)
[#22045] Memory leak in Mathutils.Matrix own fault when adding mathutils callbacks, generic destructor didnt free the matrix accessor array, made the array apart of the matrix struct since its not worth malloc'ing to save at most 16bytes.
2010-04-16 08:17:13 +00:00
#define MATRIX_MAX_DIM 4
Some generic modules from blender 2.4x building with py3k and mostly working. * Mathutils, Geometry, BGL, Mostly working, some //XXX comments for things to fix with py3 python import override (bpy_internal_import.c) so you can import python internal scripts from the BGE and running blender normally.
2009-06-17 20:33:34 +00:00
corrections to some comments
2011-12-19 05:23:52 +00:00
/* matrix[row][col] == MATRIX_ITEM_INDEX(matrix, row, col) */
remove mathutils internal variable for storing pointers to each matrix row, instead use macros to access row/column's. also add an assert so invalid index access will raise an error in debug mode, without this it was quite easy to access invalid memory without meaning to. no functional change.
2011-12-19 03:12:10 +00:00
#ifdef DEBUG
patch [#29662] Modifications to Mathutils Vectors for Consistency with Commit 42752 from Andrew Hale
2011-12-20 05:48:35 +00:00
# define MATRIX_ITEM_ASSERT(_mat, _row, _col) (BLI_assert(_row < (_mat)->num_row && _col < (_mat)->num_col))
remove mathutils internal variable for storing pointers to each matrix row, instead use macros to access row/column's. also add an assert so invalid index access will raise an error in debug mode, without this it was quite easy to access invalid memory without meaning to. no functional change.
2011-12-19 03:12:10 +00:00
#else
corrections to some comments
2011-12-19 05:23:52 +00:00
# define MATRIX_ITEM_ASSERT(_mat, _row, _col) (void)0
remove mathutils internal variable for storing pointers to each matrix row, instead use macros to access row/column's. also add an assert so invalid index access will raise an error in debug mode, without this it was quite easy to access invalid memory without meaning to. no functional change.
2011-12-19 03:12:10 +00:00
#endif
patch [#29662] Modifications to Mathutils Vectors for Consistency with Commit 42752 from Andrew Hale
2011-12-20 05:48:35 +00:00
#define MATRIX_ITEM_INDEX(_mat, _row, _col) (MATRIX_ITEM_ASSERT(_mat, _row, _col),(((_mat)->num_row * (_col)) + (_row)))
rename internal matrix struct member vars to avoid confusion Matrix.contigPtr --> matrix Matrix.row_size --> num_col Matrix.col_size --> num_row
2011-12-20 04:11:23 +00:00
#define MATRIX_ITEM_PTR( _mat, _row, _col) ((_mat)->matrix + MATRIX_ITEM_INDEX(_mat, _row, _col))
#define MATRIX_ITEM( _mat, _row, _col) ((_mat)->matrix [MATRIX_ITEM_INDEX(_mat, _row, _col)])
remove mathutils internal variable for storing pointers to each matrix row, instead use macros to access row/column's. also add an assert so invalid index access will raise an error in debug mode, without this it was quite easy to access invalid memory without meaning to. no functional change.
2011-12-19 03:12:10 +00:00
patch [#29662] Modifications to Mathutils Vectors for Consistency with Commit 42752 from Andrew Hale
2011-12-20 05:48:35 +00:00
#define MATRIX_COL_INDEX(_mat, _col) (MATRIX_ITEM_INDEX(_mat, 0, _col))
#define MATRIX_COL_PTR( _mat, _col) ((_mat)->matrix + MATRIX_COL_INDEX(_mat, _col))
remove mathutils internal variable for storing pointers to each matrix row, instead use macros to access row/column's. also add an assert so invalid index access will raise an error in debug mode, without this it was quite easy to access invalid memory without meaning to. no functional change.
2011-12-19 03:12:10 +00:00
[#22045] Memory leak in Mathutils.Matrix own fault when adding mathutils callbacks, generic destructor didnt free the matrix accessor array, made the array apart of the matrix struct since its not worth malloc'ing to save at most 16bytes.
2010-04-16 08:17:13 +00:00
typedef struct {
rename internal matrix struct member vars to avoid confusion Matrix.contigPtr --> matrix Matrix.row_size --> num_col Matrix.col_size --> num_row
2011-12-20 04:11:23 +00:00
BASE_MATH_MEMBERS(matrix);
unsigned short num_col;
unsigned short num_row;
Some generic modules from blender 2.4x building with py3k and mostly working. * Mathutils, Geometry, BGL, Mostly working, some //XXX comments for things to fix with py3 python import override (bpy_internal_import.c) so you can import python internal scripts from the BGE and running blender normally.
2009-06-17 20:33:34 +00:00
} MatrixObject;
corrections to some comments
2011-12-19 05:23:52 +00:00
/* struct data contains a pointer to the actual data that the
* object uses. It can use either PyMem allocated data (which will
* be stored in py_data) or be a wrapper for data allocated through
* blender (stored in blend_data). This is an either/or struct not both */
Some generic modules from blender 2.4x building with py3k and mostly working. * Mathutils, Geometry, BGL, Mostly working, some //XXX comments for things to fix with py3 python import override (bpy_internal_import.c) so you can import python internal scripts from the BGE and running blender normally.
2009-06-17 20:33:34 +00:00
corrections to some comments
2011-12-19 05:23:52 +00:00
/* prototypes */
formatting edits (120 width max) and remove some redundant casts
2011-11-29 20:22:35 +00:00
PyObject *Matrix_CreatePyObject(float *mat,
rename internal matrix struct member vars to avoid confusion Matrix.contigPtr --> matrix Matrix.row_size --> num_col Matrix.col_size --> num_row
2011-12-20 04:11:23 +00:00
const unsigned short num_col, const unsigned short num_row,
formatting edits (120 width max) and remove some redundant casts
2011-11-29 20:22:35 +00:00
int type, PyTypeObject *base_type);
mathutils get/set function rename + minor changes to matrix functions (no functional changes)
2011-12-24 04:58:01 +00:00
PyObject *Matrix_CreatePyObject_cb(PyObject *user,
const unsigned short num_col, const unsigned short num_row,
code cleanup: not all mathutils callback creation functions tool unsigned char for type & subtype args.
2012-03-17 22:31:57 +00:00
unsigned char cb_type, unsigned char cb_subtype);
PyRNA API support for matrix types as Mathutils matrix (with callbacks) rather then a generic rna sequence of floats. Any 3x3 or 4x4 rna matrix will automatically be returned as a Mathutils matrix. This makes useful stuff like multiplying a vector location by an object matrix possible. ob = bpy.data.scenes[0].objects[0] print (ob.data.verts[0].co * ob.matrix) Also added mathutils matrix types to the BGE GameObject.localOrientation, worldOrientation * MT_Matrix3x3 added getValue3x3 and setValue3x3, assumed a 4x3 float array. * KX_GameObject.cpp convenience functions NodeSetGlobalOrientation, NodeGetLocalOrientation, NodeGetLocalScaling, NodeGetLocalPosition. * 2.5 python api now initializes modules BGL, Mathutils and Geometry * modules py3 PyModuleDef's use PyModuleDef_HEAD_INIT, rather then {}, was making msvc fail to build. * added macros for Vector_ReadCallback, Vector_WriteCallback etc. to check if the callback pointer is set before calling the function.
2009-06-23 13:34:45 +00:00
minor mathutils code cleanup - use mathutils callbacks as unsigned chars everywhere.
2012-03-17 10:46:02 +00:00
extern unsigned char mathutils_matrix_row_cb_index; /* default */
extern unsigned char mathutils_matrix_col_cb_index;
extern unsigned char mathutils_matrix_translation_cb_index;
fix for a bug in mathutils when a vector was accessing a matrix and the matrix size increased, future access too the vector would write past the allocated bounds. now raise an exception.
2011-12-26 00:05:41 +00:00
fix for error with matrix access and negative indices with recent row/col swap.
2011-12-24 06:13:58 +00:00
extern struct Mathutils_Callback mathutils_matrix_row_cb; /* default */
extern struct Mathutils_Callback mathutils_matrix_col_cb;
fix for a bug in mathutils when a vector was accessing a matrix and the matrix size increased, future access too the vector would write past the allocated bounds. now raise an exception.
2011-12-26 00:05:41 +00:00
extern struct Mathutils_Callback mathutils_matrix_translation_cb;
Some generic modules from blender 2.4x building with py3k and mostly working. * Mathutils, Geometry, BGL, Mostly working, some //XXX comments for things to fix with py3 python import override (bpy_internal_import.c) so you can import python internal scripts from the BGE and running blender normally.
2009-06-17 20:33:34 +00:00
mathutils rotate functions for Euler/Quaternion/Matrix/Vector types. each accept Euler/Quaternion/Matrix types. eg: Euler.rotate(Quaternion(axis, angle)) Vector.rotate(Euler((pi/2, 0, 0))) matrix.resize_4x4() and euler.make_compatible() were still returning an instance of themselves, now return None.
2011-02-05 09:57:02 +00:00
void matrix_as_3x3(float mat[3][3], MatrixObject *self);
unify include guard defines, __$FILENAME__ without the underscores these clogged up the namespace for autocompleation which was annoying.
2012-02-17 18:59:41 +00:00
#endif /* __MATHUTILS_MATRIX_H__ */
Copy Permalink