user interface units, off by default.
[blender.git] / source / blender / python / intern / bpy_util.h
1 /**
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19  *
20  * Contributor(s): Campbell Barton
21  *
22  * ***** END GPL LICENSE BLOCK *****
23  */
24
25 #include <Python.h>
26
27 #ifndef BPY_UTIL_H
28 #define BPY_UTIL_H
29
30 #if PY_VERSION_HEX <  0x03010000
31 #error "Python versions below 3.1 are not supported anymore, you'll need to update your python."
32 #endif
33
34 #include "RNA_types.h" /* for EnumPropertyItem only */
35
36 struct EnumPropertyItem;
37 struct ReportList;
38
39 /* for internal use only, so python can interchange a sequence of strings with flags */
40 typedef struct BPY_flag_def {
41     const char  *name;
42     int                 flag;
43 } BPY_flag_def;
44
45
46 PyObject *BPY_flag_to_list(BPY_flag_def *flagdef, int flag);
47 int BPY_flag_from_seq(BPY_flag_def *flagdef, PyObject *seq, int *flag);
48
49 void PyObSpit(char *name, PyObject *var);
50 void PyLineSpit(void);
51 void BPY_getFileAndNum(char **filename, int *lineno);
52
53 PyObject *Py_CmpToRich(int op, int cmp);
54
55 PyObject *BPY_exception_buffer(void);
56
57 /* own python like utility function */
58 PyObject *PyObject_GetAttrStringArgs(PyObject *o, Py_ssize_t n, ...);
59
60
61
62 /* Class type checking, use for checking classes can be added as operators, panels etc */
63 typedef struct BPY_class_attr_check {
64         const char      *name;          /* name of the class attribute */
65     char                type;           /* 's' = string, 'f' = function, 'l' = list, (add as needed) */
66     int                 arg_count;      /* only for function types, -1 for undefined, includes self arg */
67     int                 len;            /* only for string types currently */
68         int                     flag;           /* other options */
69 } BPY_class_attr_check;
70
71 /* BPY_class_attr_check, flag */
72 #define BPY_CLASS_ATTR_OPTIONAL 1
73 #define BPY_CLASS_ATTR_NONE_OK  2
74
75 int BPY_class_validate(const char *class_type, PyObject *class, PyObject *base_class, BPY_class_attr_check* class_attrs, PyObject **py_class_attrs);
76
77 char *BPy_enum_as_string(struct EnumPropertyItem *item);
78
79
80 #define BLANK_PYTHON_TYPE {PyVarObject_HEAD_INIT(NULL, 0) 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}
81
82 /* error reporting */
83 int BPy_reports_to_error(struct ReportList *reports);
84 int BPy_errors_to_report(struct ReportList *reports);
85
86 /* TODO - find a better solution! */
87 struct bContext *BPy_GetContext(void);
88 void BPy_SetContext(struct bContext *C);
89
90 extern void bpy_context_set(struct bContext *C, PyGILState_STATE *gilstate);
91 extern void bpy_context_clear(struct bContext *C, PyGILState_STATE *gilstate);
92
93
94 #endif