1191 lines
39 KiB
C
1191 lines
39 KiB
C
/*
|
|
* $Id$
|
|
*
|
|
* ***** 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,
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*
|
|
* Contributor(s): Campbell Barton
|
|
*
|
|
* ***** END GPL LICENSE BLOCK *****
|
|
*/
|
|
|
|
/** \file blender/python/intern/bpy_props.c
|
|
* \ingroup pythonintern
|
|
*/
|
|
|
|
|
|
#include <Python.h>
|
|
|
|
#include "RNA_types.h"
|
|
|
|
#include "bpy_props.h"
|
|
#include "bpy_rna.h"
|
|
#include "bpy_util.h"
|
|
|
|
#include "BLI_utildefines.h"
|
|
|
|
#include "BKE_idprop.h"
|
|
|
|
#include "RNA_access.h"
|
|
#include "RNA_define.h" /* for defining our own rna */
|
|
#include "RNA_enum_types.h"
|
|
|
|
#include "MEM_guardedalloc.h"
|
|
|
|
#include "../generic/py_capi_utils.h"
|
|
|
|
extern BPy_StructRNA *bpy_context_module;
|
|
|
|
static EnumPropertyItem property_flag_items[]= {
|
|
{PROP_HIDDEN, "HIDDEN", 0, "Hidden", ""},
|
|
{PROP_ANIMATABLE, "ANIMATABLE", 0, "Animateable", ""},
|
|
{0, NULL, 0, NULL, NULL}};
|
|
|
|
static EnumPropertyItem property_flag_enum_items[]= {
|
|
{PROP_HIDDEN, "HIDDEN", 0, "Hidden", ""},
|
|
{PROP_ANIMATABLE, "ANIMATABLE", 0, "Animateable", ""},
|
|
{PROP_ENUM_FLAG, "ENUM_FLAG", 0, "Enum Flag", ""},
|
|
{0, NULL, 0, NULL, NULL}};
|
|
|
|
/* subtypes */
|
|
static EnumPropertyItem property_subtype_string_items[]= {
|
|
{PROP_FILEPATH, "FILE_PATH", 0, "File Path", ""},
|
|
{PROP_DIRPATH, "DIR_PATH", 0, "Directory Path", ""},
|
|
{PROP_FILENAME, "FILENAME", 0, "Filename", ""},
|
|
|
|
{PROP_NONE, "NONE", 0, "None", ""},
|
|
{0, NULL, 0, NULL, NULL}};
|
|
|
|
static EnumPropertyItem property_subtype_number_items[]= {
|
|
{PROP_UNSIGNED, "UNSIGNED", 0, "Unsigned", ""},
|
|
{PROP_PERCENTAGE, "PERCENTAGE", 0, "Percentage", ""},
|
|
{PROP_FACTOR, "FACTOR", 0, "Factor", ""},
|
|
{PROP_ANGLE, "ANGLE", 0, "Angle", ""},
|
|
{PROP_TIME, "TIME", 0, "Time", ""},
|
|
{PROP_DISTANCE, "DISTANCE", 0, "Distance", ""},
|
|
|
|
{PROP_NONE, "NONE", 0, "None", ""},
|
|
{0, NULL, 0, NULL, NULL}};
|
|
|
|
static EnumPropertyItem property_subtype_array_items[]= {
|
|
{PROP_COLOR, "COLOR", 0, "Color", ""},
|
|
{PROP_TRANSLATION, "TRANSLATION", 0, "Translation", ""},
|
|
{PROP_DIRECTION, "DIRECTION", 0, "Direction", ""},
|
|
{PROP_VELOCITY, "VELOCITY", 0, "Velocity", ""},
|
|
{PROP_ACCELERATION, "ACCELERATION", 0, "Acceleration", ""},
|
|
{PROP_MATRIX, "MATRIX", 0, "Matrix", ""},
|
|
{PROP_EULER, "EULER", 0, "Euler", ""},
|
|
{PROP_QUATERNION, "QUATERNION", 0, "Quaternion", ""},
|
|
{PROP_AXISANGLE, "AXISANGLE", 0, "Axis Angle", ""},
|
|
{PROP_XYZ, "XYZ", 0, "XYZ", ""},
|
|
{PROP_COLOR_GAMMA, "COLOR_GAMMA", 0, "Color Gamma", ""},
|
|
{PROP_LAYER, "LAYER", 0, "Layer", ""},
|
|
|
|
{PROP_NONE, "NONE", 0, "None", ""},
|
|
{0, NULL, 0, NULL, NULL}};
|
|
|
|
/* PyObject's */
|
|
static PyObject *pymeth_BoolProperty= NULL;
|
|
static PyObject *pymeth_BoolVectorProperty= NULL;
|
|
static PyObject *pymeth_IntProperty= NULL;
|
|
static PyObject *pymeth_IntVectorProperty= NULL;
|
|
static PyObject *pymeth_FloatProperty= NULL;
|
|
static PyObject *pymeth_FloatVectorProperty= NULL;
|
|
static PyObject *pymeth_StringProperty= NULL;
|
|
static PyObject *pymeth_EnumProperty= NULL;
|
|
static PyObject *pymeth_PointerProperty= NULL;
|
|
static PyObject *pymeth_CollectionProperty= NULL;
|
|
static PyObject *pymeth_RemoveProperty= NULL;
|
|
|
|
|
|
/* operators and classes use this so it can store the args given but defer
|
|
* running it until the operator runs where these values are used to setup
|
|
* the default args for that operator instance */
|
|
static PyObject *bpy_prop_deferred_return(PyObject *func, PyObject *kw)
|
|
{
|
|
PyObject *ret= PyTuple_New(2);
|
|
PyTuple_SET_ITEM(ret, 0, func);
|
|
Py_INCREF(func);
|
|
|
|
if(kw==NULL)
|
|
kw= PyDict_New();
|
|
else
|
|
Py_INCREF(kw);
|
|
|
|
PyTuple_SET_ITEM(ret, 1, kw);
|
|
|
|
return ret;
|
|
}
|
|
|
|
/* this define runs at the start of each function and deals with
|
|
* returning a deferred property (to be registered later) */
|
|
#define BPY_PROPDEF_HEAD(_func) \
|
|
if (PyTuple_GET_SIZE(args) == 1) { \
|
|
PyObject *ret; \
|
|
self= PyTuple_GET_ITEM(args, 0); \
|
|
args= PyTuple_New(0); \
|
|
ret= BPy_##_func(self, args, kw); \
|
|
Py_DECREF(args); \
|
|
return ret; \
|
|
} \
|
|
else if (PyTuple_GET_SIZE(args) > 1) { \
|
|
PyErr_SetString(PyExc_ValueError, "all args must be keywords"); \
|
|
return NULL; \
|
|
} \
|
|
srna= srna_from_self(self, #_func"(...):"); \
|
|
if(srna==NULL) { \
|
|
if(PyErr_Occurred()) \
|
|
return NULL; \
|
|
return bpy_prop_deferred_return((void *)pymeth_##_func, kw); \
|
|
} \
|
|
|
|
/* terse macros for error checks shared between all funcs cant use function
|
|
* calls because of static strins passed to pyrna_set_to_enum_bitfield */
|
|
#define BPY_PROPDEF_CHECK(_func, _property_flag_items) \
|
|
if(id_len >= MAX_IDPROP_NAME) { \
|
|
PyErr_Format(PyExc_TypeError, #_func"(): '%.200s' too long, max length is %d", id, MAX_IDPROP_NAME-1); \
|
|
return NULL; \
|
|
} \
|
|
if(RNA_def_property_free_identifier(srna, id) == -1) { \
|
|
PyErr_Format(PyExc_TypeError, #_func"(): '%s' is defined as a non-dynamic type", id); \
|
|
return NULL; \
|
|
} \
|
|
if(pyopts && pyrna_set_to_enum_bitfield(_property_flag_items, pyopts, &opts, #_func"(options={...}):")) \
|
|
return NULL; \
|
|
|
|
#define BPY_PROPDEF_SUBTYPE_CHECK(_func, _property_flag_items, _subtype) \
|
|
BPY_PROPDEF_CHECK(_func, _property_flag_items) \
|
|
if(pysubtype && RNA_enum_value_from_id(_subtype, pysubtype, &subtype)==0) { \
|
|
PyErr_Format(PyExc_TypeError, #_func"(subtype='%s'): invalid subtype", pysubtype); \
|
|
return NULL; \
|
|
} \
|
|
|
|
|
|
#define BPY_PROPDEF_NAME_DOC \
|
|
" :arg name: Name used in the user interface.\n" \
|
|
" :type name: string\n" \
|
|
|
|
|
|
#define BPY_PROPDEF_DESC_DOC \
|
|
" :arg description: Text used for the tooltip and api documentation.\n" \
|
|
" :type description: string\n" \
|
|
|
|
|
|
#if 0
|
|
static int bpy_struct_id_used(StructRNA *srna, char *identifier)
|
|
{
|
|
PointerRNA ptr;
|
|
RNA_pointer_create(NULL, srna, NULL, &ptr);
|
|
return (RNA_struct_find_property(&ptr, identifier) != NULL);
|
|
}
|
|
#endif
|
|
|
|
|
|
/* Function that sets RNA, NOTE - self is NULL when called from python, but being abused from C so we can pass the srna allong
|
|
* This isnt incorrect since its a python object - but be careful */
|
|
PyDoc_STRVAR(BPy_BoolProperty_doc,
|
|
".. function:: BoolProperty(name=\"\", description=\"\", default=False, options={'ANIMATABLE'}, subtype='NONE')\n"
|
|
"\n"
|
|
" Returns a new boolean property definition.\n"
|
|
"\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE'].\n"
|
|
" :type options: set\n"
|
|
" :arg subtype: Enumerator in ['UNSIGNED', 'PERCENTAGE', 'FACTOR', 'ANGLE', 'TIME', 'DISTANCE', 'NONE'].\n"
|
|
" :type subtype: string\n"
|
|
);
|
|
static PyObject *BPy_BoolProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(BoolProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "name", "description", "default", "options", "subtype", NULL};
|
|
const char *id=NULL, *name="", *description="";
|
|
int id_len;
|
|
int def=0;
|
|
PropertyRNA *prop;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
char *pysubtype= NULL;
|
|
int subtype= PROP_NONE;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#|ssiO!s:BoolProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&name, &description, &def,
|
|
&PySet_Type, &pyopts, &pysubtype))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_SUBTYPE_CHECK(BoolProperty, property_flag_items, property_subtype_number_items)
|
|
|
|
prop= RNA_def_property(srna, id, PROP_BOOLEAN, subtype);
|
|
RNA_def_property_boolean_default(prop, def);
|
|
RNA_def_property_ui_text(prop, name, description);
|
|
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
}
|
|
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(BPy_BoolVectorProperty_doc,
|
|
".. function:: BoolVectorProperty(name=\"\", description=\"\", default=(False, False, False), options={'ANIMATABLE'}, subtype='NONE', size=3)\n"
|
|
"\n"
|
|
" Returns a new vector boolean property definition.\n"
|
|
"\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg default: sequence of booleans the length of *size*.\n"
|
|
" :type default: sequence\n"
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE'].\n"
|
|
" :type options: set\n"
|
|
" :arg subtype: Enumerator in ['COLOR', 'TRANSLATION', 'DIRECTION', 'VELOCITY', 'ACCELERATION', 'MATRIX', 'EULER', 'QUATERNION', 'AXISANGLE', 'XYZ', 'COLOR_GAMMA', 'LAYER', 'NONE'].\n"
|
|
" :type subtype: string\n"
|
|
" :arg size: Vector dimensions in [1, and " STRINGIFY(PYRNA_STACK_ARRAY) "].\n"
|
|
" :type size: int\n"
|
|
);
|
|
static PyObject *BPy_BoolVectorProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(BoolVectorProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "name", "description", "default", "options", "subtype", "size", NULL};
|
|
const char *id=NULL, *name="", *description="";
|
|
int id_len;
|
|
int def[PYRNA_STACK_ARRAY]={0};
|
|
int size=3;
|
|
PropertyRNA *prop;
|
|
PyObject *pydef= NULL;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
char *pysubtype= NULL;
|
|
int subtype= PROP_NONE;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#|ssOO!si:BoolVectorProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&name, &description, &pydef,
|
|
&PySet_Type, &pyopts, &pysubtype,&size))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_SUBTYPE_CHECK(BoolVectorProperty, property_flag_items, property_subtype_array_items)
|
|
|
|
if(size < 1 || size > PYRNA_STACK_ARRAY) {
|
|
PyErr_Format(PyExc_TypeError, "BoolVectorProperty(size=%d): size must be between 0 and " STRINGIFY(PYRNA_STACK_ARRAY), size);
|
|
return NULL;
|
|
}
|
|
|
|
if(pydef && PyC_AsArray(def, pydef, size, &PyBool_Type, "BoolVectorProperty(default=sequence)") < 0)
|
|
return NULL;
|
|
|
|
// prop= RNA_def_boolean_array(srna, id, size, pydef ? def:NULL, name, description);
|
|
prop= RNA_def_property(srna, id, PROP_BOOLEAN, subtype);
|
|
RNA_def_property_array(prop, size);
|
|
if(pydef) RNA_def_property_boolean_array_default(prop, def);
|
|
RNA_def_property_ui_text(prop, name, description);
|
|
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
}
|
|
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(BPy_IntProperty_doc,
|
|
".. function:: IntProperty(name=\"\", description=\"\", default=0, min=-sys.maxint, max=sys.maxint, soft_min=-sys.maxint, soft_max=sys.maxint, step=1, options={'ANIMATABLE'}, subtype='NONE')\n"
|
|
"\n"
|
|
" Returns a new int property definition.\n"
|
|
"\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE'].\n"
|
|
" :type options: set\n"
|
|
" :arg subtype: Enumerator in ['UNSIGNED', 'PERCENTAGE', 'FACTOR', 'ANGLE', 'TIME', 'DISTANCE', 'NONE'].\n"
|
|
" :type subtype: string\n"
|
|
);
|
|
static PyObject *BPy_IntProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(IntProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "name", "description", "default", "min", "max", "soft_min", "soft_max", "step", "options", "subtype", NULL};
|
|
const char *id=NULL, *name="", *description="";
|
|
int id_len;
|
|
int min=INT_MIN, max=INT_MAX, soft_min=INT_MIN, soft_max=INT_MAX, step=1, def=0;
|
|
PropertyRNA *prop;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
char *pysubtype= NULL;
|
|
int subtype= PROP_NONE;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#|ssiiiiiiO!s:IntProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&name, &description, &def,
|
|
&min, &max, &soft_min, &soft_max,
|
|
&step, &PySet_Type, &pyopts, &pysubtype))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_SUBTYPE_CHECK(IntProperty, property_flag_items, property_subtype_number_items)
|
|
|
|
prop= RNA_def_property(srna, id, PROP_INT, subtype);
|
|
RNA_def_property_int_default(prop, def);
|
|
RNA_def_property_range(prop, min, max);
|
|
RNA_def_property_ui_text(prop, name, description);
|
|
RNA_def_property_ui_range(prop, MAX2(soft_min, min), MIN2(soft_max, max), step, 3);
|
|
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(BPy_IntVectorProperty_doc,
|
|
".. function:: IntVectorProperty(name=\"\", description=\"\", default=(0, 0, 0), min=-sys.maxint, max=sys.maxint, soft_min=-sys.maxint, soft_max=sys.maxint, options={'ANIMATABLE'}, subtype='NONE', size=3)\n"
|
|
"\n"
|
|
" Returns a new vector int property definition.\n"
|
|
"\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg default: sequence of ints the length of *size*.\n"
|
|
" :type default: sequence\n"
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE'].\n"
|
|
" :type options: set\n"
|
|
" :arg subtype: Enumerator in ['COLOR', 'TRANSLATION', 'DIRECTION', 'VELOCITY', 'ACCELERATION', 'MATRIX', 'EULER', 'QUATERNION', 'AXISANGLE', 'XYZ', 'COLOR_GAMMA', 'LAYER', 'NONE'].\n"
|
|
" :type subtype: string\n"
|
|
" :arg size: Vector dimensions in [1, and " STRINGIFY(PYRNA_STACK_ARRAY) "].\n"
|
|
" :type size: int\n"
|
|
);
|
|
static PyObject *BPy_IntVectorProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(IntVectorProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "name", "description", "default", "min", "max", "soft_min", "soft_max", "step", "options", "subtype", "size", NULL};
|
|
const char *id=NULL, *name="", *description="";
|
|
int id_len;
|
|
int min=INT_MIN, max=INT_MAX, soft_min=INT_MIN, soft_max=INT_MAX, step=1, def[PYRNA_STACK_ARRAY]={0};
|
|
int size=3;
|
|
PropertyRNA *prop;
|
|
PyObject *pydef= NULL;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
char *pysubtype= NULL;
|
|
int subtype= PROP_NONE;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#|ssOiiiiiO!si:IntVectorProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&name, &description, &pydef,
|
|
&min, &max, &soft_min, &soft_max,
|
|
&step, &PySet_Type, &pyopts,
|
|
&pysubtype, &size))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_SUBTYPE_CHECK(IntVectorProperty, property_flag_items, property_subtype_array_items)
|
|
|
|
if(size < 1 || size > PYRNA_STACK_ARRAY) {
|
|
PyErr_Format(PyExc_TypeError, "IntVectorProperty(size=%d): size must be between 0 and " STRINGIFY(PYRNA_STACK_ARRAY), size);
|
|
return NULL;
|
|
}
|
|
|
|
if(pydef && PyC_AsArray(def, pydef, size, &PyLong_Type, "IntVectorProperty(default=sequence)") < 0)
|
|
return NULL;
|
|
|
|
prop= RNA_def_property(srna, id, PROP_INT, subtype);
|
|
RNA_def_property_array(prop, size);
|
|
if(pydef) RNA_def_property_int_array_default(prop, def);
|
|
RNA_def_property_range(prop, min, max);
|
|
RNA_def_property_ui_text(prop, name, description);
|
|
RNA_def_property_ui_range(prop, MAX2(soft_min, min), MIN2(soft_max, max), step, 3);
|
|
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
|
|
PyDoc_STRVAR(BPy_FloatProperty_doc,
|
|
".. function:: FloatProperty(name=\"\", description=\"\", default=0.0, min=sys.float_info.min, max=sys.float_info.max, soft_min=sys.float_info.min, soft_max=sys.float_info.max, step=3, precision=2, options={'ANIMATABLE'}, subtype='NONE', unit='NONE')\n"
|
|
"\n"
|
|
" Returns a new float property definition.\n"
|
|
"\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE'].\n"
|
|
" :type options: set\n"
|
|
" :arg subtype: Enumerator in ['UNSIGNED', 'PERCENTAGE', 'FACTOR', 'ANGLE', 'TIME', 'DISTANCE', 'NONE'].\n"
|
|
" :type subtype: string\n"
|
|
" :arg unit: Enumerator in ['NONE', 'LENGTH', 'AREA', 'VOLUME', 'ROTATION', 'TIME', 'VELOCITY', 'ACCELERATION'].\n"
|
|
" :type unit: string\n"
|
|
);
|
|
static PyObject *BPy_FloatProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(FloatProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "name", "description", "default", "min", "max", "soft_min", "soft_max", "step", "precision", "options", "subtype", "unit", NULL};
|
|
const char *id=NULL, *name="", *description="";
|
|
int id_len;
|
|
float min=-FLT_MAX, max=FLT_MAX, soft_min=-FLT_MAX, soft_max=FLT_MAX, step=3, def=0.0f;
|
|
int precision= 2;
|
|
PropertyRNA *prop;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
char *pysubtype= NULL;
|
|
int subtype= PROP_NONE;
|
|
char *pyunit= NULL;
|
|
int unit= PROP_UNIT_NONE;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#|ssffffffiO!ss:FloatProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&name, &description, &def,
|
|
&min, &max, &soft_min, &soft_max,
|
|
&step, &precision, &PySet_Type,
|
|
&pyopts, &pysubtype, &pyunit))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_SUBTYPE_CHECK(FloatProperty, property_flag_items, property_subtype_number_items)
|
|
|
|
if(pyunit && RNA_enum_value_from_id(property_unit_items, pyunit, &unit)==0) {
|
|
PyErr_Format(PyExc_TypeError, "FloatProperty(unit='%s'): invalid unit");
|
|
return NULL;
|
|
}
|
|
|
|
prop= RNA_def_property(srna, id, PROP_FLOAT, subtype | unit);
|
|
RNA_def_property_float_default(prop, def);
|
|
RNA_def_property_range(prop, min, max);
|
|
RNA_def_property_ui_text(prop, name, description);
|
|
RNA_def_property_ui_range(prop, MAX2(soft_min, min), MIN2(soft_max, max), step, precision);
|
|
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(BPy_FloatVectorProperty_doc,
|
|
".. function:: FloatVectorProperty(name=\"\", description=\"\", default=(0.0, 0.0, 0.0), min=sys.float_info.min, max=sys.float_info.max, soft_min=sys.float_info.min, soft_max=sys.float_info.max, step=3, precision=2, options={'ANIMATABLE'}, subtype='NONE', size=3)\n"
|
|
"\n"
|
|
" Returns a new vector float property definition.\n"
|
|
"\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg default: sequence of floats the length of *size*.\n"
|
|
" :type default: sequence\n"
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE'].\n"
|
|
" :type options: set\n"
|
|
" :arg subtype: Enumerator in ['COLOR', 'TRANSLATION', 'DIRECTION', 'VELOCITY', 'ACCELERATION', 'MATRIX', 'EULER', 'QUATERNION', 'AXISANGLE', 'XYZ', 'COLOR_GAMMA', 'LAYER', 'NONE'].\n"
|
|
" :type subtype: string\n"
|
|
" :arg size: Vector dimensions in [1, and " STRINGIFY(PYRNA_STACK_ARRAY) "].\n"
|
|
" :type size: int\n"
|
|
);
|
|
static PyObject *BPy_FloatVectorProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(FloatVectorProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "name", "description", "default", "min", "max", "soft_min", "soft_max", "step", "precision", "options", "subtype", "size", NULL};
|
|
const char *id=NULL, *name="", *description="";
|
|
int id_len;
|
|
float min=-FLT_MAX, max=FLT_MAX, soft_min=-FLT_MAX, soft_max=FLT_MAX, step=3, def[PYRNA_STACK_ARRAY]={0.0f};
|
|
int precision= 2, size=3;
|
|
PropertyRNA *prop;
|
|
PyObject *pydef= NULL;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
char *pysubtype= NULL;
|
|
int subtype= PROP_NONE;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#|ssOfffffiO!si:FloatVectorProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&name, &description, &pydef,
|
|
&min, &max, &soft_min, &soft_max,
|
|
&step, &precision, &PySet_Type,
|
|
&pyopts, &pysubtype, &size))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_SUBTYPE_CHECK(FloatVectorProperty, property_flag_items, property_subtype_array_items)
|
|
|
|
if(size < 1 || size > PYRNA_STACK_ARRAY) {
|
|
PyErr_Format(PyExc_TypeError, "FloatVectorProperty(size=%d): size must be between 0 and " STRINGIFY(PYRNA_STACK_ARRAY), size);
|
|
return NULL;
|
|
}
|
|
|
|
if(pydef && PyC_AsArray(def, pydef, size, &PyFloat_Type, "FloatVectorProperty(default=sequence)") < 0)
|
|
return NULL;
|
|
|
|
prop= RNA_def_property(srna, id, PROP_FLOAT, subtype);
|
|
RNA_def_property_array(prop, size);
|
|
if(pydef) RNA_def_property_float_array_default(prop, def);
|
|
RNA_def_property_range(prop, min, max);
|
|
RNA_def_property_ui_text(prop, name, description);
|
|
RNA_def_property_ui_range(prop, MAX2(soft_min, min), MIN2(soft_max, max), step, precision);
|
|
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(BPy_StringProperty_doc,
|
|
".. function:: StringProperty(name=\"\", description=\"\", default=\"\", maxlen=0, options={'ANIMATABLE'}, subtype='NONE')\n"
|
|
"\n"
|
|
" Returns a new string property definition.\n"
|
|
"\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE'].\n"
|
|
" :type options: set\n"
|
|
" :arg subtype: Enumerator in ['FILE_PATH', 'DIR_PATH', 'FILENAME', 'NONE'].\n"
|
|
" :type subtype: string\n"
|
|
);
|
|
static PyObject *BPy_StringProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(StringProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "name", "description", "default", "maxlen", "options", "subtype", NULL};
|
|
const char *id=NULL, *name="", *description="", *def="";
|
|
int id_len;
|
|
int maxlen=0;
|
|
PropertyRNA *prop;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
char *pysubtype= NULL;
|
|
int subtype= PROP_NONE;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#|sssiO!s:StringProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&name, &description, &def,
|
|
&maxlen, &PySet_Type, &pyopts, &pysubtype))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_SUBTYPE_CHECK(StringProperty, property_flag_items, property_subtype_string_items)
|
|
|
|
prop= RNA_def_property(srna, id, PROP_STRING, subtype);
|
|
if(maxlen != 0) RNA_def_property_string_maxlength(prop, maxlen + 1); /* +1 since it includes null terminator */
|
|
if(def) RNA_def_property_string_default(prop, def);
|
|
RNA_def_property_ui_text(prop, name, description);
|
|
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
static EnumPropertyItem *enum_items_from_py(PyObject *seq_fast, PyObject *def, int *defvalue, const short is_enum_flag)
|
|
{
|
|
EnumPropertyItem *items= NULL;
|
|
PyObject *item;
|
|
int seq_len, i, totitem= 0;
|
|
short def_used= 0;
|
|
const char *def_cmp= NULL;
|
|
|
|
seq_len= PySequence_Fast_GET_SIZE(seq_fast);
|
|
|
|
if(is_enum_flag) {
|
|
if(seq_len > RNA_ENUM_BITFLAG_SIZE) {
|
|
PyErr_SetString(PyExc_TypeError, "EnumProperty(...): maximum " STRINGIFY(RNA_ENUM_BITFLAG_SIZE) " members for a ENUM_FLAG type property");
|
|
return NULL;
|
|
}
|
|
if(def && !PySet_Check(def)) {
|
|
PyErr_Format(PyExc_TypeError,
|
|
"EnumProperty(...): default option must be a 'set' "
|
|
"type when ENUM_FLAG is enabled, not a '%.200s'",
|
|
Py_TYPE(def)->tp_name);
|
|
return NULL;
|
|
}
|
|
}
|
|
else {
|
|
if(def) {
|
|
def_cmp= _PyUnicode_AsString(def);
|
|
if(def_cmp==NULL) {
|
|
PyErr_Format(PyExc_TypeError,
|
|
"EnumProperty(...): default option must be a 'str' "
|
|
"type when ENUM_FLAG is disabled, not a '%.200s'",
|
|
Py_TYPE(def)->tp_name);
|
|
return NULL;
|
|
}
|
|
}
|
|
}
|
|
|
|
/* blank value */
|
|
*defvalue= 0;
|
|
|
|
for(i=0; i<seq_len; i++) {
|
|
EnumPropertyItem tmp= {0, "", 0, "", ""};
|
|
|
|
item= PySequence_Fast_GET_ITEM(seq_fast, i);
|
|
if(PyTuple_Check(item)==0) {
|
|
PyErr_SetString(PyExc_TypeError, "EnumProperty(...): expected a sequence of tuples for the enum items");
|
|
if(items) MEM_freeN(items);
|
|
return NULL;
|
|
}
|
|
|
|
if(!PyArg_ParseTuple(item, "sss", &tmp.identifier, &tmp.name, &tmp.description)) {
|
|
PyErr_SetString(PyExc_TypeError, "EnumProperty(...): expected an identifier, name and description in the tuple");
|
|
return NULL;
|
|
}
|
|
|
|
if(is_enum_flag) {
|
|
tmp.value= 1<<i;
|
|
|
|
if(def && PySet_Contains(def, PyTuple_GET_ITEM(item, 0))) {
|
|
*defvalue |= tmp.value;
|
|
def_used++;
|
|
}
|
|
}
|
|
else {
|
|
tmp.value= i;
|
|
|
|
if(def && def_used == 0 && strcmp(def_cmp, tmp.identifier)==0) {
|
|
*defvalue= tmp.value;
|
|
def_used++; /* only ever 1 */
|
|
}
|
|
}
|
|
|
|
RNA_enum_item_add(&items, &totitem, &tmp);
|
|
}
|
|
|
|
RNA_enum_item_end(&items, &totitem);
|
|
|
|
if(is_enum_flag) {
|
|
/* strict check that all set members were used */
|
|
if(def && def_used != PySet_GET_SIZE(def)) {
|
|
MEM_freeN(items);
|
|
|
|
PyErr_Format(PyExc_TypeError,
|
|
"EnumProperty(..., default={...}): set has %d unused member(s)",
|
|
PySet_GET_SIZE(def) - def_used);
|
|
return NULL;
|
|
}
|
|
}
|
|
else {
|
|
if(def && def_used == 0) {
|
|
MEM_freeN(items);
|
|
|
|
PyErr_Format(PyExc_TypeError,
|
|
"EnumProperty(..., default=\'%s\'): not found in enum members",
|
|
def);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
return items;
|
|
}
|
|
|
|
static EnumPropertyItem *bpy_props_enum_itemf(struct bContext *C, PointerRNA *ptr, PropertyRNA *prop, int *free)
|
|
{
|
|
PyGILState_STATE gilstate;
|
|
|
|
PyObject *py_func= RNA_property_enum_py_data_get(prop);
|
|
PyObject *self= NULL;
|
|
PyObject *args;
|
|
PyObject *items; /* returned from the function call */
|
|
|
|
EnumPropertyItem *eitems= NULL;
|
|
int err= 0;
|
|
|
|
bpy_context_set(C, &gilstate);
|
|
|
|
args= PyTuple_New(2);
|
|
|
|
/* first get self */
|
|
/* operators can store their own instance for later use */
|
|
if(ptr->data) {
|
|
void **instance = RNA_struct_instance(ptr);
|
|
|
|
if(instance) {
|
|
if(*instance) {
|
|
self= *instance;
|
|
Py_INCREF(self);
|
|
}
|
|
}
|
|
}
|
|
if(self == NULL) {
|
|
self= pyrna_struct_CreatePyObject(ptr);
|
|
}
|
|
|
|
PyTuple_SET_ITEM(args, 0, self);
|
|
|
|
/* now get the context */
|
|
PyTuple_SET_ITEM(args, 1, (PyObject *)bpy_context_module);
|
|
Py_INCREF(bpy_context_module);
|
|
|
|
items= PyObject_CallObject(py_func, args);
|
|
|
|
Py_DECREF(args);
|
|
|
|
if(items==NULL) {
|
|
err= -1;
|
|
}
|
|
else {
|
|
PyObject *items_fast;
|
|
int defvalue_dummy=0;
|
|
|
|
if(!(items_fast= PySequence_Fast(items, "EnumProperty(...): return value from the callback was not a sequence"))) {
|
|
err= -1;
|
|
}
|
|
else {
|
|
eitems= enum_items_from_py(items_fast, NULL, &defvalue_dummy, (RNA_property_flag(prop) & PROP_ENUM_FLAG)!=0);
|
|
|
|
Py_DECREF(items_fast);
|
|
|
|
if(!eitems) {
|
|
err= -1;
|
|
}
|
|
}
|
|
|
|
Py_DECREF(items);
|
|
}
|
|
|
|
if(err != -1) { /* worked */
|
|
*free= 1;
|
|
}
|
|
else {
|
|
/* since we return to C code we can't leave the error */
|
|
PyCodeObject *f_code= (PyCodeObject *)PyFunction_GET_CODE(py_func);
|
|
PyErr_Print();
|
|
PyErr_Clear();
|
|
|
|
/* use py style error */
|
|
fprintf(stderr, "File \"%s\", line %d, in %s\n",
|
|
_PyUnicode_AsString(f_code->co_filename),
|
|
f_code->co_firstlineno,
|
|
_PyUnicode_AsString(((PyFunctionObject *)py_func)->func_name)
|
|
);
|
|
|
|
eitems= DummyRNA_NULL_items;
|
|
}
|
|
|
|
|
|
bpy_context_clear(C, &gilstate);
|
|
return eitems;
|
|
}
|
|
|
|
PyDoc_STRVAR(BPy_EnumProperty_doc,
|
|
".. function:: EnumProperty(items, name=\"\", description=\"\", default=\"\", options={'ANIMATABLE'})\n"
|
|
"\n"
|
|
" Returns a new enumerator property definition.\n"
|
|
"\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg default: The default value for this enum, A string when *ENUM_FLAG*\n"
|
|
" is disabled otherwise a set which may only contain string identifiers\n"
|
|
" used in *items*.\n"
|
|
" :type default: string or set\n"
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE', 'ENUM_FLAG'].\n"
|
|
" :type options: set\n"
|
|
" :arg items: sequence of enum items formatted:\n"
|
|
" [(identifier, name, description), ...] where the identifier is used\n"
|
|
" for python access and other values are used for the interface.\n"
|
|
" For dynamic values a callback can be passed which returns a list in\n"
|
|
" the same format as the static list.\n"
|
|
" This function must take 2 arguments (self, context)\n"
|
|
" :type items: sequence of string triplets or a function\n"
|
|
);
|
|
static PyObject *BPy_EnumProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(EnumProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "items", "name", "description", "default", "options", NULL};
|
|
const char *id=NULL, *name="", *description="";
|
|
PyObject *def= NULL;
|
|
int id_len;
|
|
int defvalue=0;
|
|
PyObject *items, *items_fast;
|
|
EnumPropertyItem *eitems;
|
|
PropertyRNA *prop;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
short is_itemf= FALSE;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#O|ssOO!:EnumProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&items, &name, &description,
|
|
&def, &PySet_Type, &pyopts))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_CHECK(EnumProperty, property_flag_enum_items)
|
|
|
|
/* items can be a list or a callable */
|
|
if(PyFunction_Check(items)) { /* dont use PyCallable_Check because we need the function code for errors */
|
|
PyCodeObject *f_code= (PyCodeObject *)PyFunction_GET_CODE(items);
|
|
if(f_code->co_argcount != 2) {
|
|
PyErr_Format(PyExc_ValueError,
|
|
"EnumProperty(...): expected 'items' function to take 2 arguments, not %d",
|
|
f_code->co_argcount);
|
|
return NULL;
|
|
}
|
|
|
|
if(def) {
|
|
/* note, using type error here is odd but python does this for invalid arguments */
|
|
PyErr_SetString(PyExc_TypeError,
|
|
"EnumProperty(...): 'default' can't be set when 'items' is a function");
|
|
return NULL;
|
|
}
|
|
|
|
is_itemf= TRUE;
|
|
eitems= DummyRNA_NULL_items;
|
|
}
|
|
else {
|
|
if(!(items_fast= PySequence_Fast(items, "EnumProperty(...): expected a sequence of tuples for the enum items or a function"))) {
|
|
return NULL;
|
|
}
|
|
|
|
eitems= enum_items_from_py(items_fast, def, &defvalue, (opts & PROP_ENUM_FLAG)!=0);
|
|
|
|
Py_DECREF(items_fast);
|
|
|
|
if(!eitems) {
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
if(opts & PROP_ENUM_FLAG) prop= RNA_def_enum_flag(srna, id, eitems, defvalue, name, description);
|
|
else prop= RNA_def_enum(srna, id, eitems, defvalue, name, description);
|
|
|
|
if(is_itemf) {
|
|
RNA_def_enum_funcs(prop, bpy_props_enum_itemf);
|
|
RNA_def_enum_py_data(prop, (void *)items);
|
|
/* Py_INCREF(items); */ /* watch out!, if user is tricky they can probably crash blender if they manage to free the callback, take care! */
|
|
}
|
|
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
|
|
if(is_itemf == FALSE) {
|
|
MEM_freeN(eitems);
|
|
}
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
static StructRNA *pointer_type_from_py(PyObject *value, const char *error_prefix)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
srna= srna_from_self(value, "");
|
|
if(!srna) {
|
|
if(PyErr_Occurred()) {
|
|
PyObject *msg= PyC_ExceptionBuffer();
|
|
char *msg_char= _PyUnicode_AsString(msg);
|
|
PyErr_Format(PyExc_TypeError,
|
|
"%.200s expected an RNA type derived from PropertyGroup, failed with: %s",
|
|
error_prefix, msg_char);
|
|
Py_DECREF(msg);
|
|
}
|
|
else {
|
|
PyErr_Format(PyExc_TypeError,
|
|
"%.200s expected an RNA type derived from PropertyGroup, failed with type '%s'",
|
|
error_prefix, Py_TYPE(value)->tp_name);
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
if(!RNA_struct_is_a(srna, &RNA_PropertyGroup)) {
|
|
PyErr_Format(PyExc_TypeError,
|
|
"%.200s expected an RNA type derived from PropertyGroup",
|
|
error_prefix);
|
|
return NULL;
|
|
}
|
|
|
|
return srna;
|
|
}
|
|
|
|
PyDoc_STRVAR(BPy_PointerProperty_doc,
|
|
".. function:: PointerProperty(type=\"\", description=\"\", options={'ANIMATABLE'})\n"
|
|
"\n"
|
|
" Returns a new pointer property definition.\n"
|
|
"\n"
|
|
" :arg type: A subclass of :class:`bpy.types.PropertyGroup`.\n"
|
|
" :type type: class\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE'].\n"
|
|
" :type options: set\n"
|
|
);
|
|
static PyObject *BPy_PointerProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(PointerProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "type", "name", "description", "options", NULL};
|
|
const char *id=NULL, *name="", *description="";
|
|
int id_len;
|
|
PropertyRNA *prop;
|
|
StructRNA *ptype;
|
|
PyObject *type= Py_None;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#O|ssO!:PointerProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&type, &name, &description,
|
|
&PySet_Type, &pyopts))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_CHECK(PointerProperty, property_flag_items)
|
|
|
|
ptype= pointer_type_from_py(type, "PointerProperty(...):");
|
|
if(!ptype)
|
|
return NULL;
|
|
|
|
prop= RNA_def_pointer_runtime(srna, id, ptype, name, description);
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(BPy_CollectionProperty_doc,
|
|
".. function:: CollectionProperty(items, type=\"\", description=\"\", default=\"\", options={'ANIMATABLE'})\n"
|
|
"\n"
|
|
" Returns a new collection property definition.\n"
|
|
"\n"
|
|
" :arg type: A subclass of :class:`bpy.types.PropertyGroup`.\n"
|
|
" :type type: class\n"
|
|
BPY_PROPDEF_NAME_DOC
|
|
BPY_PROPDEF_DESC_DOC
|
|
" :arg options: Enumerator in ['HIDDEN', 'ANIMATABLE'].\n"
|
|
" :type options: set\n"
|
|
);
|
|
static PyObject *BPy_CollectionProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
BPY_PROPDEF_HEAD(CollectionProperty)
|
|
|
|
if(srna) {
|
|
static const char *kwlist[]= {"attr", "type", "name", "description", "options", NULL};
|
|
const char *id=NULL, *name="", *description="";
|
|
int id_len;
|
|
PropertyRNA *prop;
|
|
StructRNA *ptype;
|
|
PyObject *type= Py_None;
|
|
PyObject *pyopts= NULL;
|
|
int opts=0;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s#O|ssO!:CollectionProperty",
|
|
(char **)kwlist, &id, &id_len,
|
|
&type, &name, &description,
|
|
&PySet_Type, &pyopts))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
BPY_PROPDEF_CHECK(CollectionProperty, property_flag_items)
|
|
|
|
ptype= pointer_type_from_py(type, "CollectionProperty(...):");
|
|
if(!ptype)
|
|
return NULL;
|
|
|
|
prop= RNA_def_collection_runtime(srna, id, ptype, name, description);
|
|
if(pyopts) {
|
|
if(opts & PROP_HIDDEN) RNA_def_property_flag(prop, PROP_HIDDEN);
|
|
if((opts & PROP_ANIMATABLE)==0) RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
|
|
}
|
|
RNA_def_property_duplicate_pointers(srna, prop);
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(BPy_RemoveProperty_doc,
|
|
".. function:: RemoveProperty(attr)\n"
|
|
"\n"
|
|
" Removes a dynamically defined property.\n"
|
|
"\n"
|
|
" :arg attr: Property name.\n"
|
|
" :type attr: string\n"
|
|
);
|
|
static PyObject *BPy_RemoveProperty(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
StructRNA *srna;
|
|
|
|
if(PyTuple_GET_SIZE(args) == 1) {
|
|
PyObject *ret;
|
|
self= PyTuple_GET_ITEM(args, 0);
|
|
args= PyTuple_New(0);
|
|
ret= BPy_RemoveProperty(self, args, kw);
|
|
Py_DECREF(args);
|
|
return ret;
|
|
}
|
|
else if (PyTuple_GET_SIZE(args) > 1) {
|
|
PyErr_SetString(PyExc_ValueError, "all args must be keywords"); \
|
|
return NULL;
|
|
}
|
|
|
|
srna= srna_from_self(self, "RemoveProperty(...):");
|
|
if(srna==NULL && PyErr_Occurred()) {
|
|
return NULL; /* self's type was compatible but error getting the srna */
|
|
}
|
|
else if(srna==NULL) {
|
|
PyErr_SetString(PyExc_TypeError, "RemoveProperty(): struct rna not available for this type");
|
|
return NULL;
|
|
}
|
|
else {
|
|
static const char *kwlist[]= {"attr", NULL};
|
|
|
|
char *id=NULL;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kw,
|
|
"s:RemoveProperty",
|
|
(char **)kwlist, &id))
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
if(RNA_def_property_free_identifier(srna, id) != 1) {
|
|
PyErr_Format(PyExc_TypeError, "RemoveProperty(): '%s' not a defined dynamic property", id);
|
|
return NULL;
|
|
}
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
static struct PyMethodDef props_methods[]= {
|
|
{"BoolProperty", (PyCFunction)BPy_BoolProperty, METH_VARARGS|METH_KEYWORDS, BPy_BoolProperty_doc},
|
|
{"BoolVectorProperty", (PyCFunction)BPy_BoolVectorProperty, METH_VARARGS|METH_KEYWORDS, BPy_BoolVectorProperty_doc},
|
|
{"IntProperty", (PyCFunction)BPy_IntProperty, METH_VARARGS|METH_KEYWORDS, BPy_IntProperty_doc},
|
|
{"IntVectorProperty", (PyCFunction)BPy_IntVectorProperty, METH_VARARGS|METH_KEYWORDS, BPy_IntVectorProperty_doc},
|
|
{"FloatProperty", (PyCFunction)BPy_FloatProperty, METH_VARARGS|METH_KEYWORDS, BPy_FloatProperty_doc},
|
|
{"FloatVectorProperty", (PyCFunction)BPy_FloatVectorProperty, METH_VARARGS|METH_KEYWORDS, BPy_FloatVectorProperty_doc},
|
|
{"StringProperty", (PyCFunction)BPy_StringProperty, METH_VARARGS|METH_KEYWORDS, BPy_StringProperty_doc},
|
|
{"EnumProperty", (PyCFunction)BPy_EnumProperty, METH_VARARGS|METH_KEYWORDS, BPy_EnumProperty_doc},
|
|
{"PointerProperty", (PyCFunction)BPy_PointerProperty, METH_VARARGS|METH_KEYWORDS, BPy_PointerProperty_doc},
|
|
{"CollectionProperty", (PyCFunction)BPy_CollectionProperty, METH_VARARGS|METH_KEYWORDS, BPy_CollectionProperty_doc},
|
|
|
|
{"RemoveProperty", (PyCFunction)BPy_RemoveProperty, METH_VARARGS|METH_KEYWORDS, BPy_RemoveProperty_doc},
|
|
{NULL, NULL, 0, NULL}
|
|
};
|
|
|
|
static struct PyModuleDef props_module= {
|
|
PyModuleDef_HEAD_INIT,
|
|
"bpy.props",
|
|
"This module defines properties to extend blenders internal data, the result of these functions"
|
|
" is used to assign properties to classes registered with blender and can't be used directly.",
|
|
-1,/* multiple "initialization" just copies the module dict. */
|
|
props_methods,
|
|
NULL, NULL, NULL, NULL
|
|
};
|
|
|
|
PyObject *BPY_rna_props( void )
|
|
{
|
|
PyObject *submodule;
|
|
PyObject *submodule_dict;
|
|
|
|
submodule= PyModule_Create(&props_module);
|
|
PyDict_SetItemString(PyImport_GetModuleDict(), props_module.m_name, submodule);
|
|
|
|
/* INCREF since its its assumed that all these functions return the
|
|
* module with a new ref like PyDict_New, since they are passed to
|
|
* PyModule_AddObject which steals a ref */
|
|
Py_INCREF(submodule);
|
|
|
|
/* api needs the PyObjects internally */
|
|
submodule_dict= PyModule_GetDict(submodule);
|
|
|
|
#define ASSIGN_STATIC(_name) pymeth_##_name= PyDict_GetItemString(submodule_dict, #_name)
|
|
|
|
ASSIGN_STATIC(BoolProperty);
|
|
ASSIGN_STATIC(BoolVectorProperty);
|
|
ASSIGN_STATIC(IntProperty);
|
|
ASSIGN_STATIC(IntVectorProperty);
|
|
ASSIGN_STATIC(FloatProperty);
|
|
ASSIGN_STATIC(FloatVectorProperty);
|
|
ASSIGN_STATIC(StringProperty);
|
|
ASSIGN_STATIC(EnumProperty);
|
|
ASSIGN_STATIC(PointerProperty);
|
|
ASSIGN_STATIC(CollectionProperty);
|
|
ASSIGN_STATIC(RemoveProperty);
|
|
|
|
return submodule;
|
|
}
|