BGE - button for deactivate sensors, controllers and actuators
[blender.git] / source / blender / makesrna / intern / rna_controller.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): Blender Foundation (2008).
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 /** \file blender/makesrna/intern/rna_controller.c
24  *  \ingroup RNA
25  */
26
27 #include <stdlib.h>
28
29 #include "DNA_object_types.h"
30 #include "DNA_controller_types.h"
31
32 #include "BLI_utildefines.h"
33
34 #include "BLF_translation.h"
35
36 #include "RNA_define.h"
37 #include "RNA_enum_types.h"
38
39 #include "rna_internal.h"
40
41 #include "WM_types.h"
42
43 EnumPropertyItem controller_type_items[] = {
44         {CONT_LOGIC_AND, "LOGIC_AND", 0, "And", "Logic And"},
45         {CONT_LOGIC_OR, "LOGIC_OR", 0, "Or", "Logic Or"},
46         {CONT_LOGIC_NAND, "LOGIC_NAND", 0, "Nand", "Logic Nand"},
47         {CONT_LOGIC_NOR, "LOGIC_NOR", 0, "Nor", "Logic Nor"},
48         {CONT_LOGIC_XOR, "LOGIC_XOR", 0, "Xor", "Logic Xor"},
49         {CONT_LOGIC_XNOR, "LOGIC_XNOR", 0, "Xnor", "Logic Xnor"},
50         {CONT_EXPRESSION, "EXPRESSION", 0, "Expression", ""},
51         {CONT_PYTHON, "PYTHON", 0, "Python", ""},
52         {0, NULL, 0, NULL, NULL}
53 };
54
55 #ifdef RNA_RUNTIME
56
57 #include "BKE_sca.h"
58 #include "DNA_actuator_types.h"
59
60 static StructRNA *rna_Controller_refine(struct PointerRNA *ptr)
61 {
62         bController *controller = (bController *)ptr->data;
63
64         switch (controller->type) {
65                 case CONT_LOGIC_AND:
66                         return &RNA_AndController;
67                 case CONT_LOGIC_OR:
68                         return &RNA_OrController;
69                 case CONT_LOGIC_NAND:
70                         return &RNA_NandController;
71                 case CONT_LOGIC_NOR:
72                         return &RNA_NorController;
73                 case CONT_LOGIC_XOR:
74                         return &RNA_XorController;
75                 case CONT_LOGIC_XNOR:
76                         return &RNA_XnorController;
77                 case CONT_EXPRESSION:
78                         return &RNA_ExpressionController;
79                 case CONT_PYTHON:
80                         return &RNA_PythonController;
81                 default:
82                         return &RNA_Controller;
83         }
84 }
85
86 static void rna_Constroller_name_set(PointerRNA *ptr, const char *value)
87 {
88         bController *cont = (bController *)ptr->data;
89
90         BLI_strncpy_utf8(cont->name, value, sizeof(cont->name));
91
92         if (ptr->id.data) {
93                 Object *ob = (Object *)ptr->id.data;
94                 BLI_uniquename(&ob->controllers, cont, DATA_("Controller"), '.', offsetof(bController, name),
95                                sizeof(cont->name));
96         }
97 }
98
99 static void rna_Controller_type_set(struct PointerRNA *ptr, int value)
100 {
101         bController *cont = (bController *)ptr->data;
102
103         if (value != cont->type) {
104                 cont->type = value;
105                 init_controller(cont);
106         }
107 }
108
109 static void rna_Controller_mode_set(struct PointerRNA *ptr, int value)
110 {
111         bController *cont = (bController *)ptr->data;
112         bPythonCont *pycon = (bPythonCont *)cont->data;
113
114         /* if mode changed and previous mode were Script */
115         if (value != pycon->mode && pycon->mode == CONT_PY_SCRIPT) {
116                 /* clear script to avoid it to get linked with the controller */
117                 pycon->text = NULL;
118         }
119         pycon->mode = value;
120 }
121
122 static int rna_Controller_state_number_get(struct PointerRNA *ptr)
123 {
124         bController *cont = (bController *)ptr->data;
125         int bit;
126
127         for (bit = 0; bit < 32; bit++) {
128                 if (cont->state_mask & (1 << bit))
129                         return bit + 1;
130         }
131         return 0;
132 }
133
134 static void rna_Controller_state_number_set(struct PointerRNA *ptr, const int value)
135 {
136         bController *cont = (bController *)ptr->data;
137         if (value < 1 || value > OB_MAX_STATES)
138                 return;
139
140         cont->state_mask = (1 << (value - 1));
141 }
142
143 static void rna_Controller_actuators_begin(CollectionPropertyIterator *iter, PointerRNA *ptr)
144 {
145         bController *cont = (bController *)ptr->data;
146         rna_iterator_array_begin(iter, cont->links, sizeof(bActuator *), (int)cont->totlinks, 0, NULL);
147 }
148
149 static int rna_Controller_actuators_length(PointerRNA *ptr)
150 {
151         bController *cont = (bController *)ptr->data;
152         return (int) cont->totlinks;
153 }
154
155 #if 0 /* editable is set to false, comment for now. */
156 static void rna_Controller_state_get(PointerRNA *ptr, int *values)
157 {
158         bController *cont = (bController *)ptr->data;
159         int i;
160
161         memset(values, 0, sizeof(int) * OB_MAX_STATES);
162         for (i = 0; i < OB_MAX_STATES; i++)
163                 values[i] = (cont->state_mask & (1 << i));
164 }
165
166 static void rna_Controller_state_set(PointerRNA *ptr, const int *values)
167 {
168         bController *cont = (bController *)ptr->data;
169         int i, tot = 0;
170
171         /* ensure we always have some state selected */
172         for (i = 0; i < OB_MAX_STATES; i++)
173                 if (values[i])
174                         tot++;
175         
176         if (tot == 0)
177                 return;
178
179         /* only works for one state at once */
180         if (tot > 1)
181                 return;
182
183         for (i = 0; i < OB_MAX_STATES; i++) {
184                 if (values[i]) cont->state_mask |= (1 << i);
185                 else cont->state_mask &= ~(1 << i);
186         }
187 }
188 #endif
189
190 #else
191
192 void RNA_def_controller(BlenderRNA *brna)
193 {
194         StructRNA *srna;
195         PropertyRNA *prop;
196
197         static EnumPropertyItem python_controller_modes[] = {
198                 {CONT_PY_SCRIPT, "SCRIPT", 0, "Script", ""},
199                 {CONT_PY_MODULE, "MODULE", 0, "Module", ""},
200                 {0, NULL, 0, NULL, NULL}
201         };
202
203         /* Controller */
204         srna = RNA_def_struct(brna, "Controller", NULL);
205         RNA_def_struct_sdna(srna, "bController");
206         RNA_def_struct_refine_func(srna, "rna_Controller_refine");
207         RNA_def_struct_ui_text(srna, "Controller",
208                                "Game engine logic brick to process events, connecting sensors to actuators");
209
210         RNA_api_controller(srna);
211
212         prop = RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
213         RNA_def_property_ui_text(prop, "Name", "");
214         RNA_def_property_string_funcs(prop, NULL, NULL, "rna_Constroller_name_set");
215         RNA_def_struct_name_property(srna, prop);
216         RNA_def_property_update(prop, NC_LOGIC, NULL);
217
218         prop = RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
219         RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
220         RNA_def_property_enum_funcs(prop, NULL, "rna_Controller_type_set", NULL);
221         RNA_def_property_enum_items(prop, controller_type_items);
222         RNA_def_property_ui_text(prop, "Type", "");
223         RNA_def_property_update(prop, NC_LOGIC, NULL);
224
225         prop = RNA_def_property(srna, "show_expanded", PROP_BOOLEAN, PROP_NONE);
226         RNA_def_property_boolean_sdna(prop, NULL, "flag", CONT_SHOW);
227         RNA_def_property_ui_text(prop, "Expanded", "Set controller expanded in the user interface");
228         RNA_def_property_ui_icon(prop, ICON_TRIA_RIGHT, 1);
229         RNA_def_property_update(prop, NC_LOGIC, NULL);
230
231         prop = RNA_def_property(srna, "active", PROP_BOOLEAN, PROP_NONE);
232         RNA_def_property_boolean_negative_sdna(prop, NULL, "flag", CONT_DEACTIVATE);
233         RNA_def_property_ui_text(prop, "Active", "Set the active state of the controller");
234         RNA_def_property_update(prop, NC_LOGIC, NULL);
235
236         prop = RNA_def_property(srna, "use_priority", PROP_BOOLEAN, PROP_NONE);
237         RNA_def_property_boolean_sdna(prop, NULL, "flag", CONT_PRIO);
238         RNA_def_property_ui_text(prop, "Priority",
239                                  "Mark controller for execution before all non-marked controllers "
240                                  "(good for startup scripts)");
241         RNA_def_property_ui_icon(prop, ICON_BOOKMARKS, 1);
242         RNA_def_property_update(prop, NC_LOGIC, NULL);
243
244         prop = RNA_def_property(srna, "actuators", PROP_COLLECTION, PROP_NONE);
245         RNA_def_property_collection_sdna(prop, NULL, "links", NULL);
246         RNA_def_property_struct_type(prop, "Actuator");
247         RNA_def_property_ui_text(prop, "Actuators", "The list containing the actuators connected to the controller");
248         RNA_def_property_collection_funcs(prop, "rna_Controller_actuators_begin", "rna_iterator_array_next",
249                                           "rna_iterator_array_end", "rna_iterator_array_dereference_get",
250                                           "rna_Controller_actuators_length", NULL, NULL, NULL);
251
252         /* State */
253         
254         /* array of OB_MAX_STATES */
255         /*prop = RNA_def_property(srna, "states", PROP_BOOLEAN, PROP_LAYER_MEMBER); */
256         /*RNA_def_property_array(prop, OB_MAX_STATES); */
257         /*RNA_def_property_clear_flag(prop, PROP_EDITABLE); */
258         /*RNA_def_property_ui_text(prop, "", "Set Controller state index (1 to 30)"); */
259         /*RNA_def_property_boolean_funcs(prop, "rna_Controller_state_get", "rna_Controller_state_set"); */
260         /*RNA_def_property_update(prop, NC_LOGIC, NULL); */
261
262         /* number of the state */
263         prop = RNA_def_property(srna, "states", PROP_INT, PROP_UNSIGNED);
264         RNA_def_property_int_sdna(prop, NULL, "state_mask");
265         RNA_def_property_range(prop, 1, OB_MAX_STATES);
266         RNA_def_property_ui_text(prop, "", "Set Controller state index (1 to 30)");
267         RNA_def_property_int_funcs(prop, "rna_Controller_state_number_get", "rna_Controller_state_number_set", NULL);
268         RNA_def_property_update(prop, NC_LOGIC, NULL);
269
270         /* Expression Controller */
271         srna = RNA_def_struct(brna, "ExpressionController", "Controller");
272         RNA_def_struct_sdna_from(srna, "bExpressionCont", "data");
273         RNA_def_struct_ui_text(srna, "Expression Controller",
274                                "Controller passing on events based on the evaluation of an expression");
275
276         prop = RNA_def_property(srna, "expression", PROP_STRING, PROP_NONE);
277         RNA_def_property_string_sdna(prop, NULL, "str");
278         RNA_def_property_ui_text(prop, "Expression", "");
279         RNA_def_property_update(prop, NC_LOGIC, NULL);
280
281         /* Python Controller */
282         srna = RNA_def_struct(brna, "PythonController", "Controller");
283         RNA_def_struct_sdna_from(srna, "bPythonCont", "data");
284         RNA_def_struct_ui_text(srna, "Python Controller", "Controller executing a python script");
285
286         prop = RNA_def_property(srna, "mode", PROP_ENUM, PROP_NONE);
287         RNA_def_property_enum_items(prop, python_controller_modes);
288         RNA_def_property_enum_funcs(prop, NULL, "rna_Controller_mode_set", NULL);
289         RNA_def_property_ui_text(prop, "Execution Method", "Python script type (textblock or module - faster)");
290         RNA_def_property_update(prop, NC_LOGIC, NULL);
291
292         prop = RNA_def_property(srna, "text", PROP_POINTER, PROP_NONE);
293         RNA_def_property_struct_type(prop, "Text");
294         RNA_def_property_flag(prop, PROP_EDITABLE);
295         RNA_def_property_ui_text(prop, "Text", "Text datablock with the python script");
296         RNA_def_property_update(prop, NC_LOGIC, NULL);
297
298         prop = RNA_def_property(srna, "module", PROP_STRING, PROP_NONE);
299         RNA_def_property_ui_text(prop, "Module",
300                                  "Module name and function to run, e.g. \"someModule.main\" "
301                                  "(internal texts and external python files can be used)");
302         RNA_def_property_update(prop, NC_LOGIC, NULL);
303
304         prop = RNA_def_property(srna, "use_debug", PROP_BOOLEAN, PROP_NONE);
305         RNA_def_property_boolean_sdna(prop, NULL, "flag", CONT_PY_DEBUG);
306         RNA_def_property_ui_text(prop, "D",
307                                  "Continuously reload the module from disk for editing external modules "
308                                  "without restarting");
309         RNA_def_property_update(prop, NC_LOGIC, NULL);
310
311         /* Other Controllers */
312         srna = RNA_def_struct(brna, "AndController", "Controller");
313         RNA_def_struct_ui_text(srna, "And Controller", "Controller passing on events based on a logical AND operation");
314         
315         srna = RNA_def_struct(brna, "OrController", "Controller");
316         RNA_def_struct_ui_text(srna, "Or Controller", "Controller passing on events based on a logical OR operation");
317         
318         srna = RNA_def_struct(brna, "NorController", "Controller");
319         RNA_def_struct_ui_text(srna, "Nor Controller", "Controller passing on events based on a logical NOR operation");
320         
321         srna = RNA_def_struct(brna, "NandController", "Controller");
322         RNA_def_struct_ui_text(srna, "Nand Controller", "Controller passing on events based on a logical NAND operation");
323         
324         srna = RNA_def_struct(brna, "XorController", "Controller");
325         RNA_def_struct_ui_text(srna, "Xor Controller", "Controller passing on events based on a logical XOR operation");
326         
327         srna = RNA_def_struct(brna, "XnorController", "Controller");
328         RNA_def_struct_ui_text(srna, "Xnor Controller", "Controller passing on events based on a logical XNOR operation");
329 }
330
331 #endif