RNA
[blender.git] / source / blender / makesrna / intern / rna_sensor.c
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): Blender Foundation (2008).
21  *
22  * ***** END GPL LICENSE BLOCK *****
23  */
24
25 #include <stdlib.h>
26
27 #include "RNA_define.h"
28 #include "RNA_types.h"
29
30 #include "rna_internal.h"
31
32 #include "DNA_sensor_types.h"
33
34 #ifdef RNA_RUNTIME
35
36 static StructRNA* rna_Sensor_refine(struct PointerRNA *ptr)
37 {
38         bSensor *sensor= (bSensor*)ptr->data;
39
40         switch(sensor->type) {
41                 case SENS_ALWAYS:
42                         return &RNA_AlwaysSensor;
43                 case SENS_TOUCH:
44                         return &RNA_TouchSensor;
45                 case SENS_NEAR:
46                         return &RNA_NearSensor;
47                 case SENS_KEYBOARD:
48                         return &RNA_KeyboardSensor;
49                 case SENS_PROPERTY:
50                         return &RNA_PropertySensor;
51                 case SENS_MOUSE:
52                         return &RNA_MouseSensor;
53                 case SENS_COLLISION:
54                         return &RNA_CollisionSensor;
55                 case SENS_RADAR:
56                         return &RNA_RadarSensor;
57                 case SENS_RANDOM:
58                         return &RNA_RandomSensor;
59                 case SENS_RAY:
60                         return &RNA_RaySensor;
61                 case SENS_MESSAGE:
62                         return &RNA_MessageSensor;
63                 case SENS_JOYSTICK:
64                         return &RNA_JoystickSensor;
65                 case SENS_ACTUATOR:
66                         return &RNA_ActuatorSensor;
67                 case SENS_DELAY:
68                         return &RNA_DelaySensor;
69                 default:
70                         return &RNA_Sensor;
71         }
72 }
73
74 #else
75
76 void rna_def_sensor(BlenderRNA *brna)
77 {
78         StructRNA *srna;
79         PropertyRNA *prop;
80         static EnumPropertyItem sensor_type_items[] ={
81                 {SENS_ALWAYS, "ALWAYS", "Always", ""},
82                 {SENS_TOUCH, "TOUCH", "Touch", ""},
83                 {SENS_NEAR, "NEAR", "Near", ""},
84                 {SENS_KEYBOARD, "KEYBOARD", "Keyboard", ""},
85                 {SENS_PROPERTY, "PROPERTY", "Property", ""},
86                 {SENS_MOUSE, "MOUSE", "Mouse", ""},
87                 {SENS_COLLISION, "COLLISION", "Collision", ""},
88                 {SENS_RADAR, "RADAR", "Radar", ""},
89                 {SENS_RANDOM, "RANDOM", "Random", ""},
90                 {SENS_RAY, "RAY", "Ray", ""},
91                 {SENS_MESSAGE, "MESSAGE", "Message", ""},
92                 {SENS_JOYSTICK, "JOYSTICK", "joystick", ""},
93                 {SENS_ACTUATOR, "ACTUATOR", "Actuator", ""},
94                 {SENS_DELAY, "DELAY", "Delay", ""},
95                 {0, NULL, NULL, NULL}};
96
97         srna= RNA_def_struct(brna, "Sensor", NULL);
98         RNA_def_struct_ui_text(srna, "Sensor", "Game engine logic brick to detect events.");
99         RNA_def_struct_sdna(srna, "bSensor");
100         RNA_def_struct_refine_func(srna, "rna_Sensor_refine");
101
102         prop= RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
103         RNA_def_property_ui_text(prop, "Name", "Sensor name.");
104         RNA_def_struct_name_property(srna, prop);
105
106         /* type is not editable, would need to do proper data free/alloc */
107         prop= RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
108         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
109         RNA_def_property_enum_items(prop, sensor_type_items);
110         RNA_def_property_ui_text(prop, "Type", "");
111
112         prop= RNA_def_property(srna, "invert", PROP_BOOLEAN, PROP_NONE);
113         RNA_def_property_ui_text(prop, "Invert Output", "Invert the level(output) of this sensor.");
114
115         prop= RNA_def_property(srna, "level", PROP_BOOLEAN, PROP_NONE);
116         RNA_def_property_ui_text(prop, "Level", "Level detector, trigger controllers of new states(only applicable upon logic state transition).");
117
118         prop= RNA_def_property(srna, "pulse_true_level", PROP_BOOLEAN, PROP_NONE);
119         RNA_def_property_boolean_sdna(prop, NULL, "pulse", SENS_PULSE_REPEAT);
120         RNA_def_property_ui_text(prop, "Pulse True Level", "Activate TRUE level triggering (pulse mode).");
121
122         prop= RNA_def_property(srna, "pulse_false_level", PROP_BOOLEAN, PROP_NONE);
123         RNA_def_property_boolean_sdna(prop, NULL, "pulse", SENS_NEG_PULSE_MODE);
124         RNA_def_property_ui_text(prop, "Pulse False Level", "Activate FALSE level triggering (pulse mode).");
125         
126         prop= RNA_def_property(srna, "frequence", PROP_INT, PROP_NONE);
127         RNA_def_property_int_sdna(prop, NULL, "freq");
128         RNA_def_property_ui_text(prop, "Frequency", "Delay between repeated pulses(in logic tics, 0=no delay).");
129         RNA_def_property_range(prop, 0, 10000);
130 }
131
132 void rna_def_always_sensor(BlenderRNA *brna)
133 {
134         StructRNA *srna;
135         srna= RNA_def_struct(brna, "AlwaysSensor", "Sensor");
136         RNA_def_struct_ui_text(srna, "Always Sensor", "Sensor to generate continuous pulses.");
137 }
138
139 void rna_def_near_sensor(BlenderRNA *brna)
140 {
141         StructRNA *srna;
142         PropertyRNA *prop;
143
144         srna= RNA_def_struct(brna, "NearSensor", "Sensor");
145         RNA_def_struct_ui_text(srna , "Near Sensor", "Sensor to detect nearby objects.");
146         RNA_def_struct_sdna_from(srna, "bNearSensor", "data");
147
148         prop= RNA_def_property(srna, "property", PROP_STRING, PROP_NONE);
149         RNA_def_property_string_sdna(prop, NULL, "name");
150         RNA_def_property_ui_text(prop, "Property", "Only look for objects with this property.");
151
152         prop= RNA_def_property(srna, "distance", PROP_FLOAT, PROP_NONE);
153         RNA_def_property_float_sdna(prop, NULL, "dist");
154         RNA_def_property_ui_text(prop, "Distance", "Trigger distance.");
155         RNA_def_property_range(prop, 0.0f, 10000.0f);
156
157         prop= RNA_def_property(srna, "reset_distance", PROP_FLOAT, PROP_NONE);
158         RNA_def_property_float_sdna(prop, NULL, "resetdist");
159         RNA_def_property_ui_text(prop, "Reset Distance", "");
160         RNA_def_property_range(prop, 0.0f, 10000.0f);
161 }
162
163 void rna_def_mouse_sensor(BlenderRNA *brna)
164 {
165         StructRNA *srna;
166         PropertyRNA *prop;
167
168         static EnumPropertyItem mouse_event_items[] ={
169                 {BL_SENS_MOUSE_LEFT_BUTTON, "LEFTCLICK", "Left Button", ""},
170                 {BL_SENS_MOUSE_MIDDLE_BUTTON, "MIDDLECLICK", "Middle Button", ""},
171                 {BL_SENS_MOUSE_RIGHT_BUTTON, "RIGHTCLICK", "Right Button", ""},
172                 {BL_SENS_MOUSE_WHEEL_UP, "WHEELUP", "Wheel Up", ""},
173                 {BL_SENS_MOUSE_WHEEL_DOWN, "WHEELDOWN", "Wheel Down", ""},
174                 {BL_SENS_MOUSE_MOVEMENT, "MOVEMENT", "Movement", ""},
175                 {BL_SENS_MOUSE_MOUSEOVER, "MOUSEOVER", "Mouse Over", ""},
176                 {BL_SENS_MOUSE_MOUSEOVER_ANY, "MOUSEOVERANY", "Mouse Over Any", ""},
177                 {0, NULL, NULL, NULL}};
178
179         srna= RNA_def_struct(brna, "MouseSensor", "Sensor");
180         RNA_def_struct_ui_text(srna, "Mouse Sensor", "Sensor to detect mouse events.");
181         RNA_def_struct_sdna_from(srna, "bMouseSensor", "data");
182
183         prop= RNA_def_property(srna, "mouse_event", PROP_ENUM, PROP_NONE);
184         RNA_def_property_enum_sdna(prop, NULL, "type");
185         RNA_def_property_enum_items(prop, mouse_event_items);
186         RNA_def_property_ui_text(prop, "Mouse Event", "Specify the type of event this mouse sensor should trigger on.");
187 }
188
189 void rna_def_touch_sensor(BlenderRNA *brna)
190 {
191         StructRNA *srna;
192         PropertyRNA *prop;
193
194         srna= RNA_def_struct(brna, "TouchSensor", "Sensor");
195         RNA_def_struct_ui_text(srna, "Touch Sensor", "Sensor to detect objects colliding with the current object.");
196         RNA_def_struct_sdna_from(srna, "bTouchSensor", "data");
197
198         prop= RNA_def_property(srna, "material", PROP_POINTER, PROP_NONE);
199         RNA_def_property_pointer_sdna(prop, NULL, "ma");
200         RNA_def_property_ui_text(prop, "Material", "Only look for floors with this material.");
201 }
202
203 void rna_def_keyboard_sensor(BlenderRNA *brna)
204 {
205         StructRNA *srna;
206         PropertyRNA *prop;
207
208         srna= RNA_def_struct(brna, "KeyboardSensor", "Sensor");
209         RNA_def_struct_ui_text(srna, "Keyboard Sensor", "Sensor to detect keyboard events.");
210         RNA_def_struct_sdna_from(srna, "bKeyboardSensor", "data");
211
212         prop= RNA_def_property(srna, "key", PROP_INT, PROP_NONE);
213         RNA_def_property_flag(prop, PROP_NOT_EDITABLE); /* need better range or enum check */
214         RNA_def_property_ui_text(prop, "Key", "Input key code.");
215         RNA_def_property_range(prop, 0, 255);
216
217         prop= RNA_def_property(srna, "modifier_key", PROP_INT, PROP_NONE);
218         RNA_def_property_flag(prop, PROP_NOT_EDITABLE); /* need better range or enum check */
219         RNA_def_property_int_sdna(prop, NULL, "qual");
220         RNA_def_property_ui_text(prop, "Modifier Key", "Modifier key code.");
221         RNA_def_property_range(prop, 0, 255);
222
223         prop= RNA_def_property(srna, "second_modifier_key", PROP_INT, PROP_NONE);
224         RNA_def_property_flag(prop, PROP_NOT_EDITABLE); /* need better range or enum check */
225         RNA_def_property_int_sdna(prop, NULL, "qual2");
226         RNA_def_property_ui_text(prop, "Second Modifier Key", "Modifier key code.");
227         RNA_def_property_range(prop, 0, 255);
228
229         prop= RNA_def_property(srna, "target", PROP_STRING, PROP_NONE);
230         RNA_def_property_string_sdna(prop, NULL, "targetName");
231         RNA_def_property_ui_text(prop, "Target", "Property that indicates whether to log keystrokes as a string.");
232
233         prop= RNA_def_property(srna, "log", PROP_STRING, PROP_NONE);
234         RNA_def_property_string_sdna(prop, NULL, "toggleName");
235         RNA_def_property_ui_text(prop, "Log", "Property that receive the keystrokes in case a string is logged.");
236
237         prop= RNA_def_property(srna, "all_keys", PROP_BOOLEAN, PROP_NONE);
238         RNA_def_property_boolean_sdna(prop, NULL, "type", 1);
239         RNA_def_property_ui_text(prop, "All Keys", "Trigger this sensor on any keystroke.");
240 }
241
242 void rna_def_property_sensor(BlenderRNA *brna)
243 {
244         StructRNA *srna;
245         PropertyRNA *prop;
246         static EnumPropertyItem prop_type_items[] ={
247                 {SENS_PROP_EQUAL, "PROPEQUAL", "Equal", ""},
248                 {SENS_PROP_NEQUAL, "PROPNEQUAL", "Not Equal", ""},
249                 {SENS_PROP_INTERVAL, "PROPINTERVAL", "Interval", ""},
250                 {SENS_PROP_CHANGED, "PROPCHANGED", "Changed", ""},
251                 /* {SENS_PROP_EXPRESSION, "PROPEXPRESSION", "Expression", ""},  NOT_USED_IN_UI */
252                 {0, NULL, NULL, NULL}};
253
254         srna= RNA_def_struct(brna, "PropertySensor", "Sensor");
255         RNA_def_struct_ui_text(srna, "Property Sensor", "Sensor to detect values and changes in values of properties.");
256         RNA_def_struct_sdna_from(srna, "bPropertySensor", "data");
257
258         prop= RNA_def_property(srna, "evaluation_type", PROP_ENUM, PROP_NONE);
259         RNA_def_property_enum_sdna(prop, NULL, "type");
260         RNA_def_property_enum_items(prop, prop_type_items);
261         RNA_def_property_ui_text(prop, "Evaluation Type", "Type of property evaluation.");
262
263         prop= RNA_def_property(srna, "property", PROP_STRING, PROP_NONE);
264         RNA_def_property_string_sdna(prop, NULL, "name");
265         RNA_def_property_ui_text(prop, "Property", "");
266
267         prop= RNA_def_property(srna, "value", PROP_STRING, PROP_NONE);
268         RNA_def_property_string_sdna(prop, NULL, "value");
269         RNA_def_property_ui_text(prop, "Value", "Check for this value in types in Equal or Not Equal types.");
270
271         prop= RNA_def_property(srna, "min_value", PROP_STRING, PROP_NONE);
272         RNA_def_property_string_sdna(prop, NULL, "value");
273         RNA_def_property_ui_text(prop, "Minimum Value", "Specify minimum value in Interval type.");
274
275         prop= RNA_def_property(srna, "max_value", PROP_STRING, PROP_NONE);
276         RNA_def_property_string_sdna(prop, NULL, "maxvalue");
277         RNA_def_property_ui_text(prop, "Maximum Value", "Specify maximum value in Interval type.");
278 }
279
280 void rna_def_actuator_sensor(BlenderRNA *brna)
281 {
282         StructRNA *srna;
283         PropertyRNA *prop;
284
285         srna= RNA_def_struct(brna, "ActuatorSensor", "Sensor");
286         RNA_def_struct_ui_text(srna, "Actuator Sensor", "Sensor to detect state modifications of actuators.");
287         RNA_def_struct_sdna_from(srna, "bActuatorSensor", "data");
288
289         prop= RNA_def_property(srna, "actuator", PROP_STRING, PROP_NONE);
290         RNA_def_property_string_sdna(prop, NULL, "name");
291         RNA_def_property_ui_text(prop, "Actuator", "Actuator name, actuator active state modifications will be detected.");
292 }
293
294 void rna_def_delay_sensor(BlenderRNA *brna)
295 {
296         StructRNA *srna;
297         PropertyRNA *prop;
298
299         srna= RNA_def_struct(brna, "DelaySensor", "Sensor");
300         RNA_def_struct_ui_text(srna, "Delay Sensor", "Sensor to send delayed events.");
301         RNA_def_struct_sdna_from(srna, "bDelaySensor", "data");
302
303         prop= RNA_def_property(srna, "delay", PROP_INT, PROP_NONE);
304         RNA_def_property_ui_text(prop, "Delay", "Delay in number of logic tics before the positive trigger (default 60 per second).");
305         RNA_def_property_range(prop, 0, 5000);
306
307         prop= RNA_def_property(srna, "duration", PROP_INT, PROP_NONE);
308         RNA_def_property_ui_text(prop, "Duration", "If >0, delay in number of logic tics before the negative trigger following the positive trigger.");
309         RNA_def_property_range(prop, 0, 5000);
310
311         prop= RNA_def_property(srna, "repeat", PROP_BOOLEAN, PROP_NONE);
312         RNA_def_property_boolean_sdna(prop, NULL, "flag", SENS_DELAY_REPEAT);
313         RNA_def_property_ui_text(prop, "Repeat", "Toggle repeat option. If selected, the sensor restarts after Delay+Dur logic tics.");
314 }
315
316 void rna_def_collision_sensor(BlenderRNA *brna)
317 {
318         StructRNA *srna;
319         PropertyRNA *prop;
320         static EnumPropertyItem prop_type_items[] ={
321                 {0, "PROPERTY", "Property", ""},
322                 {1, "MATERIAL", "Material", ""},
323                 {0, NULL, NULL, NULL}};
324
325         srna= RNA_def_struct(brna, "CollisionSensor", "Sensor");
326         RNA_def_struct_ui_text(srna, "Collision Sensor", "Sensor to detect objects colliding with the current object, with more settings than the Touch sensor.");
327         RNA_def_struct_sdna_from(srna, "bCollisionSensor", "data");
328
329         prop= RNA_def_property(srna, "property", PROP_STRING, PROP_NONE);
330         RNA_def_property_string_sdna(prop, NULL, "name");
331         RNA_def_property_ui_text(prop, "Property Name", "Only look for Objects with this property.");
332
333         prop= RNA_def_property(srna, "material", PROP_STRING, PROP_NONE);
334         RNA_def_property_string_sdna(prop, NULL, "materialName");
335         RNA_def_property_ui_text(prop, "Material Name", "Only look for Objects with this material.");
336
337         prop= RNA_def_property(srna, "collision_type", PROP_ENUM, PROP_NONE);
338         RNA_def_property_enum_sdna(prop, NULL, "mode");
339         RNA_def_property_enum_items(prop, prop_type_items);
340         RNA_def_property_ui_text(prop, "Collision Type", "Toggle collision on material or property.");
341 }
342
343 void rna_def_radar_sensor(BlenderRNA *brna)
344 {
345         StructRNA *srna;
346         PropertyRNA *prop;
347         static EnumPropertyItem axis_items[] ={
348                 {SENS_RAY_X_AXIS, "XAXIS", "+X axis", ""},
349                 {SENS_RAY_Y_AXIS, "YAXIS", "+Y axis", ""},
350                 {SENS_RAY_Z_AXIS, "ZAXIS", "+Z axis", ""},
351                 {SENS_RAY_NEG_X_AXIS, "NEGXAXIS", "-X axis", ""},
352                 {SENS_RAY_NEG_Y_AXIS, "NEGYAXIS", "-Y axis", ""},
353                 {SENS_RAY_NEG_Z_AXIS, "NEGZAXIS", "-Z axis", ""},
354                 {0, NULL, NULL, NULL}};
355
356         srna= RNA_def_struct(brna, "RadarSensor", "Sensor");
357         RNA_def_struct_ui_text(srna, "Radar Sensor", "Sensor to detect objects in a cone shaped radar emanating from the current object.");
358         RNA_def_struct_sdna_from(srna, "bRadarSensor", "data");
359
360         prop= RNA_def_property(srna, "property", PROP_STRING, PROP_NONE);
361         RNA_def_property_string_sdna(prop, NULL, "name");
362         RNA_def_property_ui_text(prop, "Property", "Only look for Objects with this property.");
363
364         prop= RNA_def_property(srna, "axis", PROP_ENUM, PROP_NONE);
365         RNA_def_property_enum_items(prop, axis_items);
366         RNA_def_property_ui_text(prop, "Axis", "Specify along which axis the radar cone is cast.");
367
368         prop= RNA_def_property(srna, "angle", PROP_FLOAT, PROP_NONE);
369         RNA_def_property_range(prop, 0.0, 179.9);
370         RNA_def_property_ui_text(prop, "Angle", "Opening angle of the radar cone.");
371
372         prop= RNA_def_property(srna, "distance", PROP_FLOAT, PROP_NONE);
373         RNA_def_property_float_sdna(prop, NULL, "range");
374         RNA_def_property_range(prop, 0.0, 10000.0);
375         RNA_def_property_ui_text(prop, "Distance", "Depth of the radar cone.");
376 }
377
378 void rna_def_random_sensor(BlenderRNA *brna)
379 {
380         StructRNA *srna;
381         PropertyRNA *prop;
382
383         srna= RNA_def_struct(brna, "RandomSensor", "Sensor");
384         RNA_def_struct_ui_text(srna, "Random Sensor", "Sensor to send random events.");
385         RNA_def_struct_sdna_from(srna, "bRandomSensor", "data");
386
387         prop= RNA_def_property(srna, "seed", PROP_INT, PROP_NONE);
388         RNA_def_property_range(prop, 0, 1000);
389         RNA_def_property_ui_text(prop, "Seed", "Initial seed of the generator. (Choose 0 for not random).");
390 }
391
392 void rna_def_ray_sensor(BlenderRNA *brna)
393 {
394         StructRNA *srna;
395         PropertyRNA *prop;
396         static EnumPropertyItem axis_items[] ={
397                 {SENS_RAY_X_AXIS, "XAXIS", "+X axis", ""},
398                 {SENS_RAY_Y_AXIS, "YAXIS", "+Y axis", ""},
399                 {SENS_RAY_Z_AXIS, "ZAXIS", "+Z axis", ""},
400                 {SENS_RAY_NEG_X_AXIS, "NEGXAXIS", "-X axis", ""},
401                 {SENS_RAY_NEG_Y_AXIS, "NEGYAXIS", "-Y axis", ""},
402                 {SENS_RAY_NEG_Z_AXIS, "NEGZAXIS", "-Z axis", ""},
403                 {0, NULL, NULL, NULL}};
404         static EnumPropertyItem prop_type_items[] ={
405                 {0, "PROPERTY", "Property", ""},
406                 {1, "MATERIAL", "Material", ""},
407                 {0, NULL, NULL, NULL}};
408
409         srna= RNA_def_struct(brna, "RaySensor", "Sensor");
410         RNA_def_struct_ui_text(srna, "Ray Sensor", "Sensor to detect interestions with a ray emanating from the current object.");
411         RNA_def_struct_sdna_from(srna, "bRaySensor", "data");
412
413         prop= RNA_def_property(srna, "property", PROP_STRING, PROP_NONE);
414         RNA_def_property_string_sdna(prop, NULL, "propname");
415         RNA_def_property_ui_text(prop, "Property", "Only look for Objects with this property.");
416
417         prop= RNA_def_property(srna, "material", PROP_STRING, PROP_NONE);
418         RNA_def_property_string_sdna(prop, NULL, "matname");
419         RNA_def_property_ui_text(prop, "Material", "Only look for Objects with this material.");
420
421         prop= RNA_def_property(srna, "ray_type", PROP_ENUM, PROP_NONE);
422         RNA_def_property_enum_sdna(prop, NULL, "mode");
423         RNA_def_property_enum_items(prop, prop_type_items);
424         RNA_def_property_ui_text(prop, "Collision Type", "Toggle collision on material or property.");
425
426         prop= RNA_def_property(srna, "x_ray_mode", PROP_BOOLEAN, PROP_NONE);
427         RNA_def_property_boolean_sdna(prop, NULL, "mode", SENS_RAY_XRAY);
428         RNA_def_property_ui_text(prop, "X-Ray Mode", "Toggle X-Ray option (see through objects that don't have the property).");
429
430         prop= RNA_def_property(srna, "range", PROP_FLOAT, PROP_NONE);
431         RNA_def_property_range(prop, 0.01, 10000.0);
432         RNA_def_property_ui_text(prop, "Range", "Sense objects no farther than this distance.");
433
434         prop= RNA_def_property(srna, "axis", PROP_ENUM, PROP_NONE);
435         RNA_def_property_enum_sdna(prop, NULL, "axisflag");
436         RNA_def_property_enum_items(prop, axis_items);
437         RNA_def_property_ui_text(prop, "Axis", "Specify along which axis the ray is cast.");
438 }
439
440 void rna_def_message_sensor(BlenderRNA *brna)
441 {
442         StructRNA *srna;
443         PropertyRNA *prop;
444
445         srna= RNA_def_struct(brna, "MessageSensor", "Sensor");
446         RNA_def_struct_ui_text(srna, "Message Sensor", "Sensor to detect incoming messages.");
447         RNA_def_struct_sdna_from(srna, "bMessageSensor", "data");
448
449         prop= RNA_def_property(srna, "subject", PROP_STRING, PROP_NONE);
450         RNA_def_property_ui_text(prop, "Subject", "Optional subject filter: only accept messages with this subject, or empty for all.");
451 }
452
453 void rna_def_joystick_sensor(BlenderRNA *brna)
454 {
455         StructRNA *srna;
456         PropertyRNA *prop;
457
458         static EnumPropertyItem event_type_items[] ={
459                 {SENS_JOY_BUTTON, "BUTTON", "Button", ""},
460                 {SENS_JOY_AXIS, "AXIS", "Axis", ""},
461                 {SENS_JOY_HAT, "HAT", "Hat", ""},
462                 {0, NULL, NULL, NULL}};
463
464         static EnumPropertyItem axis_direction_items[] ={
465                 {SENS_JOY_X_AXIS, "RIGHTAXIS", "Right Axis", ""},
466                 {SENS_JOY_Y_AXIS, "UPAXIS", "Up Axis", ""},
467                 {SENS_JOY_NEG_X_AXIS, "LEFTAXIS", "Left Axis", ""},
468                 {SENS_JOY_NEG_Y_AXIS, "DOWNAXIS", "Down Axis", ""},
469                 {0, NULL, NULL, NULL}};
470
471         srna= RNA_def_struct(brna, "JoystickSensor", "Sensor");
472         RNA_def_struct_ui_text(srna, "Joystick Sensor", "Sensor to detect joystick events.");
473         RNA_def_struct_sdna_from(srna, "bJoystickSensor", "data");
474         
475         prop= RNA_def_property(srna, "joystick_index", PROP_INT, PROP_NONE);
476         RNA_def_property_int_sdna(prop, NULL, "joyindex");
477         RNA_def_property_ui_text(prop, "Joystick Index", "Specify which joystick to use.");
478         RNA_def_property_range(prop, 0, SENS_JOY_MAXINDEX-1);
479
480         prop= RNA_def_property(srna, "event_type", PROP_ENUM, PROP_NONE);
481         RNA_def_property_enum_sdna(prop, NULL, "type");
482         RNA_def_property_enum_items(prop, event_type_items);
483         RNA_def_property_ui_text(prop, "Event Type", "The type of event this joystick sensor is triggered on.");
484
485         prop= RNA_def_property(srna, "all_events", PROP_BOOLEAN, PROP_NONE);
486         RNA_def_property_boolean_sdna(prop, NULL, "flag", SENS_JOY_ANY_EVENT);
487         RNA_def_property_ui_text(prop, "All Events", "Triggered by all events on this joysticks current type (axis/button/hat).");
488
489         /* Button */
490         prop= RNA_def_property(srna, "button_number", PROP_INT, PROP_NONE);
491         RNA_def_property_int_sdna(prop, NULL, "button");
492         RNA_def_property_ui_text(prop, "Button Number", "Specify which button to use.");
493         RNA_def_property_range(prop, 0, 18);
494
495         /* Axis */
496         prop= RNA_def_property(srna, "axis_number", PROP_INT, PROP_NONE);
497         RNA_def_property_int_sdna(prop, NULL, "axis");
498         RNA_def_property_ui_text(prop, "Axis Number", "Specify which axis pair to use, 1 is useually the main direction input.");
499         RNA_def_property_range(prop, 1, 2);
500
501         prop= RNA_def_property(srna, "axis_threshold", PROP_INT, PROP_NONE);
502         RNA_def_property_int_sdna(prop, NULL, "precision");
503         RNA_def_property_ui_text(prop, "Axis Threshold", "Specify the precision of the axis.");
504         RNA_def_property_range(prop, 0, 32768);
505
506         prop= RNA_def_property(srna, "axis_direction", PROP_ENUM, PROP_NONE);
507         RNA_def_property_enum_sdna(prop, NULL, "axisf");
508         RNA_def_property_enum_items(prop, axis_direction_items);
509         RNA_def_property_ui_text(prop, "Axis Direction", "The direction of the axis.");
510
511         /* Hat */
512         prop= RNA_def_property(srna, "hat_number", PROP_INT, PROP_NONE);
513         RNA_def_property_int_sdna(prop, NULL, "hat");
514         RNA_def_property_ui_text(prop, "Hat Number", "Specify which hat to use.");
515         RNA_def_property_range(prop, 1, 2);
516
517         prop= RNA_def_property(srna, "hat_direction", PROP_INT, PROP_NONE);
518         RNA_def_property_int_sdna(prop, NULL, "hatf");
519         RNA_def_property_ui_text(prop, "Hat Direction", "Specify hat direction.");
520         RNA_def_property_range(prop, 0, 12);
521 }
522
523 void RNA_def_sensor(BlenderRNA *brna)
524 {
525         rna_def_sensor(brna);
526
527         rna_def_always_sensor(brna);
528         rna_def_near_sensor(brna);
529         rna_def_mouse_sensor(brna);
530         rna_def_touch_sensor(brna);
531         rna_def_keyboard_sensor(brna);
532         rna_def_property_sensor(brna);
533         rna_def_actuator_sensor(brna);
534         rna_def_delay_sensor(brna);
535         rna_def_collision_sensor(brna);
536         rna_def_radar_sensor(brna);
537         rna_def_random_sensor(brna);
538         rna_def_ray_sensor(brna);
539         rna_def_message_sensor(brna);
540         rna_def_joystick_sensor(brna);
541 }
542
543 #endif
544