bpy_props.c

Go to the documentation of this file.

/*
 * ***** 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 *****
 */

#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"

/* initial definition of callback slots we'll probably have more then 1 */
#define BPY_DATA_CB_SLOT_SIZE 1

#define BPY_DATA_CB_SLOT_UPDATE 0

extern BPy_StructRNA *bpy_context_module;

static EnumPropertyItem property_flag_items[] = {
    {PROP_HIDDEN, "HIDDEN", 0, "Hidden", ""},
    {PROP_SKIP_SAVE, "SKIP_SAVE", 0, "Skip Save", ""},
    {PROP_ANIMATABLE, "ANIMATABLE", 0, "Animateable", ""},
    {0, NULL, 0, NULL, NULL}};

static EnumPropertyItem property_flag_enum_items[] = {
    {PROP_HIDDEN, "HIDDEN", 0, "Hidden", ""},
    {PROP_SKIP_SAVE, "SKIP_SAVE", 0, "Skip Save", ""},
    {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_BYTESTRING, "BYTE_STRING", 0, "Byte String", ""},
    {PROP_TRANSLATE, "TRANSLATE", 0, "Translate", ""},

    {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;

static PyObject *pyrna_struct_as_instance(PointerRNA *ptr)
{
    PyObject *self = NULL;
    /* 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);
            }
        }
    }

    /* in most cases this will run */
    if (self == NULL) {
        self = pyrna_struct_CreatePyObject(ptr);
    }

    return self;
}

/* could be moved into bpy_utils */
static void printf_func_error(PyObject *py_func)
{
    /* 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)
            );
}

/* 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;
}

/* callbacks */
static void bpy_prop_update_cb(struct bContext *C, struct PointerRNA *ptr, struct PropertyRNA *prop)
{
    PyGILState_STATE gilstate;
    PyObject **py_data = (PyObject **)RNA_property_py_data_get(prop);
    PyObject *py_func;
    PyObject *args;
    PyObject *self;
    PyObject *ret;
    const int is_write_ok = pyrna_write_check();

    BLI_assert(py_data != NULL);

    if (!is_write_ok) {
        pyrna_write_set(TRUE);
    }

    bpy_context_set(C, &gilstate);

    py_func = py_data[BPY_DATA_CB_SLOT_UPDATE];

    args = PyTuple_New(2);
    self = pyrna_struct_as_instance(ptr);
    PyTuple_SET_ITEM(args, 0, self);

    PyTuple_SET_ITEM(args, 1, (PyObject *)bpy_context_module);
    Py_INCREF(bpy_context_module);

    ret = PyObject_CallObject(py_func, args);

    Py_DECREF(args);

    if (ret == NULL) {
        printf_func_error(py_func);
    }
    else {
        if (ret != Py_None) {
            PyErr_SetString(PyExc_ValueError, "the return value must be None");
            printf_func_error(py_func);
        }

        Py_DECREF(ret);
    }

    bpy_context_clear(C, &gilstate);

    if (!is_write_ok) {
        pyrna_write_set(FALSE);
    }
}

static int bpy_prop_callback_check(PyObject *py_func, int argcount)
{
    if (py_func && py_func != Py_None) {
        if (!PyFunction_Check(py_func)) {
            PyErr_Format(PyExc_TypeError,
                         "update keyword: expected a function type, not a %.200s",
                         Py_TYPE(py_func)->tp_name);
            return -1;
        }
        else {
            PyCodeObject *f_code = (PyCodeObject *)PyFunction_GET_CODE(py_func);
            if (f_code->co_argcount != argcount) {
                PyErr_Format(PyExc_TypeError,
                             "update keyword: expected a function taking %d arguments, not %d",
                             argcount, f_code->co_argcount);
                return -1;
            }
        }
    }

    return 0;
}


static int bpy_prop_callback_assign(struct PropertyRNA *prop, PyObject *update_cb)
{
    /* assume this is already checked for type and arg length */
    if (update_cb) {
        PyObject **py_data = MEM_callocN(sizeof(PyObject *) * BPY_DATA_CB_SLOT_SIZE, __func__);
        RNA_def_property_update_runtime(prop, (void *)bpy_prop_update_cb);
        py_data[BPY_DATA_CB_SLOT_UPDATE] = update_cb;
        RNA_def_py_data(prop, py_data);

        RNA_def_property_flag(prop, PROP_CONTEXT_PROPERTY_UPDATE);
    }

    return 0;
}

/* utility function we need for parsing int's in an if statement */
static int py_long_as_int(PyObject *py_long, int *r_int)
{
    if (PyLong_CheckExact(py_long)) {
        *r_int = (int)PyLong_AS_LONG(py_long);
        return 0;
    }
    else {
        return -1;
    }
}

/* 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(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" \


#define BPY_PROPDEF_UNIT_DOC \
"   :arg unit: Enumerator in ['NONE', 'LENGTH', 'AREA', 'VOLUME', 'ROTATION', 'TIME', 'VELOCITY', 'ACCELERATION'].\n" \
"   :type unit: string\n"   \


#define BPY_PROPDEF_UPDATE_DOC \
"   :arg update: function to be called when this value is modified,\n" \
"      This function must take 2 values (self, context) and return None.\n" \
"   :type update: function\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 along.
 * 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', update=None)\n"
"\n"
"   Returns a new boolean property definition.\n"
"\n"
BPY_PROPDEF_NAME_DOC
BPY_PROPDEF_DESC_DOC
"   :arg options: Enumerator in ['HIDDEN', 'SKIP_SAVE', 'ANIMATABLE'].\n"
"   :type options: set\n"
"   :arg subtype: Enumerator in ['UNSIGNED', 'PERCENTAGE', 'FACTOR', 'ANGLE', 'TIME', 'DISTANCE', 'NONE'].\n"
"   :type subtype: string\n"
BPY_PROPDEF_UPDATE_DOC
);
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", "update", NULL};
        const char *id = NULL, *name = NULL, *description = "";
        int id_len;
        int def = 0;
        PropertyRNA *prop;
        PyObject *pyopts = NULL;
        int opts = 0;
        char *pysubtype = NULL;
        int subtype = PROP_NONE;
        PyObject *update_cb = NULL;

        if (!PyArg_ParseTupleAndKeywords(args, kw,
                                         "s#|ssiO!sO:BoolProperty",
                                         (char **)kwlist, &id, &id_len,
                                         &name, &description, &def,
                                         &PySet_Type, &pyopts, &pysubtype,
                                         &update_cb))
        {
            return NULL;
        }

        BPY_PROPDEF_SUBTYPE_CHECK(BoolProperty, property_flag_items, property_subtype_number_items)

        if (bpy_prop_callback_check(update_cb, 2) == -1) {
            return NULL;
        }

        prop = RNA_def_property(srna, id, PROP_BOOLEAN, subtype);
        RNA_def_property_boolean_default(prop, def);
        RNA_def_property_ui_text(prop, name ? name : id, 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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        bpy_prop_callback_assign(prop, update_cb);
        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, update=None)\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', 'SKIP_SAVE', '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"
BPY_PROPDEF_UPDATE_DOC
);
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", "update", NULL};
        const char *id = NULL, *name = NULL, *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;
        PyObject *update_cb = NULL;

        if (!PyArg_ParseTupleAndKeywords(args, kw,
                                         "s#|ssOO!siO:BoolVectorProperty",
                                         (char **)kwlist, &id, &id_len,
                                         &name, &description, &pydef,
                                         &PySet_Type, &pyopts, &pysubtype, &size,
                                         &update_cb))
        {
            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, FALSE, "BoolVectorProperty(default=sequence)") < 0)
            return NULL;

        if (bpy_prop_callback_check(update_cb, 2) == -1) {
            return NULL;
        }

        // prop = RNA_def_boolean_array(srna, id, size, pydef ? def:NULL, name ? name : id, 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 ? name : id, 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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        bpy_prop_callback_assign(prop, update_cb);
        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', update=None)\n"
"\n"
"   Returns a new int property definition.\n"
"\n"
BPY_PROPDEF_NAME_DOC
BPY_PROPDEF_DESC_DOC
"   :arg options: Enumerator in ['HIDDEN', 'SKIP_SAVE', 'ANIMATABLE'].\n"
"   :type options: set\n"
"   :arg subtype: Enumerator in ['UNSIGNED', 'PERCENTAGE', 'FACTOR', 'ANGLE', 'TIME', 'DISTANCE', 'NONE'].\n"
"   :type subtype: string\n"
BPY_PROPDEF_UPDATE_DOC
);
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", "update", NULL};
        const char *id = NULL, *name = NULL, *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;
        PyObject *update_cb = NULL;

        if (!PyArg_ParseTupleAndKeywords(args, kw,
                                         "s#|ssiiiiiiO!sO:IntProperty",
                                         (char **)kwlist, &id, &id_len,
                                         &name, &description, &def,
                                         &min, &max, &soft_min, &soft_max,
                                         &step, &PySet_Type, &pyopts, &pysubtype,
                                         &update_cb))
        {
            return NULL;
        }

        BPY_PROPDEF_SUBTYPE_CHECK(IntProperty, property_flag_items, property_subtype_number_items)

        if (bpy_prop_callback_check(update_cb, 2) == -1) {
            return NULL;
        }

        prop = RNA_def_property(srna, id, PROP_INT, subtype);
        RNA_def_property_int_default(prop, def);
        RNA_def_property_ui_text(prop, name ? name : id, description);
        RNA_def_property_range(prop, min, max);
        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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        bpy_prop_callback_assign(prop, update_cb);
        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, update=None)\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', 'SKIP_SAVE', '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"
BPY_PROPDEF_UPDATE_DOC
);
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", "update", NULL};
        const char *id = NULL, *name = NULL, *description = "";
        int id_len;
        int min = INT_MIN, max = INT_MAX, soft_min = INT_MIN, soft_max = INT_MAX, step = 1;
        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;
        PyObject *update_cb = NULL;

        if (!PyArg_ParseTupleAndKeywords(args, kw,
                                         "s#|ssOiiiiiO!siO:IntVectorProperty",
                                         (char **)kwlist, &id, &id_len,
                                         &name, &description, &pydef,
                                         &min, &max, &soft_min, &soft_max,
                                         &step, &PySet_Type, &pyopts,
                                         &pysubtype, &size,
                                         &update_cb))
        {
            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, FALSE, "IntVectorProperty(default=sequence)") < 0)
            return NULL;

        if (bpy_prop_callback_check(update_cb, 2) == -1) {
            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 ? name : id, 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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        bpy_prop_callback_assign(prop, update_cb);
        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', update=None)\n"
"\n"
"   Returns a new float property definition.\n"
"\n"
BPY_PROPDEF_NAME_DOC
BPY_PROPDEF_DESC_DOC
"   :arg options: Enumerator in ['HIDDEN', 'SKIP_SAVE', 'ANIMATABLE'].\n"
"   :type options: set\n"
"   :arg subtype: Enumerator in ['UNSIGNED', 'PERCENTAGE', 'FACTOR', 'ANGLE', 'TIME', 'DISTANCE', 'NONE'].\n"
"   :type subtype: string\n"
BPY_PROPDEF_UNIT_DOC
BPY_PROPDEF_UPDATE_DOC
);
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", "update", NULL};
        const char *id = NULL, *name = NULL, *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;
        PyObject *update_cb = NULL;

        if (!PyArg_ParseTupleAndKeywords(args, kw,
                                         "s#|ssffffffiO!ssO:FloatProperty",
                                         (char **)kwlist, &id, &id_len,
                                         &name, &description, &def,
                                         &min, &max, &soft_min, &soft_max,
                                         &step, &precision, &PySet_Type,
                                         &pyopts, &pysubtype, &pyunit,
                                         &update_cb))
        {
            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", pyunit);
            return NULL;
        }

        if (bpy_prop_callback_check(update_cb, 2) == -1) {
            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 ? name : id, 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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        bpy_prop_callback_assign(prop, update_cb);
        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, update=None)\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', 'SKIP_SAVE', '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"
BPY_PROPDEF_UNIT_DOC
"   :arg size: Vector dimensions in [1, and " STRINGIFY(PYRNA_STACK_ARRAY) "].\n"
"   :type size: int\n"
BPY_PROPDEF_UPDATE_DOC
);
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", "unit", "size", "update", NULL};
        const char *id = NULL, *name = NULL, *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;
        char *pyunit = NULL;
        int unit = PROP_UNIT_NONE;
        PyObject *update_cb = NULL;

        if (!PyArg_ParseTupleAndKeywords(args, kw,
                                         "s#|ssOfffffiO!ssiO:FloatVectorProperty",
                                         (char **)kwlist, &id, &id_len,
                                         &name, &description, &pydef,
                                         &min, &max, &soft_min, &soft_max,
                                         &step, &precision, &PySet_Type,
                                         &pyopts, &pysubtype, &pyunit, &size,
                                         &update_cb))
        {
            return NULL;
        }

        BPY_PROPDEF_SUBTYPE_CHECK(FloatVectorProperty, property_flag_items, property_subtype_array_items)

        if (pyunit && RNA_enum_value_from_id(property_unit_items, pyunit, &unit) == 0) {
            PyErr_Format(PyExc_TypeError, "FloatVectorProperty(unit='%s'): invalid unit", pyunit);
            return NULL;
        }

        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, FALSE, "FloatVectorProperty(default=sequence)") < 0)
            return NULL;

        if (bpy_prop_callback_check(update_cb, 2) == -1) {
            return NULL;
        }

        prop = RNA_def_property(srna, id, PROP_FLOAT, subtype | unit);
        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 ? name : id, 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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        bpy_prop_callback_assign(prop, update_cb);
        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', update=None)\n"
"\n"
"   Returns a new string property definition.\n"
"\n"
BPY_PROPDEF_NAME_DOC
BPY_PROPDEF_DESC_DOC
"   :arg options: Enumerator in ['HIDDEN', 'SKIP_SAVE', 'ANIMATABLE'].\n"
"   :type options: set\n"
"   :arg subtype: Enumerator in ['FILE_PATH', 'DIR_PATH', 'FILENAME', 'NONE'].\n"
"   :type subtype: string\n"
BPY_PROPDEF_UPDATE_DOC
);
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", "update", NULL};
        const char *id = NULL, *name = NULL, *description = "", *def = "";
        int id_len;
        int maxlen = 0;
        PropertyRNA *prop;
        PyObject *pyopts = NULL;
        int opts = 0;
        char *pysubtype = NULL;
        int subtype = PROP_NONE;
        PyObject *update_cb = NULL;

        if (!PyArg_ParseTupleAndKeywords(args, kw,
                                         "s#|sssiO!sO:StringProperty",
                                         (char **)kwlist, &id, &id_len,
                                         &name, &description, &def,
                                         &maxlen, &PySet_Type, &pyopts, &pysubtype,
                                         &update_cb))
        {
            return NULL;
        }

        BPY_PROPDEF_SUBTYPE_CHECK(StringProperty, property_flag_items, property_subtype_string_items)

        if (bpy_prop_callback_check(update_cb, 2) == -1) {
            return NULL;
        }

        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 ? name : id, 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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        bpy_prop_callback_assign(prop, update_cb);
        RNA_def_property_duplicate_pointers(srna, prop);
    }
    Py_RETURN_NONE;
}

#if 0
/* copies orig to buf, then sets orig to buf, returns copy length */
static size_t strswapbufcpy(char *buf, const char **orig)
{
    const char *src = *orig;
    char *dst = buf;
    size_t i = 0;
    *orig = buf;
    while ((*dst = *src)) { dst++; src++; i++; }
    return i + 1; /* include '\0' */
}
#endif

static EnumPropertyItem *enum_items_from_py(PyObject *seq_fast, PyObject *def, int *defvalue, const short is_enum_flag)
{
    EnumPropertyItem *items;
    PyObject *item;
    const Py_ssize_t seq_len = PySequence_Fast_GET_SIZE(seq_fast);
    Py_ssize_t totbuf = 0;
    int i;
    short def_used = 0;
    const char *def_cmp = NULL;

    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;

    items = MEM_callocN(sizeof(EnumPropertyItem) * (seq_len + 1), "enum_items_from_py1");

    for (i = 0; i < seq_len; i++) {
        EnumPropertyItem tmp = {0, "", 0, "", ""};
        Py_ssize_t item_size;
        Py_ssize_t id_str_size;
        Py_ssize_t name_str_size;
        Py_ssize_t desc_str_size;

        item = PySequence_Fast_GET_ITEM(seq_fast, i);

        if ( (PyTuple_CheckExact(item)) &&
             (item_size = PyTuple_GET_SIZE(item)) &&
             (item_size == 3 || item_size == 4) &&
             (tmp.identifier =  _PyUnicode_AsStringAndSize(PyTuple_GET_ITEM(item, 0), &id_str_size)) &&
             (tmp.name =        _PyUnicode_AsStringAndSize(PyTuple_GET_ITEM(item, 1), &name_str_size)) &&
             (tmp.description = _PyUnicode_AsStringAndSize(PyTuple_GET_ITEM(item, 2), &desc_str_size)) &&
             (item_size < 4 || py_long_as_int(PyTuple_GET_ITEM(item, 3), &tmp.value) != -1)) /* TODO, number isnt ensured to be unique from the script author */
        {
            if (is_enum_flag) {
                if (item_size < 4) {
                    tmp.value = 1 << i;
                }

                if (def && PySet_Contains(def, PyTuple_GET_ITEM(item, 0))) {
                    *defvalue |= tmp.value;
                    def_used++;
                }
            }
            else {
                if (item_size < 4) {
                    tmp.value = i;
                }

                if (def && def_used == 0 && strcmp(def_cmp, tmp.identifier) == 0) {
                    *defvalue = tmp.value;
                    def_used++; /* only ever 1 */
                }
            }

            items[i] = tmp;

            /* calculate combine string length */
            totbuf += id_str_size + name_str_size + desc_str_size + 3; /* 3 is for '\0's */
        }
        else {
            MEM_freeN(items);
            PyErr_SetString(PyExc_TypeError,
                            "EnumProperty(...): expected an tuple containing "
                            "(identifier, name description) and optionally a "
                            "unique number");
            return NULL;
        }

    }

    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_cmp);
            return NULL;
        }
    }

    /* disabled duplicating strings because the array can still be freed and
     * the strings from it referenced, for now we can't support dynamically
     * created strings from python. */
#if 0
    /* this would all work perfectly _but_ the python strings may be freed
     * immediately after use, so we need to duplicate them, ugh.
     * annoying because it works most of the time without this. */
    {
        EnumPropertyItem *items_dup = MEM_mallocN((sizeof(EnumPropertyItem) * (seq_len + 1)) + (sizeof(char) * totbuf),
                                                 "enum_items_from_py2");
        EnumPropertyItem *items_ptr = items_dup;
        char *buf = ((char *)items_dup) + (sizeof(EnumPropertyItem) * (seq_len + 1));
        memcpy(items_dup, items, sizeof(EnumPropertyItem) * (seq_len + 1));
        for (i = 0; i < seq_len; i++, items_ptr++) {
            buf += strswapbufcpy(buf, &items_ptr->identifier);
            buf += strswapbufcpy(buf, &items_ptr->name);
            buf += strswapbufcpy(buf, &items_ptr->description);
        }
        MEM_freeN(items);
        items = items_dup;
    }
    /* end string duplication */
#endif

    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);
    self = pyrna_struct_as_instance(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 {
        printf_func_error(py_func);

        eitems = DummyRNA_NULL_items;
    }


    bpy_context_clear(C, &gilstate);
    return eitems;
}

PyDoc_STRVAR(BPy_EnumProperty_doc,
".. function:: EnumProperty(items, name=\"\", description=\"\", default=\"\", options={'ANIMATABLE'}, update=None)\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', 'SKIP_SAVE', 'ANIMATABLE', 'ENUM_FLAG'].\n"
"   :type options: set\n"
"   :arg items: sequence of enum items formatted:\n"
"      [(identifier, name, description, number), ...] where the identifier is used\n"
"      for python access and other values are used for the interface.\n"
"      Note the item is optional.\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"
BPY_PROPDEF_UPDATE_DOC
);
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", "update", NULL};
        const char *id = NULL, *name = NULL, *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;
        PyObject *update_cb = NULL;

        if (!PyArg_ParseTupleAndKeywords(args, kw,
                                         "s#O|ssOO!O:EnumProperty",
                                         (char **)kwlist, &id, &id_len,
                                         &items, &name, &description,
                                         &def, &PySet_Type, &pyopts,
                                         &update_cb))
        {
            return NULL;
        }

        BPY_PROPDEF_CHECK(EnumProperty, property_flag_enum_items)

        if (bpy_prop_callback_check(update_cb, 2) == -1) {
            return NULL;
        }

        /* 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 ? name : id, description);
        else                        prop = RNA_def_enum(srna, id, eitems, defvalue, name ? name : id, description);

        if (is_itemf) {
            RNA_def_enum_funcs(prop, bpy_props_enum_itemf);
            RNA_def_enum_py_data(prop, (void *)items);

            /* watch out!, if a user is tricky they can probably crash blender
             * if they manage to free the callback, take care! */
            /* Py_INCREF(items); */
        }

        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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        bpy_prop_callback_assign(prop, update_cb);
        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();
            const 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'}, update=None)\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', 'SKIP_SAVE', 'ANIMATABLE'].\n"
"   :type options: set\n"
BPY_PROPDEF_UPDATE_DOC
);
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", "update", NULL};
        const char *id = NULL, *name = NULL, *description = "";
        int id_len;
        PropertyRNA *prop;
        StructRNA *ptype;
        PyObject *type = Py_None;
        PyObject *pyopts = NULL;
        int opts = 0;
        PyObject *update_cb = NULL;

        if (!PyArg_ParseTupleAndKeywords(args, kw,
                                         "s#O|ssO!O:PointerProperty",
                                         (char **)kwlist, &id, &id_len,
                                         &type, &name, &description,
                                         &PySet_Type, &pyopts,
                                         &update_cb))
        {
            return NULL;
        }

        BPY_PROPDEF_CHECK(PointerProperty, property_flag_items)

        ptype = pointer_type_from_py(type, "PointerProperty(...):");
        if (!ptype)
            return NULL;

        if (bpy_prop_callback_check(update_cb, 2) == -1) {
            return NULL;
        }

        prop = RNA_def_pointer_runtime(srna, id, ptype, name ? name : id, 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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        bpy_prop_callback_assign(prop, update_cb);
        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', 'SKIP_SAVE', '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 = NULL, *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 ? name : id, 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);
            if (opts & PROP_SKIP_SAVE) RNA_def_property_flag(prop, PROP_SKIP_SAVE);
        }
        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;
}