Welcome to mirror list, hosted at ThFree Co, Russian Federation.

git.blender.org/blender.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJoseph Gilbert <ascotan@gmail.com>2004-02-29 16:20:34 +0300
committerJoseph Gilbert <ascotan@gmail.com>2004-02-29 16:20:34 +0300
commit8f3a9815baafb6f8fe00659cf6390a8c4092ef8b (patch)
tree9a69af7bffd6fd0d7da8e998d74a37dc273628a2 /source/blender/python/api2_2x/Mathutils.h
parent2255ac3b19ec3b2aa0e884ad5960f34c9c0efa23 (diff)
Mathutils library for the python API
- support for quaternions, euler, vector, matrix operations. - euler supports unique rotation calculation - new matrix memory construction and internal functions - quaternion slerp and diff calculation - 2d, 3d, 4d vector construction and handling - full conversion support between types - update to object/window to reflect to matrix type - update to types/blender/module to reflect new module
Diffstat (limited to 'source/blender/python/api2_2x/Mathutils.h')
-rw-r--r--source/blender/python/api2_2x/Mathutils.h205
1 files changed, 205 insertions, 0 deletions
diff --git a/source/blender/python/api2_2x/Mathutils.h b/source/blender/python/api2_2x/Mathutils.h
new file mode 100644
index 00000000000..1d4dd544dea
--- /dev/null
+++ b/source/blender/python/api2_2x/Mathutils.h
@@ -0,0 +1,205 @@
+/* * ***** BEGIN GPL/BL DUAL 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. The Blender
+ * Foundation also sells licenses for use in proprietary software under
+ * the Blender License. See http://www.blender.org/BL/ for information
+ * about this.
+ *
+ * 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,
+ * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ *
+ * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
+ * All rights reserved.
+ *
+ * This is a new part of Blender.
+ *
+ * Contributor(s): Joseph Gilbert
+ *
+ * ***** END GPL/BL DUAL LICENSE BLOCK *****
+*/
+
+#ifndef EXPP_Mathutils_H
+#define EXPP_Mathutils_H
+
+#include <Python.h>
+#include <BKE_main.h>
+#include <BKE_global.h>
+#include <BKE_library.h>
+#include <BKE_utildefines.h>
+#include <BLI_blenlib.h>
+#include <BLI_arithb.h>
+#include <PIL_time.h>
+#include <BLI_rand.h>
+#include <math.h>
+#include "vector.h"
+#include "euler.h"
+#include "quat.h"
+#include "matrix.h"
+#include "blendef.h"
+#include "mydevice.h"
+#include "constant.h"
+#include "gen_utils.h"
+#include "modules.h"
+#include "Types.h"
+
+
+/*****************************************************************************/
+// Python API function prototypes for the Mathutils module.
+/*****************************************************************************/
+static PyObject *M_Mathutils_Rand (PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_Vector(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_CrossVecs(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_DotVecs (PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_AngleBetweenVecs(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_MidpointVecs(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_VecMultMat(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_ProjectVecs(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_CopyVec(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_Matrix(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_RotationMatrix(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_ScaleMatrix(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_OrthoProjectionMatrix(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_ShearMatrix(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_TranslationMatrix(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_MatMultVec(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_CopyMat(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_Quaternion(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_CrossQuats(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_DotQuats(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_CopyQuat(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_DifferenceQuats(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_Slerp(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_Euler(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_CopyEuler(PyObject *self, PyObject *args);
+static PyObject *M_Mathutils_RotateEuler(PyObject *self, PyObject *args);
+
+/*****************************************************************************/
+// The following string definitions are used for documentation strings.
+// In Python these will be written to the console when doing a
+// Blender.Mathutils.__doc__ Mathutils Module strings */
+/*****************************************************************************/
+static char M_Mathutils_doc[] =
+"The Blender Mathutils module\n\n";
+static char M_Mathutils_Vector_doc[] =
+"() - create a new vector object from a list of floats";
+static char M_Mathutils_Matrix_doc[] =
+"() - create a new matrix object from a list of floats";
+static char M_Mathutils_Quaternion_doc[] =
+"() - create a quaternion from a list or an axis of rotation and an angle";
+static char M_Mathutils_Euler_doc[] =
+"() - create and return a new euler object";
+static char M_Mathutils_Rand_doc[] =
+"() - return a random number";
+static char M_Mathutils_CrossVecs_doc[] =
+"() - returns a vector perpedicular to the 2 vectors crossed";
+static char M_Mathutils_CopyVec_doc[] =
+"() - create a copy of vector";
+static char M_Mathutils_DotVecs_doc[] =
+"() - return the dot product of two vectors";
+static char M_Mathutils_AngleBetweenVecs_doc[] =
+"() - returns the angle between two vectors in degrees";
+static char M_Mathutils_MidpointVecs_doc[] =
+"() - return the vector to the midpoint between two vectors";
+static char M_Mathutils_MatMultVec_doc[] =
+"() - multiplies a matrix by a column vector";
+static char M_Mathutils_VecMultMat_doc[] =
+"() - multiplies a row vector by a matrix";
+static char M_Mathutils_ProjectVecs_doc[] =
+"() - returns the projection vector from the projection of vecA onto vecB";
+static char M_Mathutils_RotationMatrix_doc[] =
+"() - construct a rotation matrix from an angle and axis of rotation";
+static char M_Mathutils_ScaleMatrix_doc[] =
+"() - construct a scaling matrix from a scaling factor";
+static char M_Mathutils_OrthoProjectionMatrix_doc[] =
+"() - construct a orthographic projection matrix from a selected plane";
+static char M_Mathutils_ShearMatrix_doc[] =
+"() - construct a shearing matrix from a plane of shear and a shear factor";
+static char M_Mathutils_CopyMat_doc[] =
+"() - create a copy of a matrix";
+static char M_Mathutils_TranslationMatrix_doc[] =
+"() - create a translation matrix from a vector";
+static char M_Mathutils_CopyQuat_doc[] =
+"() - copy quatB to quatA";
+static char M_Mathutils_CopyEuler_doc[] =
+"() - copy eulB to eultA";
+static char M_Mathutils_CrossQuats_doc[] =
+"() - return the mutliplication of two quaternions";
+static char M_Mathutils_DotQuats_doc[] =
+"() - return the dot product of two quaternions";
+static char M_Mathutils_Slerp_doc[] =
+"() - returns the interpolation between two quaternions";
+static char M_Mathutils_DifferenceQuats_doc[] =
+"() - return the angular displacment difference between two quats";
+static char M_Mathutils_RotateEuler_doc[] =
+"() - rotate euler by an axis and angle";
+
+
+/*****************************************************************************/
+// Python method structure definition for Blender.Mathutils module:
+/*****************************************************************************/
+struct PyMethodDef M_Mathutils_methods[] = {
+ {"Rand",(PyCFunction)M_Mathutils_Rand, METH_VARARGS,
+ M_Mathutils_Rand_doc},
+ {"Vector",(PyCFunction)M_Mathutils_Vector, METH_VARARGS,
+ M_Mathutils_Vector_doc},
+ {"CrossVecs",(PyCFunction)M_Mathutils_CrossVecs, METH_VARARGS,
+ M_Mathutils_CrossVecs_doc},
+ {"DotVecs",(PyCFunction)M_Mathutils_DotVecs, METH_VARARGS,
+ M_Mathutils_DotVecs_doc},
+ {"AngleBetweenVecs",(PyCFunction)M_Mathutils_AngleBetweenVecs, METH_VARARGS,
+ M_Mathutils_AngleBetweenVecs_doc},
+ {"MidpointVecs",(PyCFunction)M_Mathutils_MidpointVecs, METH_VARARGS,
+ M_Mathutils_MidpointVecs_doc},
+ {"VecMultMat",(PyCFunction)M_Mathutils_VecMultMat, METH_VARARGS,
+ M_Mathutils_VecMultMat_doc},
+ {"ProjectVecs",(PyCFunction)M_Mathutils_ProjectVecs, METH_VARARGS,
+ M_Mathutils_ProjectVecs_doc},
+ {"CopyVec",(PyCFunction)M_Mathutils_CopyVec, METH_VARARGS,
+ M_Mathutils_CopyVec_doc},
+ {"Matrix",(PyCFunction)M_Mathutils_Matrix, METH_VARARGS,
+ M_Mathutils_Matrix_doc},
+ {"RotationMatrix",(PyCFunction)M_Mathutils_RotationMatrix, METH_VARARGS,
+ M_Mathutils_RotationMatrix_doc},
+ {"ScaleMatrix",(PyCFunction)M_Mathutils_ScaleMatrix, METH_VARARGS,
+ M_Mathutils_ScaleMatrix_doc},
+ {"ShearMatrix",(PyCFunction)M_Mathutils_ShearMatrix, METH_VARARGS,
+ M_Mathutils_ShearMatrix_doc},
+ {"TranslationMatrix",(PyCFunction)M_Mathutils_TranslationMatrix, METH_VARARGS,
+ M_Mathutils_TranslationMatrix_doc},
+ {"CopyMat",(PyCFunction)M_Mathutils_CopyMat, METH_VARARGS,
+ M_Mathutils_CopyMat_doc},
+ {"OrthoProjectionMatrix",(PyCFunction)M_Mathutils_OrthoProjectionMatrix, METH_VARARGS,
+ M_Mathutils_OrthoProjectionMatrix_doc},
+ {"MatMultVec",(PyCFunction)M_Mathutils_MatMultVec, METH_VARARGS,
+ M_Mathutils_MatMultVec_doc},
+ {"Quaternion",(PyCFunction)M_Mathutils_Quaternion, METH_VARARGS,
+ M_Mathutils_Quaternion_doc},
+ {"CopyQuat",(PyCFunction)M_Mathutils_CopyQuat, METH_VARARGS,
+ M_Mathutils_CopyQuat_doc},
+ {"CrossQuats",(PyCFunction)M_Mathutils_CrossQuats, METH_VARARGS,
+ M_Mathutils_CrossQuats_doc},
+ {"DotQuats",(PyCFunction)M_Mathutils_DotQuats, METH_VARARGS,
+ M_Mathutils_DotQuats_doc},
+ {"DifferenceQuats",(PyCFunction)M_Mathutils_DifferenceQuats, METH_VARARGS,
+ M_Mathutils_DifferenceQuats_doc},
+ {"Slerp",(PyCFunction)M_Mathutils_Slerp, METH_VARARGS,
+ M_Mathutils_Slerp_doc},
+ {"Euler",(PyCFunction)M_Mathutils_Euler, METH_VARARGS,
+ M_Mathutils_Euler_doc},
+ {"CopyEuler",(PyCFunction)M_Mathutils_CopyEuler, METH_VARARGS,
+ M_Mathutils_CopyEuler_doc},
+ {"RotateEuler",(PyCFunction)M_Mathutils_RotateEuler, METH_VARARGS,
+ M_Mathutils_RotateEuler_doc},
+ {NULL, NULL, 0, NULL}
+};
+
+#endif /* EXPP_Mathutils_H */