Major documentation updates. The original Freestyle API reference
(http://freestyle.sourceforge.net/doc/html/index.html) has been incorporated into the Blender/Freestyle Python API implementation in the form of Sphinx-based embedded docstrings. Some C++-specific descriptions of classes and functions were revised so that they are suitable for Python programmers. Missing docstrings were filled, and sparse descriptions were extended. By means of the new documentation system for Blender, an up-to-date Freestyle Python API reference will be part of the Blender 2.5 documentation.
This commit is contained in:
@@ -14,67 +14,6 @@ extern "C" {
|
||||
|
||||
///////////////////////////////////////////////////////////////////////////////////////////
|
||||
|
||||
/*--------------- Python API function prototypes for UnaryFunction1DVectorViewShape instance -----------*/
|
||||
static int UnaryFunction1DVectorViewShape___init__(BPy_UnaryFunction1DVectorViewShape* self, PyObject *args);
|
||||
static void UnaryFunction1DVectorViewShape___dealloc__(BPy_UnaryFunction1DVectorViewShape* self);
|
||||
static PyObject * UnaryFunction1DVectorViewShape___repr__(BPy_UnaryFunction1DVectorViewShape* self);
|
||||
|
||||
static PyObject * UnaryFunction1DVectorViewShape_getName( BPy_UnaryFunction1DVectorViewShape *self);
|
||||
static PyObject * UnaryFunction1DVectorViewShape___call__( BPy_UnaryFunction1DVectorViewShape *self, PyObject *args, PyObject *kwds);
|
||||
static PyObject * UnaryFunction1DVectorViewShape_setIntegrationType(BPy_UnaryFunction1DVectorViewShape* self, PyObject *args);
|
||||
static PyObject * UnaryFunction1DVectorViewShape_getIntegrationType(BPy_UnaryFunction1DVectorViewShape* self);
|
||||
|
||||
/*----------------------UnaryFunction1DVectorViewShape instance definitions ----------------------------*/
|
||||
static PyMethodDef BPy_UnaryFunction1DVectorViewShape_methods[] = {
|
||||
{"getName", ( PyCFunction ) UnaryFunction1DVectorViewShape_getName, METH_NOARGS, "() Returns the string of the name of the unary 1D function."},
|
||||
{"setIntegrationType", ( PyCFunction ) UnaryFunction1DVectorViewShape_setIntegrationType, METH_VARARGS, "(IntegrationType i) Sets the integration method" },
|
||||
{"getIntegrationType", ( PyCFunction ) UnaryFunction1DVectorViewShape_getIntegrationType, METH_NOARGS, "() Returns the integration method." },
|
||||
{NULL, NULL, 0, NULL}
|
||||
};
|
||||
|
||||
/*-----------------------BPy_UnaryFunction1DVectorViewShape type definition ------------------------------*/
|
||||
|
||||
PyTypeObject UnaryFunction1DVectorViewShape_Type = {
|
||||
PyVarObject_HEAD_INIT(NULL, 0)
|
||||
"UnaryFunction1DVectorViewShape", /* tp_name */
|
||||
sizeof(BPy_UnaryFunction1DVectorViewShape), /* tp_basicsize */
|
||||
0, /* tp_itemsize */
|
||||
(destructor)UnaryFunction1DVectorViewShape___dealloc__, /* tp_dealloc */
|
||||
0, /* tp_print */
|
||||
0, /* tp_getattr */
|
||||
0, /* tp_setattr */
|
||||
0, /* tp_reserved */
|
||||
(reprfunc)UnaryFunction1DVectorViewShape___repr__, /* tp_repr */
|
||||
0, /* tp_as_number */
|
||||
0, /* tp_as_sequence */
|
||||
0, /* tp_as_mapping */
|
||||
0, /* tp_hash */
|
||||
(ternaryfunc)UnaryFunction1DVectorViewShape___call__, /* tp_call */
|
||||
0, /* tp_str */
|
||||
0, /* tp_getattro */
|
||||
0, /* tp_setattro */
|
||||
0, /* tp_as_buffer */
|
||||
Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
|
||||
"UnaryFunction1DVectorViewShape objects", /* tp_doc */
|
||||
0, /* tp_traverse */
|
||||
0, /* tp_clear */
|
||||
0, /* tp_richcompare */
|
||||
0, /* tp_weaklistoffset */
|
||||
0, /* tp_iter */
|
||||
0, /* tp_iternext */
|
||||
BPy_UnaryFunction1DVectorViewShape_methods, /* tp_methods */
|
||||
0, /* tp_members */
|
||||
0, /* tp_getset */
|
||||
&UnaryFunction1D_Type, /* tp_base */
|
||||
0, /* tp_dict */
|
||||
0, /* tp_descr_get */
|
||||
0, /* tp_descr_set */
|
||||
0, /* tp_dictoffset */
|
||||
(initproc)UnaryFunction1DVectorViewShape___init__, /* tp_init */
|
||||
0, /* tp_alloc */
|
||||
0, /* tp_new */
|
||||
};
|
||||
|
||||
//-------------------MODULE INITIALIZATION--------------------------------
|
||||
|
||||
int UnaryFunction1DVectorViewShape_Init( PyObject *module ) {
|
||||
@@ -105,10 +44,26 @@ int UnaryFunction1DVectorViewShape_Init( PyObject *module ) {
|
||||
return 0;
|
||||
}
|
||||
|
||||
|
||||
//------------------------INSTANCE METHODS ----------------------------------
|
||||
|
||||
int UnaryFunction1DVectorViewShape___init__(BPy_UnaryFunction1DVectorViewShape* self, PyObject *args)
|
||||
static char UnaryFunction1DVectorViewShape___doc__[] =
|
||||
"Base class for unary functions (functors) that work on\n"
|
||||
":class:`Interface1D` and return a list of :class:`ViewShape`\n"
|
||||
"objects.\n"
|
||||
"\n"
|
||||
".. method:: __init__()\n"
|
||||
"\n"
|
||||
" Default constructor.\n"
|
||||
"\n"
|
||||
".. method:: __init__(integration)\n"
|
||||
"\n"
|
||||
" Builds a unary 1D function using the integration method given as\n"
|
||||
" argument.\n"
|
||||
"\n"
|
||||
" :arg integration: An integration method.\n"
|
||||
" :type integration: :class:`IntegrationType`\n";
|
||||
|
||||
static int UnaryFunction1DVectorViewShape___init__(BPy_UnaryFunction1DVectorViewShape* self, PyObject *args)
|
||||
{
|
||||
PyObject *obj = 0;
|
||||
|
||||
@@ -126,25 +81,32 @@ int UnaryFunction1DVectorViewShape___init__(BPy_UnaryFunction1DVectorViewShape*
|
||||
return 0;
|
||||
}
|
||||
|
||||
void UnaryFunction1DVectorViewShape___dealloc__(BPy_UnaryFunction1DVectorViewShape* self)
|
||||
static void UnaryFunction1DVectorViewShape___dealloc__(BPy_UnaryFunction1DVectorViewShape* self)
|
||||
{
|
||||
if (self->uf1D_vectorviewshape)
|
||||
delete self->uf1D_vectorviewshape;
|
||||
UnaryFunction1D_Type.tp_dealloc((PyObject*)self);
|
||||
}
|
||||
|
||||
|
||||
PyObject * UnaryFunction1DVectorViewShape___repr__(BPy_UnaryFunction1DVectorViewShape* self)
|
||||
static PyObject * UnaryFunction1DVectorViewShape___repr__(BPy_UnaryFunction1DVectorViewShape* self)
|
||||
{
|
||||
return PyUnicode_FromFormat("type: %s - address: %p", self->uf1D_vectorviewshape->getName().c_str(), self->uf1D_vectorviewshape );
|
||||
}
|
||||
|
||||
PyObject * UnaryFunction1DVectorViewShape_getName( BPy_UnaryFunction1DVectorViewShape *self )
|
||||
static char UnaryFunction1DVectorViewShape_getName___doc__[] =
|
||||
".. method:: getName()\n"
|
||||
"\n"
|
||||
" Returns the name of the unary 1D function.\n"
|
||||
"\n"
|
||||
" :return: The name of the unary 1D function.\n"
|
||||
" :rtype: string\n";
|
||||
|
||||
static PyObject * UnaryFunction1DVectorViewShape_getName( BPy_UnaryFunction1DVectorViewShape *self )
|
||||
{
|
||||
return PyUnicode_FromFormat( self->uf1D_vectorviewshape->getName().c_str() );
|
||||
}
|
||||
|
||||
PyObject * UnaryFunction1DVectorViewShape___call__( BPy_UnaryFunction1DVectorViewShape *self, PyObject *args, PyObject *kwds)
|
||||
static PyObject * UnaryFunction1DVectorViewShape___call__( BPy_UnaryFunction1DVectorViewShape *self, PyObject *args, PyObject *kwds)
|
||||
{
|
||||
PyObject *obj;
|
||||
|
||||
@@ -174,7 +136,15 @@ PyObject * UnaryFunction1DVectorViewShape___call__( BPy_UnaryFunction1DVectorVie
|
||||
return list;
|
||||
}
|
||||
|
||||
PyObject * UnaryFunction1DVectorViewShape_setIntegrationType(BPy_UnaryFunction1DVectorViewShape* self, PyObject *args)
|
||||
static char UnaryFunction1DVectorViewShape_setIntegrationType___doc__[] =
|
||||
".. method:: setIntegrationType(integration)\n"
|
||||
"\n"
|
||||
" Sets the integration method.\n"
|
||||
"\n"
|
||||
" :arg integration: An integration method.\n"
|
||||
" :type integration: :class:`IntegrationType`\n";
|
||||
|
||||
static PyObject * UnaryFunction1DVectorViewShape_setIntegrationType(BPy_UnaryFunction1DVectorViewShape* self, PyObject *args)
|
||||
{
|
||||
PyObject *obj;
|
||||
|
||||
@@ -185,10 +155,69 @@ PyObject * UnaryFunction1DVectorViewShape_setIntegrationType(BPy_UnaryFunction1D
|
||||
Py_RETURN_NONE;
|
||||
}
|
||||
|
||||
PyObject * UnaryFunction1DVectorViewShape_getIntegrationType(BPy_UnaryFunction1DVectorViewShape* self) {
|
||||
static char UnaryFunction1DVectorViewShape_getIntegrationType___doc__[] =
|
||||
".. method:: getIntegrationType(integration)\n"
|
||||
"\n"
|
||||
" Returns the integration method.\n"
|
||||
"\n"
|
||||
" :return: The integration method.\n"
|
||||
" :rtype: :class:`IntegrationType`\n";
|
||||
|
||||
static PyObject * UnaryFunction1DVectorViewShape_getIntegrationType(BPy_UnaryFunction1DVectorViewShape* self) {
|
||||
return BPy_IntegrationType_from_IntegrationType( self->uf1D_vectorviewshape->getIntegrationType() );
|
||||
}
|
||||
|
||||
/*----------------------UnaryFunction1DVectorViewShape instance definitions ----------------------------*/
|
||||
static PyMethodDef BPy_UnaryFunction1DVectorViewShape_methods[] = {
|
||||
{"getName", ( PyCFunction ) UnaryFunction1DVectorViewShape_getName, METH_NOARGS, UnaryFunction1DVectorViewShape_getName___doc__},
|
||||
{"setIntegrationType", ( PyCFunction ) UnaryFunction1DVectorViewShape_setIntegrationType, METH_VARARGS, UnaryFunction1DVectorViewShape_setIntegrationType___doc__},
|
||||
{"getIntegrationType", ( PyCFunction ) UnaryFunction1DVectorViewShape_getIntegrationType, METH_NOARGS, UnaryFunction1DVectorViewShape_getIntegrationType___doc__},
|
||||
{NULL, NULL, 0, NULL}
|
||||
};
|
||||
|
||||
/*-----------------------BPy_UnaryFunction1DVectorViewShape type definition ------------------------------*/
|
||||
|
||||
PyTypeObject UnaryFunction1DVectorViewShape_Type = {
|
||||
PyVarObject_HEAD_INIT(NULL, 0)
|
||||
"UnaryFunction1DVectorViewShape", /* tp_name */
|
||||
sizeof(BPy_UnaryFunction1DVectorViewShape), /* tp_basicsize */
|
||||
0, /* tp_itemsize */
|
||||
(destructor)UnaryFunction1DVectorViewShape___dealloc__, /* tp_dealloc */
|
||||
0, /* tp_print */
|
||||
0, /* tp_getattr */
|
||||
0, /* tp_setattr */
|
||||
0, /* tp_reserved */
|
||||
(reprfunc)UnaryFunction1DVectorViewShape___repr__, /* tp_repr */
|
||||
0, /* tp_as_number */
|
||||
0, /* tp_as_sequence */
|
||||
0, /* tp_as_mapping */
|
||||
0, /* tp_hash */
|
||||
(ternaryfunc)UnaryFunction1DVectorViewShape___call__, /* tp_call */
|
||||
0, /* tp_str */
|
||||
0, /* tp_getattro */
|
||||
0, /* tp_setattro */
|
||||
0, /* tp_as_buffer */
|
||||
Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
|
||||
UnaryFunction1DVectorViewShape___doc__, /* tp_doc */
|
||||
0, /* tp_traverse */
|
||||
0, /* tp_clear */
|
||||
0, /* tp_richcompare */
|
||||
0, /* tp_weaklistoffset */
|
||||
0, /* tp_iter */
|
||||
0, /* tp_iternext */
|
||||
BPy_UnaryFunction1DVectorViewShape_methods, /* tp_methods */
|
||||
0, /* tp_members */
|
||||
0, /* tp_getset */
|
||||
&UnaryFunction1D_Type, /* tp_base */
|
||||
0, /* tp_dict */
|
||||
0, /* tp_descr_get */
|
||||
0, /* tp_descr_set */
|
||||
0, /* tp_dictoffset */
|
||||
(initproc)UnaryFunction1DVectorViewShape___init__, /* tp_init */
|
||||
0, /* tp_alloc */
|
||||
0, /* tp_new */
|
||||
};
|
||||
|
||||
///////////////////////////////////////////////////////////////////////////////////////////
|
||||
|
||||
#ifdef __cplusplus
|
||||
|
||||
Reference in New Issue
Block a user