Committing patch "[#27676] Change window size/resolution in realtime" by me.
[blender-staging.git] / source / blender / python / intern / bpy_app.c
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * Contributor(s): Campbell Barton
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 /** \file blender/python/intern/bpy_app.c
24  *  \ingroup pythonintern
25  *
26  * This file defines a 'PyStructSequence' accessed via 'bpy.app', mostly
27  * exposing static applications variables such as version and buildinfo
28  * however some writable variables have been added such as 'debug' and 'tempdir'
29  */
30
31
32 #include <Python.h>
33
34 #include "bpy_app.h"
35
36 #include "bpy_app_ffmpeg.h"
37
38 #include "bpy_app_handlers.h"
39 #include "bpy_driver.h"
40
41 #include "BLI_path_util.h"
42 #include "BLI_utildefines.h"
43
44
45 #include "BKE_blender.h"
46 #include "BKE_global.h"
47 #include "structseq.h"
48
49 #include "../generic/py_capi_utils.h"
50
51 #ifdef BUILD_DATE
52 extern char build_date[];
53 extern char build_time[];
54 extern char build_rev[];
55 extern char build_platform[];
56 extern char build_type[];
57 extern char build_cflags[];
58 extern char build_cxxflags[];
59 extern char build_linkflags[];
60 extern char build_system[];
61 #endif
62
63 static PyTypeObject BlenderAppType;
64
65 static PyStructSequence_Field app_info_fields[] = {
66         {(char *)"version", (char *)"The Blender version as a tuple of 3 numbers. eg. (2, 50, 11)"},
67         {(char *)"version_string", (char *)"The Blender version formatted as a string"},
68         {(char *)"version_char", (char *)"The Blender version character (for minor releases)"},
69         {(char *)"version_cycle", (char *)"The release status of this build alpha/beta/rc/release"},
70         {(char *)"binary_path", (char *)"The location of blenders executable, useful for utilities that spawn new instances"},
71         {(char *)"background", (char *)"Boolean, True when blender is running without a user interface (started with -b)"},
72
73         /* buildinfo */
74         {(char *)"build_date", (char *)"The date this blender instance was built"},
75         {(char *)"build_time", (char *)"The time this blender instance was built"},
76         {(char *)"build_revision", (char *)"The subversion revision this blender instance was built with"},
77         {(char *)"build_platform", (char *)"The platform this blender instance was built for"},
78         {(char *)"build_type", (char *)"The type of build (Release, Debug)"},
79         {(char *)"build_cflags", (char *)"C compiler flags"},
80         {(char *)"build_cxxflags", (char *)"C++ compiler flags"},
81         {(char *)"build_linkflags", (char *)"Binary linking flags"},
82         {(char *)"build_system", (char *)"Build system used"},
83
84         /* submodules */
85         {(char *)"ffmpeg", (char *)"FFmpeg library information backend"},
86         {(char *)"handlers", (char *)"Application handler callbacks"},
87         {NULL}
88 };
89
90 static PyStructSequence_Desc app_info_desc = {
91         (char *)"bpy.app",     /* name */
92         (char *)"This module contains application values that remain unchanged during runtime.",    /* doc */
93         app_info_fields,    /* fields */
94         (sizeof(app_info_fields) / sizeof(PyStructSequence_Field)) - 1
95 };
96
97 #define DO_EXPAND(VAL)  VAL ## 1
98 #define EXPAND(VAL)     DO_EXPAND(VAL)
99
100 static PyObject *make_app_info(void)
101 {
102         PyObject *app_info;
103         int pos = 0;
104
105         app_info = PyStructSequence_New(&BlenderAppType);
106         if (app_info == NULL) {
107                 return NULL;
108         }
109
110 #define SetIntItem(flag) \
111         PyStructSequence_SET_ITEM(app_info, pos++, PyLong_FromLong(flag))
112 #define SetStrItem(str) \
113         PyStructSequence_SET_ITEM(app_info, pos++, PyUnicode_FromString(str))
114 #define SetObjItem(obj) \
115         PyStructSequence_SET_ITEM(app_info, pos++, obj)
116
117         SetObjItem(Py_BuildValue("(iii)",
118                                  BLENDER_VERSION / 100, BLENDER_VERSION % 100, BLENDER_SUBVERSION));
119         SetObjItem(PyUnicode_FromFormat("%d.%02d (sub %d)",
120                                         BLENDER_VERSION / 100, BLENDER_VERSION % 100, BLENDER_SUBVERSION));
121
122 #if defined(BLENDER_VERSION_CHAR) && EXPAND(BLENDER_VERSION_CHAR) != 1
123         SetStrItem(STRINGIFY(BLENDER_VERSION_CHAR));
124 #else
125         SetStrItem("");
126 #endif
127         SetStrItem(STRINGIFY(BLENDER_VERSION_CYCLE));
128         SetStrItem(BLI_program_path());
129         SetObjItem(PyBool_FromLong(G.background));
130
131         /* build info */
132 #ifdef BUILD_DATE
133         SetStrItem(build_date);
134         SetStrItem(build_time);
135         SetStrItem(build_rev);
136         SetStrItem(build_platform);
137         SetStrItem(build_type);
138         SetStrItem(build_cflags);
139         SetStrItem(build_cxxflags);
140         SetStrItem(build_linkflags);
141         SetStrItem(build_system);
142 #else
143         SetStrItem("Unknown");
144         SetStrItem("Unknown");
145         SetStrItem("Unknown");
146         SetStrItem("Unknown");
147         SetStrItem("Unknown");
148         SetStrItem("Unknown");
149         SetStrItem("Unknown");
150         SetStrItem("Unknown");
151         SetStrItem("Unknown");
152 #endif
153
154         SetObjItem(BPY_app_ffmpeg_struct());
155         SetObjItem(BPY_app_handlers_struct());
156
157 #undef SetIntItem
158 #undef SetStrItem
159 #undef SetObjItem
160
161         if (PyErr_Occurred()) {
162                 Py_CLEAR(app_info);
163                 return NULL;
164         }
165         return app_info;
166 }
167
168 /* a few getsets because it makes sense for them to be in bpy.app even though
169  * they are not static */
170
171 PyDoc_STRVAR(bpy_app_debug_doc,
172 "Boolean, set when blender is running in debug mode (started with --debug)"
173 );
174 static PyObject *bpy_app_debug_get(PyObject *UNUSED(self), void *UNUSED(closure))
175 {
176         return PyBool_FromLong(G.f & G_DEBUG);
177 }
178
179 static int bpy_app_debug_set(PyObject *UNUSED(self), PyObject *value, void *UNUSED(closure))
180 {
181         int param = PyObject_IsTrue(value);
182
183         if (param < 0) {
184                 PyErr_SetString(PyExc_TypeError, "bpy.app.debug can only be True/False");
185                 return -1;
186         }
187         
188         if (param)  G.f |=  G_DEBUG;
189         else        G.f &= ~G_DEBUG;
190         
191         return 0;
192 }
193
194 PyDoc_STRVAR(bpy_app_debug_value_doc,
195 "Int, number which can be set to non-zero values for testing purposes"
196 );
197 static PyObject *bpy_app_debug_value_get(PyObject *UNUSED(self), void *UNUSED(closure))
198 {
199         return PyLong_FromSsize_t(G.rt);
200 }
201
202 static int bpy_app_debug_value_set(PyObject *UNUSED(self), PyObject *value, void *UNUSED(closure))
203 {
204         int param = PyLong_AsSsize_t(value);
205
206         if (param == -1 && PyErr_Occurred()) {
207                 PyErr_SetString(PyExc_TypeError, "bpy.app.debug_value can only be set to a whole number");
208                 return -1;
209         }
210         
211         G.rt = param;
212
213         return 0;
214 }
215
216 PyDoc_STRVAR(bpy_app_tempdir_doc,
217 "String, the temp directory used by blender (read-only)"
218 );
219 static PyObject *bpy_app_tempdir_get(PyObject *UNUSED(self), void *UNUSED(closure))
220 {
221         return PyC_UnicodeFromByte(BLI_temporary_dir());
222 }
223
224 PyDoc_STRVAR(bpy_app_driver_dict_doc,
225 "Dictionary for drivers namespace, editable in-place, reset on file load (read-only)"
226 );
227 static PyObject *bpy_app_driver_dict_get(PyObject *UNUSED(self), void *UNUSED(closure))
228 {
229         if (bpy_pydriver_Dict == NULL)
230                 if (bpy_pydriver_create_dict() != 0) {
231                         PyErr_SetString(PyExc_RuntimeError, "bpy.app.driver_namespace failed to create dictionary");
232                         return NULL;
233         }
234
235         Py_INCREF(bpy_pydriver_Dict);
236         return bpy_pydriver_Dict;
237 }
238
239
240 static PyGetSetDef bpy_app_getsets[] = {
241         {(char *)"debug", bpy_app_debug_get, bpy_app_debug_set, (char *)bpy_app_debug_doc, NULL},
242         {(char *)"debug_value", bpy_app_debug_value_get, bpy_app_debug_value_set, (char *)bpy_app_debug_value_doc, NULL},
243         {(char *)"tempdir", bpy_app_tempdir_get, NULL, (char *)bpy_app_tempdir_doc, NULL},
244         {(char *)"driver_namespace", bpy_app_driver_dict_get, NULL, (char *)bpy_app_driver_dict_doc, NULL},
245         {NULL, NULL, NULL, NULL, NULL}
246 };
247
248 static void py_struct_seq_getset_init(void)
249 {
250         /* tricky dynamic members, not to py-spec! */
251         PyGetSetDef *getset;
252
253         for (getset = bpy_app_getsets; getset->name; getset++) {
254                 PyDict_SetItemString(BlenderAppType.tp_dict, getset->name, PyDescr_NewGetSet(&BlenderAppType, getset));
255         }
256 }
257 /* end dynamic bpy.app */
258
259
260 PyObject *BPY_app_struct(void)
261 {
262         PyObject *ret;
263         
264         PyStructSequence_InitType(&BlenderAppType, &app_info_desc);
265
266         ret = make_app_info();
267
268         /* prevent user from creating new instances */
269         BlenderAppType.tp_init = NULL;
270         BlenderAppType.tp_new = NULL;
271         BlenderAppType.tp_hash = (hashfunc)_Py_HashPointer; /* without this we can't do set(sys.modules) [#29635] */
272
273         /* kindof a hack ontop of PyStructSequence */
274         py_struct_seq_getset_init();
275
276         return ret;
277 }