| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | /**
 | 
					
						
							|  |  |  |  * $Id$ | 
					
						
							|  |  |  |  * | 
					
						
							| 
									
										
										
										
											2008-04-16 22:40:48 +00:00
										 |  |  |  * ***** BEGIN GPL LICENSE BLOCK ***** | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  |  * | 
					
						
							|  |  |  |  * 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 | 
					
						
							| 
									
										
										
										
											2008-04-16 22:40:48 +00:00
										 |  |  |  * of the License, or (at your option) any later version. | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  |  * | 
					
						
							|  |  |  |  * 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. | 
					
						
							|  |  |  |  * | 
					
						
							|  |  |  |  * The Original Code is: all of this file. | 
					
						
							|  |  |  |  * | 
					
						
							|  |  |  |  * Contributor(s): none yet. | 
					
						
							|  |  |  |  * | 
					
						
							| 
									
										
										
										
											2008-04-16 22:40:48 +00:00
										 |  |  |  * ***** END GPL LICENSE BLOCK ***** | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  |  */ | 
					
						
							| 
									
										
										
										
											2002-11-25 11:16:17 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | #ifndef NO_EXP_PYTHON_EMBEDDING
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #ifndef _adr_py_lib_h_				// only process once,
 | 
					
						
							|  |  |  | #define _adr_py_lib_h_				// even if multiply included
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #ifndef __cplusplus				// c++ only
 | 
					
						
							|  |  |  | #error Must be compiled with C++
 | 
					
						
							|  |  |  | #endif
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #include "KX_Python.h"
 | 
					
						
							| 
									
										
										
										
											2004-05-16 13:05:15 +00:00
										 |  |  | #include "STR_String.h"
 | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | /*------------------------------
 | 
					
						
							|  |  |  |  * Python defines | 
					
						
							|  |  |  | ------------------------------*/ | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-09-06 14:13:31 +00:00
										 |  |  | /*
 | 
					
						
							|  |  |  |    Py_RETURN_NONE | 
					
						
							|  |  |  |    Python 2.4 macro. | 
					
						
							|  |  |  |    defined here until we switch to 2.4 | 
					
						
							|  |  |  |    also in api2_2x/gen_utils.h  | 
					
						
							|  |  |  | */ | 
					
						
							|  |  |  | #ifndef Py_RETURN_NONE
 | 
					
						
							|  |  |  | #define Py_RETURN_NONE  return Py_BuildValue("O", Py_None)
 | 
					
						
							|  |  |  | #endif
 | 
					
						
							|  |  |  | #ifndef Py_RETURN_FALSE
 | 
					
						
							|  |  |  | #define Py_RETURN_FALSE  return PyBool_FromLong(0)
 | 
					
						
							|  |  |  | #endif
 | 
					
						
							|  |  |  | #ifndef Py_RETURN_TRUE
 | 
					
						
							|  |  |  | #define Py_RETURN_TRUE  return PyBool_FromLong(1)
 | 
					
						
							|  |  |  | #endif
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /*  for pre Py 2.5 */ | 
					
						
							|  |  |  | #if PY_VERSION_HEX < 0x02050000
 | 
					
						
							|  |  |  | typedef int Py_ssize_t; | 
					
						
							|  |  |  | #define PY_SSIZE_T_MAX INT_MAX
 | 
					
						
							|  |  |  | #define PY_SSIZE_T_MIN INT_MIN
 | 
					
						
							| 
									
										
										
										
											2008-10-02 00:22:28 +00:00
										 |  |  | #define PY_METHODCHAR char *
 | 
					
						
							| 
									
										
										
										
											2008-09-06 14:13:31 +00:00
										 |  |  | #else
 | 
					
						
							|  |  |  | /* Py 2.5 and later */ | 
					
						
							|  |  |  | #define  intargfunc  ssizeargfunc
 | 
					
						
							|  |  |  | #define intintargfunc  ssizessizeargfunc
 | 
					
						
							| 
									
										
										
										
											2008-10-02 00:22:28 +00:00
										 |  |  | #define PY_METHODCHAR const char *
 | 
					
						
							| 
									
										
										
										
											2008-09-06 14:13:31 +00:00
										 |  |  | #endif
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-09-20 11:08:35 +00:00
										 |  |  | static inline void Py_Fatal(const char *M) { | 
					
						
							| 
									
										
										
										
											2009-02-25 03:26:02 +00:00
										 |  |  | 	fprintf(stderr, "%s\n", M); | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | 	exit(-1); | 
					
						
							|  |  |  | }; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 								// This must be the first line of each 
 | 
					
						
							|  |  |  | 								// PyC++ class
 | 
					
						
							|  |  |  | #define Py_Header \
 | 
					
						
							|  |  |  |  public: \ | 
					
						
							|  |  |  |   static PyTypeObject   Type; \ | 
					
						
							|  |  |  |   static PyMethodDef    Methods[]; \ | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  |   static PyAttributeDef Attributes[]; \ | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  |   static PyParentObject Parents[]; \ | 
					
						
							|  |  |  |   virtual PyTypeObject *GetType(void) {return &Type;}; \ | 
					
						
							|  |  |  |   virtual PyParentObject *GetParents(void) {return Parents;} | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-07-08 17:57:31 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-02-26 09:04:06 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | 								// This defines the _getattr_up macro
 | 
					
						
							|  |  |  | 								// which allows attribute and method calls
 | 
					
						
							|  |  |  | 								// to be properly passed up the hierarchy.
 | 
					
						
							|  |  |  | #define _getattr_up(Parent) \
 | 
					
						
							| 
									
										
										
										
											2009-02-26 09:04:06 +00:00
										 |  |  | 	PyObject *rvalue = Py_FindMethod(Methods, this, attr); \ | 
					
						
							|  |  |  | 	 \ | 
					
						
							|  |  |  | 	if (rvalue == NULL) { \ | 
					
						
							|  |  |  | 		PyErr_Clear(); \ | 
					
						
							|  |  |  | 		rvalue = Parent::_getattr(attr); \ | 
					
						
							| 
									
										
										
										
											2008-07-08 17:57:31 +00:00
										 |  |  | 	} \ | 
					
						
							| 
									
										
										
										
											2009-02-26 09:04:06 +00:00
										 |  |  | 	if ((rvalue == NULL) && !strcmp(attr, "__dict__")) {\ | 
					
						
							|  |  |  | 		PyErr_Clear(); \ | 
					
						
							|  |  |  | 		rvalue = _getattr_dict(Parent::_getattr(attr), Methods, Attributes); \ | 
					
						
							|  |  |  | 	} \ | 
					
						
							|  |  |  | 	return rvalue; \ | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-07 11:03:12 +00:00
										 |  |  | /**
 | 
					
						
							|  |  |  |  * These macros are helpfull when embedding Python routines. The second | 
					
						
							|  |  |  |  * macro is one that also requires a documentation string | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | #define KX_PYMETHOD(class_name, method_name)			\
 | 
					
						
							|  |  |  | 	PyObject* Py##method_name(PyObject* self, PyObject* args, PyObject* kwds); \ | 
					
						
							|  |  |  | 	static PyObject* sPy##method_name( PyObject* self, PyObject* args, PyObject* kwds) { \ | 
					
						
							|  |  |  | 		return ((class_name*) self)->Py##method_name(self, args, kwds);		\ | 
					
						
							|  |  |  | 	}; \ | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-08-27 03:34:53 +00:00
										 |  |  | #define KX_PYMETHOD_VARARGS(class_name, method_name)			\
 | 
					
						
							|  |  |  | 	PyObject* Py##method_name(PyObject* self, PyObject* args); \ | 
					
						
							|  |  |  | 	static PyObject* sPy##method_name( PyObject* self, PyObject* args) { \ | 
					
						
							|  |  |  | 		return ((class_name*) self)->Py##method_name(self, args);		\ | 
					
						
							|  |  |  | 	}; \ | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-07-04 00:05:50 +00:00
										 |  |  | #define KX_PYMETHOD_NOARGS(class_name, method_name)			\
 | 
					
						
							|  |  |  | 	PyObject* Py##method_name(PyObject* self); \ | 
					
						
							|  |  |  | 	static PyObject* sPy##method_name( PyObject* self) { \ | 
					
						
							|  |  |  | 		return ((class_name*) self)->Py##method_name(self);		\ | 
					
						
							|  |  |  | 	}; \ | 
					
						
							|  |  |  | 	 | 
					
						
							|  |  |  | #define KX_PYMETHOD_O(class_name, method_name)			\
 | 
					
						
							|  |  |  | 	PyObject* Py##method_name(PyObject* self, PyObject* value); \ | 
					
						
							|  |  |  | 	static PyObject* sPy##method_name( PyObject* self, PyObject* value) { \ | 
					
						
							|  |  |  | 		return ((class_name*) self)->Py##method_name(self, value);		\ | 
					
						
							|  |  |  | 	}; \ | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-07 11:03:12 +00:00
										 |  |  | #define KX_PYMETHOD_DOC(class_name, method_name)			\
 | 
					
						
							|  |  |  | 	PyObject* Py##method_name(PyObject* self, PyObject* args, PyObject* kwds); \ | 
					
						
							|  |  |  | 	static PyObject* sPy##method_name( PyObject* self, PyObject* args, PyObject* kwds) { \ | 
					
						
							|  |  |  | 		return ((class_name*) self)->Py##method_name(self, args, kwds);		\ | 
					
						
							|  |  |  | 	}; \ | 
					
						
							| 
									
										
										
										
											2008-09-20 11:08:35 +00:00
										 |  |  |     static const char method_name##_doc[]; \ | 
					
						
							| 
									
										
										
										
											2004-06-07 11:03:12 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-08-14 08:58:25 +00:00
										 |  |  | #define KX_PYMETHOD_DOC_VARARGS(class_name, method_name)			\
 | 
					
						
							|  |  |  | 	PyObject* Py##method_name(PyObject* self, PyObject* args); \ | 
					
						
							|  |  |  | 	static PyObject* sPy##method_name( PyObject* self, PyObject* args) { \ | 
					
						
							|  |  |  | 		return ((class_name*) self)->Py##method_name(self, args);		\ | 
					
						
							|  |  |  | 	}; \ | 
					
						
							| 
									
										
										
										
											2008-09-20 11:08:35 +00:00
										 |  |  |     static const char method_name##_doc[]; \ | 
					
						
							| 
									
										
										
										
											2008-08-14 08:58:25 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-07-04 00:05:50 +00:00
										 |  |  | #define KX_PYMETHOD_DOC_O(class_name, method_name)			\
 | 
					
						
							|  |  |  | 	PyObject* Py##method_name(PyObject* self, PyObject* value); \ | 
					
						
							|  |  |  | 	static PyObject* sPy##method_name( PyObject* self, PyObject* value) { \ | 
					
						
							|  |  |  | 		return ((class_name*) self)->Py##method_name(self, value);		\ | 
					
						
							|  |  |  | 	}; \ | 
					
						
							| 
									
										
										
										
											2008-09-20 11:08:35 +00:00
										 |  |  |     static const char method_name##_doc[]; \ | 
					
						
							| 
									
										
										
										
											2008-07-04 00:05:50 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | #define KX_PYMETHOD_DOC_NOARGS(class_name, method_name)			\
 | 
					
						
							|  |  |  | 	PyObject* Py##method_name(PyObject* self); \ | 
					
						
							|  |  |  | 	static PyObject* sPy##method_name( PyObject* self) { \ | 
					
						
							|  |  |  | 		return ((class_name*) self)->Py##method_name(self);		\ | 
					
						
							|  |  |  | 	}; \ | 
					
						
							| 
									
										
										
										
											2008-09-20 11:08:35 +00:00
										 |  |  |     static const char method_name##_doc[]; \ | 
					
						
							| 
									
										
										
										
											2008-07-04 00:05:50 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-07 11:03:12 +00:00
										 |  |  | /* The line above should remain empty */ | 
					
						
							|  |  |  | /**
 | 
					
						
							|  |  |  |  * Method table macro (with doc) | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | #define KX_PYMETHODTABLE(class_name, method_name) \
 | 
					
						
							| 
									
										
										
										
											2008-10-02 00:22:28 +00:00
										 |  |  | 	{#method_name , (PyCFunction) class_name::sPy##method_name, METH_VARARGS, (PY_METHODCHAR)class_name::method_name##_doc} | 
					
						
							| 
									
										
										
										
											2004-06-07 11:03:12 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-12-29 16:36:58 +00:00
										 |  |  | #define KX_PYMETHODTABLE_O(class_name, method_name) \
 | 
					
						
							|  |  |  | 	{#method_name , (PyCFunction) class_name::sPy##method_name, METH_O, (PY_METHODCHAR)class_name::method_name##_doc} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define KX_PYMETHODTABLE_NOARGS(class_name, method_name) \
 | 
					
						
							| 
									
										
										
										
											2008-10-02 00:22:28 +00:00
										 |  |  | 	{#method_name , (PyCFunction) class_name::sPy##method_name, METH_NOARGS, (PY_METHODCHAR)class_name::method_name##_doc} | 
					
						
							| 
									
										
											  
											
												BGE patch: KX_GameObject::rayCast() improvements to have X-Ray option, return true face normal and hit polygon information.
rayCast(to,from,dist,prop,face,xray,poly):
The face paremeter determines the orientation of the normal: 
  0 or omitted => hit normal is always oriented towards the ray origin (as if you casted the ray from outside)
  1 => hit normal is the real face normal (only for mesh object, otherwise face has no effect)
The ray has X-Ray capability if xray parameter is 1, otherwise the first object hit (other than self object) stops the ray.
The prop and xray parameters interact as follow:
    prop off, xray off: return closest hit or no hit if there is no object on the full extend of the ray.
    prop off, xray on : idem.
    prop on,  xray off: return closest hit if it matches prop, no hit otherwise.
    prop on,  xray on : return closest hit matching prop or no hit if there is no object matching prop on the full extend of the ray.
if poly is 0 or omitted, returns a 3-tuple with object reference, hit point and hit normal or (None,None,None) if no hit.
if poly is 1, returns a 4-tuple with in addition a KX_PolyProxy as 4th element.
The KX_PolyProxy object holds information on the polygon hit by the ray: the index of the vertex forming the poylgon, material, etc.
Attributes (read-only):
 matname: The name of polygon material, empty if no material.
 material: The material of the polygon
 texture: The texture name of the polygon.
 matid: The material index of the polygon, use this to retrieve vertex proxy from mesh proxy
 v1: vertex index of the first vertex of the polygon, use this to retrieve vertex proxy from mesh proxy
 v2: vertex index of the second vertex of the polygon, use this to retrieve vertex proxy from mesh proxy
 v3: vertex index of the third vertex of the polygon, use this to retrieve vertex proxy from mesh proxy
 v4: vertex index of the fourth vertex of the polygon, 0 if polygon has only 3 vertex
     use this to retrieve vertex proxy from mesh proxy
 visible: visible state of the polygon: 1=visible, 0=invisible
 collide: collide state of the polygon: 1=receives collision, 0=collision free.
Methods:
 getMaterialName(): Returns the polygon material name with MA prefix
 getMaterial(): Returns the polygon material
 getTextureName(): Returns the polygon texture name
 getMaterialIndex(): Returns the material bucket index of the polygon. 
 getNumVertex(): Returns the number of vertex of the polygon.
 isVisible(): Returns whether the polygon is visible or not
 isCollider(): Returns whether the polygon is receives collision or not
 getVertexIndex(vertex): Returns the mesh vertex index of a polygon vertex
 getMesh(): Returns a mesh proxy
New methods of KX_MeshProxy have been implemented to retrieve KX_PolyProxy objects:
 getNumPolygons(): Returns the number of polygon in the mesh.
 getPolygon(index): Gets the specified polygon from the mesh.
More details in PyDoc.
											
										 
											2008-08-27 19:34:19 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-07 11:03:12 +00:00
										 |  |  | /**
 | 
					
						
							|  |  |  |  * Function implementation macro | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | #define KX_PYMETHODDEF_DOC(class_name, method_name, doc_string) \
 | 
					
						
							| 
									
										
										
										
											2008-09-20 11:08:35 +00:00
										 |  |  | const char class_name::method_name##_doc[] = doc_string; \ | 
					
						
							| 
									
										
										
										
											2004-07-17 05:28:23 +00:00
										 |  |  | PyObject* class_name::Py##method_name(PyObject*, PyObject* args, PyObject*) | 
					
						
							| 
									
										
										
										
											2004-06-07 11:03:12 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-12-29 16:36:58 +00:00
										 |  |  | #define KX_PYMETHODDEF_DOC_VARARGS(class_name, method_name, doc_string) \
 | 
					
						
							|  |  |  | const char class_name::method_name##_doc[] = doc_string; \ | 
					
						
							|  |  |  | PyObject* class_name::Py##method_name(PyObject*, PyObject* args) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define KX_PYMETHODDEF_DOC_O(class_name, method_name, doc_string) \
 | 
					
						
							|  |  |  | const char class_name::method_name##_doc[] = doc_string; \ | 
					
						
							|  |  |  | PyObject* class_name::Py##method_name(PyObject*, PyObject* value) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define KX_PYMETHODDEF_DOC_NOARGS(class_name, method_name, doc_string) \
 | 
					
						
							| 
									
										
										
										
											2008-09-20 11:08:35 +00:00
										 |  |  | const char class_name::method_name##_doc[] = doc_string; \ | 
					
						
							| 
									
										
											  
											
												BGE patch: KX_GameObject::rayCast() improvements to have X-Ray option, return true face normal and hit polygon information.
rayCast(to,from,dist,prop,face,xray,poly):
The face paremeter determines the orientation of the normal: 
  0 or omitted => hit normal is always oriented towards the ray origin (as if you casted the ray from outside)
  1 => hit normal is the real face normal (only for mesh object, otherwise face has no effect)
The ray has X-Ray capability if xray parameter is 1, otherwise the first object hit (other than self object) stops the ray.
The prop and xray parameters interact as follow:
    prop off, xray off: return closest hit or no hit if there is no object on the full extend of the ray.
    prop off, xray on : idem.
    prop on,  xray off: return closest hit if it matches prop, no hit otherwise.
    prop on,  xray on : return closest hit matching prop or no hit if there is no object matching prop on the full extend of the ray.
if poly is 0 or omitted, returns a 3-tuple with object reference, hit point and hit normal or (None,None,None) if no hit.
if poly is 1, returns a 4-tuple with in addition a KX_PolyProxy as 4th element.
The KX_PolyProxy object holds information on the polygon hit by the ray: the index of the vertex forming the poylgon, material, etc.
Attributes (read-only):
 matname: The name of polygon material, empty if no material.
 material: The material of the polygon
 texture: The texture name of the polygon.
 matid: The material index of the polygon, use this to retrieve vertex proxy from mesh proxy
 v1: vertex index of the first vertex of the polygon, use this to retrieve vertex proxy from mesh proxy
 v2: vertex index of the second vertex of the polygon, use this to retrieve vertex proxy from mesh proxy
 v3: vertex index of the third vertex of the polygon, use this to retrieve vertex proxy from mesh proxy
 v4: vertex index of the fourth vertex of the polygon, 0 if polygon has only 3 vertex
     use this to retrieve vertex proxy from mesh proxy
 visible: visible state of the polygon: 1=visible, 0=invisible
 collide: collide state of the polygon: 1=receives collision, 0=collision free.
Methods:
 getMaterialName(): Returns the polygon material name with MA prefix
 getMaterial(): Returns the polygon material
 getTextureName(): Returns the polygon texture name
 getMaterialIndex(): Returns the material bucket index of the polygon. 
 getNumVertex(): Returns the number of vertex of the polygon.
 isVisible(): Returns whether the polygon is visible or not
 isCollider(): Returns whether the polygon is receives collision or not
 getVertexIndex(vertex): Returns the mesh vertex index of a polygon vertex
 getMesh(): Returns a mesh proxy
New methods of KX_MeshProxy have been implemented to retrieve KX_PolyProxy objects:
 getNumPolygons(): Returns the number of polygon in the mesh.
 getPolygon(index): Gets the specified polygon from the mesh.
More details in PyDoc.
											
										 
											2008-08-27 19:34:19 +00:00
										 |  |  | PyObject* class_name::Py##method_name(PyObject*) | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | /**
 | 
					
						
							|  |  |  |  * Attribute management | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | enum KX_PYATTRIBUTE_TYPE { | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_TYPE_BOOL, | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | 	KX_PYATTRIBUTE_TYPE_ENUM, | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 	KX_PYATTRIBUTE_TYPE_SHORT, | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_TYPE_INT, | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_TYPE_FLOAT, | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_TYPE_STRING, | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_TYPE_DUMMY, | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	KX_PYATTRIBUTE_TYPE_FUNCTION, | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | }; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | enum KX_PYATTRIBUTE_ACCESS { | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_RW, | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_RO | 
					
						
							|  |  |  | }; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | struct KX_PYATTRIBUTE_DEF; | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | typedef int (*KX_PYATTRIBUTE_CHECK_FUNCTION)(void *self, const struct KX_PYATTRIBUTE_DEF *attrdef); | 
					
						
							|  |  |  | typedef int (*KX_PYATTRIBUTE_SET_FUNCTION)(void *self, const struct KX_PYATTRIBUTE_DEF *attrdef, PyObject *value); | 
					
						
							|  |  |  | typedef PyObject* (*KX_PYATTRIBUTE_GET_FUNCTION)(void *self, const struct KX_PYATTRIBUTE_DEF *attrdef); | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | typedef struct KX_PYATTRIBUTE_DEF { | 
					
						
							|  |  |  | 	const char *m_name;				// name of the python attribute
 | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_TYPE m_type;		// type of value
 | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_ACCESS m_access;	// read/write access or read-only
 | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | 	int m_imin;						// minimum value in case of integer attributes (for string: minimum string length)
 | 
					
						
							|  |  |  | 	int m_imax;						// maximum value in case of integer attributes (for string: maximum string length)
 | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 	float m_fmin;					// minimum value in case of float attributes
 | 
					
						
							|  |  |  | 	float m_fmax;					// maximum value in case of float attributes
 | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | 	bool   m_clamp;					// enforce min/max value by clamping
 | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 	size_t m_offset;				// position of field in structure
 | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | 	size_t m_size;					// size of field for runtime verification (enum only)
 | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 	size_t m_length;				// length of array, 1=simple attribute
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	KX_PYATTRIBUTE_CHECK_FUNCTION m_checkFunction;	// static function to check the assignment, returns 0 if no error
 | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_SET_FUNCTION m_setFunction;	// static function to check the assignment, returns 0 if no error
 | 
					
						
							|  |  |  | 	KX_PYATTRIBUTE_GET_FUNCTION m_getFunction;	// static function to check the assignment, returns 0 if no error
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 	// The following pointers are just used to have compile time check for attribute type.
 | 
					
						
							|  |  |  | 	// It would have been good to use a union but that would require C99 compatibility
 | 
					
						
							|  |  |  | 	// to initialize specific union fields through designated initializers.
 | 
					
						
							|  |  |  | 	struct { | 
					
						
							|  |  |  | 		bool *m_boolPtr; | 
					
						
							|  |  |  | 		short int *m_shortPtr; | 
					
						
							|  |  |  | 		int *m_intPtr; | 
					
						
							|  |  |  | 		float *m_floatPtr; | 
					
						
							|  |  |  | 		STR_String *m_stringPtr; | 
					
						
							|  |  |  | 	} m_typeCheck; | 
					
						
							|  |  |  | } PyAttributeDef; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_DUMMY(name) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_DUMMY, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, 0, 0, 1, NULL, NULL, NULL, {NULL, NULL, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_BOOL_RW(name,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_BOOL, KX_PYATTRIBUTE_RW, 0, 1, 0.f, 0.f, false, offsetof(object,field), 0, 1, NULL, NULL, NULL, {&((object *)0)->field, NULL, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_BOOL_RW_CHECK(name,object,field,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_BOOL, KX_PYATTRIBUTE_RW, 0, 1, 0.f, 0.f, false, offsetof(object,field), 0, 1, &object::function, NULL, NULL, {&((object *)0)->field, NULL, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_BOOL_RO(name,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_BOOL, KX_PYATTRIBUTE_RO, 0, 1, 0.f, 0.f, false, offsetof(object,field), 0, 1, NULL, NULL, NULL, {&((object *)0)->field, NULL, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | // enum field cannot be mapped to pointer (because we would need a pointer for each enum)
 | 
					
						
							|  |  |  | // use field size to verify mapping at runtime only, assuming enum size is equal to int size.
 | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_ENUM_RW(name,min,max,clamp,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_ENUM, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), sizeof(((object *)0)->field), 1, NULL, NULL, NULL, {NULL, NULL, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_ENUM_RW_CHECK(name,min,max,clamp,object,field,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_ENUM, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), sizeof(((object *)0)->field), 1, &object::function, NULL, NULL, {NULL, NULL, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_ENUM_RO(name,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_ENUM, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), sizeof(((object *)0)->field), 1, NULL, NULL, NULL, {NULL, NULL, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_SHORT_RW(name,min,max,clamp,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_SHORT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, 1, NULL, NULL, NULL, {NULL, &((object *)0)->field, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_SHORT_RW_CHECK(name,min,max,clamp,object,field,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_SHORT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, 1, &object::function, NULL, NULL, {NULL, &((object *)0)->field, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_SHORT_RO(name,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_SHORT, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), 0, 1, NULL, NULL, NULL, {NULL, &((object *)0)->field, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_SHORT_ARRAY_RW(name,min,max,clamp,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_SHORT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, ((object *)0)->field, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_SHORT_ARRAY_RW_CHECK(name,min,max,clamp,object,field,length,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_SHORT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, length, &object::function, NULL, NULL, {NULL, ((object *)0)->field, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_SHORT_ARRAY_RO(name,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_SHORT, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, ((object *)0)->field, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-02-19 23:13:41 +00:00
										 |  |  | // SHORT_LIST
 | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_SHORT_LIST_RW(name,min,max,clamp,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_SHORT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, &((object *)0)->field, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-02-19 23:13:41 +00:00
										 |  |  | #define KX_PYATTRIBUTE_SHORT_LIST_RW_CHECK(name,min,max,clamp,object,field,length,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_SHORT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, length, &object::function, NULL, NULL, {NULL, &((object *)0)->field, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-02-19 23:13:41 +00:00
										 |  |  | #define KX_PYATTRIBUTE_SHORT_LIST_RO(name,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_SHORT, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, &((object *)0)->field, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_INT_RW(name,min,max,clamp,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_INT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, 1, NULL, NULL, NULL, {NULL, NULL, &((object *)0)->field, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_INT_RW_CHECK(name,min,max,clamp,object,field,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_INT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, 1, &object::function, NULL, NULL, {NULL, NULL, &((object *)0)->field, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_INT_RO(name,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_INT, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), 0, 1, NULL, NULL, NULL, {NULL, NULL, &((object *)0)->field, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_INT_ARRAY_RW(name,min,max,clamp,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_INT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, NULL, ((object *)0)->field, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_INT_ARRAY_RW_CHECK(name,min,max,clamp,object,field,length,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_INT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, length, &object::function, NULL, NULL, {NULL, NULL, ((object *)0)->field, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_INT_ARRAY_RO(name,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_INT, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, NULL, ((object *)0)->field, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-02-19 23:13:41 +00:00
										 |  |  | // INT_LIST
 | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_INT_LIST_RW(name,min,max,clamp,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_INT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, NULL, &((object *)0)->field, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-02-19 23:13:41 +00:00
										 |  |  | #define KX_PYATTRIBUTE_INT_LIST_RW_CHECK(name,min,max,clamp,object,field,length,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_INT, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, length, &object::function, NULL, NULL, {NULL, NULL, &((object *)0)->field, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2009-02-19 23:13:41 +00:00
										 |  |  | #define KX_PYATTRIBUTE_INT_LIST_RO(name,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_INT, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, NULL, &((object *)0)->field, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | // always clamp for float
 | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_FLOAT_RW(name,min,max,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FLOAT, KX_PYATTRIBUTE_RW, 0, 0, min, max, true, offsetof(object,field), 0, 1, NULL, NULL, NULL, {NULL, NULL, NULL, &((object *)0)->field, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_FLOAT_RW_CHECK(name,min,max,object,field,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FLOAT, KX_PYATTRIBUTE_RW, 0, 0, min, max, true, offsetof(object,field), 0, 1, &object::function, NULL, NULL, {NULL, NULL, NULL, &((object *)0)->field, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_FLOAT_RO(name,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FLOAT, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), 0, 1, NULL, NULL, NULL, {NULL, NULL, NULL, &((object *)0)->field, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_FLOAT_ARRAY_RW(name,min,max,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FLOAT, KX_PYATTRIBUTE_RW, 0, 0, min, max, true, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, NULL, NULL, ((object *)0)->field, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_FLOAT_ARRAY_RW_CHECK(name,min,max,object,field,length,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FLOAT, KX_PYATTRIBUTE_RW, 0, 0, min, max, true, offsetof(object,field), 0, length, &object::function, NULL, NULL, {NULL, NULL, NULL, ((object *)0)->field, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_FLOAT_ARRAY_RO(name,object,field,length) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FLOAT, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), 0, length, NULL, NULL, NULL, {NULL, NULL, NULL, ((object *)0)->field, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_STRING_RW(name,min,max,clamp,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_STRING, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, 1, NULL, NULL, NULL, {NULL, NULL, NULL, NULL, &((object *)0)->field} } | 
					
						
							| 
									
										
										
										
											2009-01-02 17:43:56 +00:00
										 |  |  | #define KX_PYATTRIBUTE_STRING_RW_CHECK(name,min,max,clamp,object,field,function) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_STRING, KX_PYATTRIBUTE_RW, min, max, 0.f, 0.f, clamp, offsetof(object,field), 0, 1, &object::function, NULL, NULL, {NULL, NULL, NULL, NULL, &((object *)0)->field} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | #define KX_PYATTRIBUTE_STRING_RO(name,object,field) \
 | 
					
						
							| 
									
										
										
										
											2009-03-22 21:36:48 +00:00
										 |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_STRING, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, offsetof(object,field), 0, 1 , NULL, NULL, NULL, {NULL, NULL, NULL, NULL, &((object *)0)->field} } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_RW_FUNCTION(name,object,setfunction,getfunction) \
 | 
					
						
							|  |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FUNCTION, KX_PYATTRIBUTE_RW, 0, 0, 0.f, 0.f, false, 0, 0, 1, NULL, &object::setfunction, &object::getfunction, {NULL, NULL, NULL, NULL, NULL} } | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_RO_FUNCTION(name,object,getfunction) \
 | 
					
						
							|  |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FUNCTION, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0.f, false, 0, 0, 1, NULL, NULL, &object::getfunction, {NULL, NULL, NULL, NULL, NULL} } | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_ARRAY_RW_FUNCTION(name,object,length,setfunction,getfunction) \
 | 
					
						
							|  |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FUNCTION, KX_PYATTRIBUTE_RW, 0, 0, 0.f, 0,f, false, 0, 0, length, NULL, &object::setfunction, &object::getfunction, {NULL, NULL, NULL, NULL, NULL} } | 
					
						
							|  |  |  | #define KX_PYATTRIBUTE_ARRAY_RO_FUNCTION(name,object,length,getfunction) \
 | 
					
						
							|  |  |  | 	{ name, KX_PYATTRIBUTE_TYPE_FUNCTION, KX_PYATTRIBUTE_RO, 0, 0, 0.f, 0,f, false, 0, 0, length, NULL, NULL, &object::getfunction, {NULL, NULL, NULL, NULL, NULL} } | 
					
						
							| 
									
										
										
										
											2008-12-31 20:35:20 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-02-19 23:13:41 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | /*------------------------------
 | 
					
						
							|  |  |  |  * PyObjectPlus | 
					
						
							|  |  |  | ------------------------------*/ | 
					
						
							|  |  |  | typedef PyTypeObject * PyParentObject;				// Define the PyParent Object
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | class PyObjectPlus : public PyObject  | 
					
						
							|  |  |  | {				// The PyObjectPlus abstract class
 | 
					
						
							|  |  |  | 	Py_Header;							// Always start with Py_Header
 | 
					
						
							|  |  |  | 	 | 
					
						
							|  |  |  | public: | 
					
						
							|  |  |  | 	PyObjectPlus(PyTypeObject *T); | 
					
						
							|  |  |  | 	 | 
					
						
							| 
									
										
										
										
											2005-12-20 09:13:06 +00:00
										 |  |  | 	virtual ~PyObjectPlus();					// destructor
 | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | 	static void PyDestructor(PyObject *P)				// python wrapper
 | 
					
						
							|  |  |  | 	{   | 
					
						
							|  |  |  | 		delete ((PyObjectPlus *) P);   | 
					
						
							|  |  |  | 	}; | 
					
						
							|  |  |  | 	 | 
					
						
							| 
									
										
										
										
											2005-12-20 09:13:06 +00:00
										 |  |  | //	void INCREF(void) {
 | 
					
						
							|  |  |  | //		  Py_INCREF(this);
 | 
					
						
							|  |  |  | //	  };				// incref method
 | 
					
						
							|  |  |  | //	void DECREF(void) {
 | 
					
						
							|  |  |  | //		  Py_DECREF(this);
 | 
					
						
							|  |  |  | //	  };				// decref method
 | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | 	 | 
					
						
							| 
									
										
										
										
											2009-02-19 13:42:07 +00:00
										 |  |  | 	virtual PyObject *_getattr(const char *attr);			// _getattr method
 | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | 	static  PyObject *__getattr(PyObject * PyObj, char *attr) 	// This should be the entry in Type. 
 | 
					
						
							|  |  |  | 	{ | 
					
						
							| 
									
										
										
										
											2009-02-19 13:42:07 +00:00
										 |  |  | 		return ((PyObjectPlus*) PyObj)->_getattr(attr);  | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | 	} | 
					
						
							| 
									
										
										
										
											2009-02-19 13:42:07 +00:00
										 |  |  | 	static PyObject *_getattr_self(const PyAttributeDef attrlist[], void *self, const char *attr); | 
					
						
							|  |  |  | 	static int _setattr_self(const PyAttributeDef attrlist[], void *self, const char *attr, PyObject *value); | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | 	 | 
					
						
							| 
									
										
										
										
											2009-02-19 13:42:07 +00:00
										 |  |  | 	virtual int _delattr(const char *attr); | 
					
						
							|  |  |  | 	virtual int _setattr(const char *attr, PyObject *value);		// _setattr method
 | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | 	static  int __setattr(PyObject *PyObj, 			// This should be the entry in Type. 
 | 
					
						
							|  |  |  | 				char *attr,  | 
					
						
							|  |  |  | 				PyObject *value) | 
					
						
							|  |  |  | 	{  | 
					
						
							|  |  |  | 		if (!value) | 
					
						
							|  |  |  | 			return ((PyObjectPlus*) PyObj)->_delattr(attr); | 
					
						
							| 
									
										
										
										
											2009-02-19 13:42:07 +00:00
										 |  |  | 		return ((PyObjectPlus*) PyObj)->_setattr(attr, value);   | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | 	} | 
					
						
							|  |  |  | 	 | 
					
						
							|  |  |  | 	virtual PyObject *_repr(void);				// _repr method
 | 
					
						
							|  |  |  | 	static  PyObject *__repr(PyObject *PyObj)			// This should be the entry in Type.
 | 
					
						
							|  |  |  | 	{ | 
					
						
							|  |  |  | 		return ((PyObjectPlus*) PyObj)->_repr();   | 
					
						
							|  |  |  | 	} | 
					
						
							|  |  |  | 	 | 
					
						
							|  |  |  | 									// isA methods
 | 
					
						
							|  |  |  | 	bool isA(PyTypeObject *T); | 
					
						
							|  |  |  | 	bool isA(const char *mytypename); | 
					
						
							| 
									
										
										
										
											2009-02-21 12:43:24 +00:00
										 |  |  | 	PyObject *Py_isA(PyObject *value); | 
					
						
							|  |  |  | 	static PyObject *sPy_isA(PyObject *self, PyObject *value) | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | 	{ | 
					
						
							| 
									
										
										
										
											2009-02-21 12:43:24 +00:00
										 |  |  | 		return ((PyObjectPlus*)self)->Py_isA(value); | 
					
						
							| 
									
										
										
										
											2004-11-22 10:19:19 +00:00
										 |  |  | 	} | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | }; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-02-26 09:04:06 +00:00
										 |  |  | PyObject *_getattr_dict(PyObject *pydict, PyMethodDef *meth, PyAttributeDef *attrdef); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2002-10-12 11:37:38 +00:00
										 |  |  | #endif //  _adr_py_lib_h_
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #endif //NO_EXP_PYTHON_EMBEDDING
 | 
					
						
							|  |  |  | 
 |