6779e74700d0973794d0d912f2a1a3cc7284fa0d
[blender.git] / source / blender / makesrna / intern / rna_animation.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 (2009), Joshua Leung
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 /** \file blender/makesrna/intern/rna_animation.c
24  *  \ingroup RNA
25  */
26
27 #include <stdlib.h>
28
29 #include "DNA_anim_types.h"
30 #include "DNA_action_types.h"
31 #include "DNA_scene_types.h"
32
33 #include "BLI_utildefines.h"
34
35 #include "BLT_translation.h"
36
37 #include "MEM_guardedalloc.h"
38
39 #include "RNA_access.h"
40 #include "RNA_define.h"
41 #include "RNA_enum_types.h"
42
43 #include "rna_internal.h"
44
45 #include "WM_types.h"
46
47 #include "ED_keyframing.h"
48
49 /* exported for use in API */
50 const EnumPropertyItem rna_enum_keyingset_path_grouping_items[] = {
51         {KSP_GROUP_NAMED, "NAMED", 0, "Named Group", ""},
52         {KSP_GROUP_NONE, "NONE", 0, "None", ""},
53         {KSP_GROUP_KSNAME, "KEYINGSET", 0, "Keying Set Name", ""},
54         {0, NULL, 0, NULL, NULL}
55 };
56
57 /* It would be cool to get rid of this 'INSERTKEY_' prefix in 'py strings' values, but it would break existing
58  * exported keyingset... :/
59  */
60 const EnumPropertyItem rna_enum_keying_flag_items[] = {
61         {INSERTKEY_NEEDED, "INSERTKEY_NEEDED", 0, "Only Needed",
62                            "Only insert keyframes where they're needed in the relevant F-Curves"},
63         {INSERTKEY_MATRIX, "INSERTKEY_VISUAL", 0, "Visual Keying",
64                            "Insert keyframes based on 'visual transforms'"},
65         {INSERTKEY_XYZ2RGB, "INSERTKEY_XYZ_TO_RGB", 0, "XYZ=RGB Colors",
66                             "Color for newly added transformation F-Curves (Location, Rotation, Scale) "
67                             "and also Color is based on the transform axis"},
68         {0, NULL, 0, NULL, NULL}
69 };
70
71 #ifdef RNA_RUNTIME
72
73 #include "BLI_math_base.h"
74
75 #include "BKE_animsys.h"
76 #include "BKE_depsgraph.h"
77 #include "BKE_fcurve.h"
78 #include "BKE_nla.h"
79
80 #include "DNA_object_types.h"
81
82 #include "WM_api.h"
83
84 static void rna_AnimData_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
85 {
86         ID *id = ptr->id.data;
87         
88         /* tag for refresh so that scheduled updates (e.g. action changed) will 
89          * get computed and reflected in the scene [#34869] 
90          */
91         DAG_id_tag_update(id, OB_RECALC_OB | OB_RECALC_DATA);
92 }
93
94 static int rna_AnimData_action_editable(PointerRNA *ptr, const char **UNUSED(r_info))
95 {
96         AnimData *adt = (AnimData *)ptr->data;
97         
98         /* active action is only editable when it is not a tweaking strip */
99         if ((adt->flag & ADT_NLA_EDIT_ON) || (adt->actstrip) || (adt->tmpact))
100                 return 0;
101         else
102                 return PROP_EDITABLE;
103 }
104
105 static void rna_AnimData_action_set(PointerRNA *ptr, PointerRNA value)
106 {
107         ID *ownerId = (ID *)ptr->id.data;
108         AnimData *adt;
109         
110         /* set action */
111         BKE_animdata_set_action(NULL, ownerId, value.data);
112         
113         /* force action to get evaluated [#34869] */
114         adt = BKE_animdata_from_id(ownerId);
115         if (adt) {
116                 adt->recalc |= ADT_RECALC_ANIM;
117                 DAG_id_tag_update(ownerId, OB_RECALC_TIME);
118         }
119 }
120
121 static void rna_AnimData_tweakmode_set(PointerRNA *ptr, const int value)
122 {
123         AnimData *adt = (AnimData *)ptr->data;
124
125         /* NOTE: technically we should also set/unset SCE_NLA_EDIT_ON flag on the
126          * scene which is used to make polling tests faster, but this flag is weak
127          * and can easily break e.g. by changing layer visibility. This needs to be
128          * dealt with at some point. */
129
130         if (value) {
131                 BKE_nla_tweakmode_enter(adt);
132         }
133         else {
134                 BKE_nla_tweakmode_exit(adt);
135         }
136 }
137
138 /* ****************************** */
139
140 /* wrapper for poll callback */
141 static int RKS_POLL_rna_internal(KeyingSetInfo *ksi, bContext *C)
142 {
143         extern FunctionRNA rna_KeyingSetInfo_poll_func;
144
145         PointerRNA ptr;
146         ParameterList list;
147         FunctionRNA *func;
148         void *ret;
149         int ok;
150
151         RNA_pointer_create(NULL, ksi->ext.srna, ksi, &ptr);
152         func = &rna_KeyingSetInfo_poll_func; /* RNA_struct_find_function(&ptr, "poll"); */
153
154         RNA_parameter_list_create(&list, &ptr, func);
155         {
156                 /* hook up arguments */
157                 RNA_parameter_set_lookup(&list, "ksi", &ksi);
158                 RNA_parameter_set_lookup(&list, "context", &C);
159                 
160                 /* execute the function */
161                 ksi->ext.call(C, &ptr, func, &list);
162                 
163                 /* read the result */
164                 RNA_parameter_get_lookup(&list, "ok", &ret);
165                 ok = *(int *)ret;
166         }
167         RNA_parameter_list_free(&list);
168         
169         return ok;
170 }
171
172 /* wrapper for iterator callback */
173 static void RKS_ITER_rna_internal(KeyingSetInfo *ksi, bContext *C, KeyingSet *ks)
174 {
175         extern FunctionRNA rna_KeyingSetInfo_iterator_func;
176
177         PointerRNA ptr;
178         ParameterList list;
179         FunctionRNA *func;
180
181         RNA_pointer_create(NULL, ksi->ext.srna, ksi, &ptr);
182         func = &rna_KeyingSetInfo_iterator_func; /* RNA_struct_find_function(&ptr, "poll"); */
183
184         RNA_parameter_list_create(&list, &ptr, func);
185         {
186                 /* hook up arguments */
187                 RNA_parameter_set_lookup(&list, "ksi", &ksi);
188                 RNA_parameter_set_lookup(&list, "context", &C);
189                 RNA_parameter_set_lookup(&list, "ks", &ks);
190                 
191                 /* execute the function */
192                 ksi->ext.call(C, &ptr, func, &list);
193         }
194         RNA_parameter_list_free(&list);
195 }
196
197 /* wrapper for generator callback */
198 static void RKS_GEN_rna_internal(KeyingSetInfo *ksi, bContext *C, KeyingSet *ks, PointerRNA *data)
199 {
200         extern FunctionRNA rna_KeyingSetInfo_generate_func;
201
202         PointerRNA ptr;
203         ParameterList list;
204         FunctionRNA *func;
205
206         RNA_pointer_create(NULL, ksi->ext.srna, ksi, &ptr);
207         func = &rna_KeyingSetInfo_generate_func; /* RNA_struct_find_generate(&ptr, "poll"); */
208
209         RNA_parameter_list_create(&list, &ptr, func);
210         {
211                 /* hook up arguments */
212                 RNA_parameter_set_lookup(&list, "ksi", &ksi);
213                 RNA_parameter_set_lookup(&list, "context", &C);
214                 RNA_parameter_set_lookup(&list, "ks", &ks);
215                 RNA_parameter_set_lookup(&list, "data", data);
216                 
217                 /* execute the function */
218                 ksi->ext.call(C, &ptr, func, &list);
219         }
220         RNA_parameter_list_free(&list);
221 }
222
223 /* ------ */
224
225 /* XXX: the exact purpose of this is not too clear... maybe we want to revise this at some point? */
226 static StructRNA *rna_KeyingSetInfo_refine(PointerRNA *ptr)
227 {
228         KeyingSetInfo *ksi = (KeyingSetInfo *)ptr->data;
229         return (ksi->ext.srna) ? ksi->ext.srna : &RNA_KeyingSetInfo;
230 }
231
232 static void rna_KeyingSetInfo_unregister(Main *bmain, StructRNA *type)
233 {
234         KeyingSetInfo *ksi = RNA_struct_blender_type_get(type);
235
236         if (ksi == NULL)
237                 return;
238         
239         /* free RNA data referencing this */
240         RNA_struct_free_extension(type, &ksi->ext);
241         RNA_struct_free(&BLENDER_RNA, type);
242         
243         WM_main_add_notifier(NC_WINDOW, NULL);
244
245         /* unlink Blender-side data */
246         ANIM_keyingset_info_unregister(bmain, ksi);
247 }
248
249 static StructRNA *rna_KeyingSetInfo_register(
250         Main *bmain, ReportList *reports, void *data, const char *identifier,
251         StructValidateFunc validate, StructCallbackFunc call, StructFreeFunc free)
252 {
253         KeyingSetInfo dummyksi = {NULL};
254         KeyingSetInfo *ksi;
255         PointerRNA dummyptr = {{NULL}};
256         int have_function[3];
257
258         /* setup dummy type info to store static properties in */
259         /* TODO: perhaps we want to get users to register as if they're using 'KeyingSet' directly instead? */
260         RNA_pointer_create(NULL, &RNA_KeyingSetInfo, &dummyksi, &dummyptr);
261         
262         /* validate the python class */
263         if (validate(&dummyptr, data, have_function) != 0)
264                 return NULL;
265         
266         if (strlen(identifier) >= sizeof(dummyksi.idname)) {
267                 BKE_reportf(reports, RPT_ERROR, "Registering keying set info class: '%s' is too long, maximum length is %d",
268                             identifier, (int)sizeof(dummyksi.idname));
269                 return NULL;
270         }
271         
272         /* check if we have registered this info before, and remove it */
273         ksi = ANIM_keyingset_info_find_name(dummyksi.idname);
274         if (ksi && ksi->ext.srna) {
275                 rna_KeyingSetInfo_unregister(bmain, ksi->ext.srna);
276         }
277
278         /* create a new KeyingSetInfo type */
279         ksi = MEM_callocN(sizeof(KeyingSetInfo), "python keying set info");
280         memcpy(ksi, &dummyksi, sizeof(KeyingSetInfo));
281         
282         /* set RNA-extensions info */
283         ksi->ext.srna = RNA_def_struct_ptr(&BLENDER_RNA, ksi->idname, &RNA_KeyingSetInfo);
284         ksi->ext.data = data;
285         ksi->ext.call = call;
286         ksi->ext.free = free;
287         RNA_struct_blender_type_set(ksi->ext.srna, ksi);
288         
289         /* set callbacks */
290         /* NOTE: we really should have all of these...  */
291         ksi->poll = (have_function[0]) ? RKS_POLL_rna_internal : NULL;
292         ksi->iter = (have_function[1]) ? RKS_ITER_rna_internal : NULL;
293         ksi->generate = (have_function[2]) ? RKS_GEN_rna_internal : NULL;
294         
295         /* add and register with other info as needed */
296         ANIM_keyingset_info_register(ksi);
297         
298         WM_main_add_notifier(NC_WINDOW, NULL);
299
300         /* return the struct-rna added */
301         return ksi->ext.srna;
302 }
303
304 /* ****************************** */
305
306 static StructRNA *rna_ksPath_id_typef(PointerRNA *ptr)
307 {
308         KS_Path *ksp = (KS_Path *)ptr->data;
309         return ID_code_to_RNA_type(ksp->idtype);
310 }
311
312 static int rna_ksPath_id_editable(PointerRNA *ptr, const char **UNUSED(r_info))
313 {
314         KS_Path *ksp = (KS_Path *)ptr->data;
315         return (ksp->idtype) ? PROP_EDITABLE : 0;
316 }
317
318 static void rna_ksPath_id_type_set(PointerRNA *ptr, int value)
319 {
320         KS_Path *data = (KS_Path *)(ptr->data);
321         
322         /* set the driver type, then clear the id-block if the type is invalid */
323         data->idtype = value;
324         if ((data->id) && (GS(data->id->name) != data->idtype))
325                 data->id = NULL;
326 }
327
328 static void rna_ksPath_RnaPath_get(PointerRNA *ptr, char *value)
329 {
330         KS_Path *ksp = (KS_Path *)ptr->data;
331
332         if (ksp->rna_path)
333                 strcpy(value, ksp->rna_path);
334         else
335                 value[0] = '\0';
336 }
337
338 static int rna_ksPath_RnaPath_length(PointerRNA *ptr)
339 {
340         KS_Path *ksp = (KS_Path *)ptr->data;
341         
342         if (ksp->rna_path)
343                 return strlen(ksp->rna_path);
344         else
345                 return 0;
346 }
347
348 static void rna_ksPath_RnaPath_set(PointerRNA *ptr, const char *value)
349 {
350         KS_Path *ksp = (KS_Path *)ptr->data;
351
352         if (ksp->rna_path)
353                 MEM_freeN(ksp->rna_path);
354         
355         if (value[0])
356                 ksp->rna_path = BLI_strdup(value);
357         else
358                 ksp->rna_path = NULL;
359 }
360
361 /* ****************************** */
362
363 static void rna_KeyingSet_name_set(PointerRNA *ptr, const char *value)
364 {
365         KeyingSet *ks = (KeyingSet *)ptr->data;
366         
367         /* update names of corresponding groups if name changes */
368         if (!STREQ(ks->name, value)) {
369                 KS_Path *ksp;
370                 
371                 for (ksp = ks->paths.first; ksp; ksp = ksp->next) {
372                         if ((ksp->groupmode == KSP_GROUP_KSNAME) && (ksp->id)) {
373                                 AnimData *adt = BKE_animdata_from_id(ksp->id);
374                                 
375                                 /* TODO: NLA strips? */
376                                 if (adt && adt->action) {
377                                         bActionGroup *agrp;
378                                         
379                                         /* lazy check - should really find the F-Curve for the affected path and check its group 
380                                          * but this way should be faster and work well for most cases, as long as there are no
381                                          * conflicts
382                                          */
383                                         for (agrp = adt->action->groups.first; agrp; agrp = agrp->next) {
384                                                 if (STREQ(ks->name, agrp->name)) {
385                                                         /* there should only be one of these in the action, so can stop... */
386                                                         BLI_strncpy(agrp->name, value, sizeof(agrp->name));
387                                                         break;
388                                                 }
389                                         }
390                                 }
391                         }
392                 }
393         }
394         
395         /* finally, update name to new value */
396         BLI_strncpy(ks->name, value, sizeof(ks->name));
397 }
398
399
400 static int rna_KeyingSet_active_ksPath_editable(PointerRNA *ptr, const char **UNUSED(r_info))
401 {
402         KeyingSet *ks = (KeyingSet *)ptr->data;
403         
404         /* only editable if there are some paths to change to */
405         return (BLI_listbase_is_empty(&ks->paths) == false) ? PROP_EDITABLE : 0;
406 }
407
408 static PointerRNA rna_KeyingSet_active_ksPath_get(PointerRNA *ptr)
409 {
410         KeyingSet *ks = (KeyingSet *)ptr->data;
411         return rna_pointer_inherit_refine(ptr, &RNA_KeyingSetPath, BLI_findlink(&ks->paths, ks->active_path - 1));
412 }
413
414 static void rna_KeyingSet_active_ksPath_set(PointerRNA *ptr, PointerRNA value)
415 {
416         KeyingSet *ks = (KeyingSet *)ptr->data;
417         KS_Path *ksp = (KS_Path *)value.data;
418         ks->active_path = BLI_findindex(&ks->paths, ksp) + 1;
419 }
420
421 static int rna_KeyingSet_active_ksPath_index_get(PointerRNA *ptr)
422 {
423         KeyingSet *ks = (KeyingSet *)ptr->data;
424         return MAX2(ks->active_path - 1, 0);
425 }
426
427 static void rna_KeyingSet_active_ksPath_index_set(PointerRNA *ptr, int value)
428 {
429         KeyingSet *ks = (KeyingSet *)ptr->data;
430         ks->active_path = value + 1;
431 }
432
433 static void rna_KeyingSet_active_ksPath_index_range(PointerRNA *ptr, int *min, int *max,
434                                                     int *UNUSED(softmin), int *UNUSED(softmax))
435 {
436         KeyingSet *ks = (KeyingSet *)ptr->data;
437
438         *min = 0;
439         *max = max_ii(0, BLI_listbase_count(&ks->paths) - 1);
440 }
441
442 static PointerRNA rna_KeyingSet_typeinfo_get(PointerRNA *ptr)
443 {
444         KeyingSet *ks = (KeyingSet *)ptr->data;
445         KeyingSetInfo *ksi = NULL;
446         
447         /* keying set info is only for builtin Keying Sets */
448         if ((ks->flag & KEYINGSET_ABSOLUTE) == 0)
449                 ksi = ANIM_keyingset_info_find_name(ks->typeinfo);
450         return rna_pointer_inherit_refine(ptr, &RNA_KeyingSetInfo, ksi);
451 }
452
453
454
455 static KS_Path *rna_KeyingSet_paths_add(KeyingSet *keyingset, ReportList *reports,
456                                         ID *id, const char rna_path[], int index, int group_method, const char group_name[])
457 {
458         KS_Path *ksp = NULL;
459         short flag = 0;
460         
461         /* special case when index = -1, we key the whole array (as with other places where index is used) */
462         if (index == -1) {
463                 flag |= KSP_FLAG_WHOLE_ARRAY;
464                 index = 0;
465         }
466         
467         /* if data is valid, call the API function for this */
468         if (keyingset) {
469                 ksp = BKE_keyingset_add_path(keyingset, id, group_name, rna_path, index, flag, group_method);
470                 keyingset->active_path = BLI_listbase_count(&keyingset->paths);
471         }
472         else {
473                 BKE_report(reports, RPT_ERROR, "Keying set path could not be added");
474         }
475         
476         /* return added path */
477         return ksp;
478 }
479
480 static void rna_KeyingSet_paths_remove(KeyingSet *keyingset, ReportList *reports, PointerRNA *ksp_ptr)
481 {
482         KS_Path *ksp = ksp_ptr->data;
483
484         /* if data is valid, call the API function for this */
485         if ((keyingset && ksp) == false) {
486                 BKE_report(reports, RPT_ERROR, "Keying set path could not be removed");
487                 return;
488         }
489
490         /* remove the active path from the KeyingSet */
491         BKE_keyingset_free_path(keyingset, ksp);
492         RNA_POINTER_INVALIDATE(ksp_ptr);
493
494         /* the active path number will most likely have changed */
495         /* TODO: we should get more fancy and actually check if it was removed, but this will do for now */
496         keyingset->active_path = 0;
497 }
498
499 static void rna_KeyingSet_paths_clear(KeyingSet *keyingset, ReportList *reports)
500 {
501         /* if data is valid, call the API function for this */
502         if (keyingset) {
503                 KS_Path *ksp, *kspn;
504                 
505                 /* free each path as we go to avoid looping twice */
506                 for (ksp = keyingset->paths.first; ksp; ksp = kspn) {
507                         kspn = ksp->next;
508                         BKE_keyingset_free_path(keyingset, ksp);
509                 }
510                         
511                 /* reset the active path, since there aren't any left */
512                 keyingset->active_path = 0;
513         }
514         else {
515                 BKE_report(reports, RPT_ERROR, "Keying set paths could not be removed");
516         }
517 }
518
519 /* needs wrapper function to push notifier */
520 static NlaTrack *rna_NlaTrack_new(AnimData *adt, bContext *C, NlaTrack *track)
521 {
522         NlaTrack *new_track = BKE_nlatrack_add(adt, track);
523
524         WM_event_add_notifier(C, NC_ANIMATION | ND_NLA | NA_ADDED, NULL);
525
526         return new_track;
527 }
528
529 static void rna_NlaTrack_remove(AnimData *adt, bContext *C, ReportList *reports, PointerRNA *track_ptr)
530 {
531         NlaTrack *track = track_ptr->data;
532
533         if (BLI_findindex(&adt->nla_tracks, track) == -1) {
534                 BKE_reportf(reports, RPT_ERROR, "NlaTrack '%s' cannot be removed", track->name);
535                 return;
536         }
537
538         BKE_nlatrack_free(&adt->nla_tracks, track);
539         RNA_POINTER_INVALIDATE(track_ptr);
540
541         WM_event_add_notifier(C, NC_ANIMATION | ND_NLA | NA_REMOVED, NULL);
542 }
543
544 static PointerRNA rna_NlaTrack_active_get(PointerRNA *ptr)
545 {
546         AnimData *adt = (AnimData *)ptr->data;
547         NlaTrack *track = BKE_nlatrack_find_active(&adt->nla_tracks);
548         return rna_pointer_inherit_refine(ptr, &RNA_NlaTrack, track);
549 }
550
551 static void rna_NlaTrack_active_set(PointerRNA *ptr, PointerRNA value)
552 {
553         AnimData *adt = (AnimData *)ptr->data;
554         NlaTrack *track = (NlaTrack *)value.data;
555         BKE_nlatrack_set_active(&adt->nla_tracks, track);
556 }
557
558
559 static FCurve *rna_Driver_from_existing(AnimData *adt, bContext *C, FCurve *src_driver)
560 {
561         /* verify that we've got a driver to duplicate */
562         if (ELEM(NULL, src_driver, src_driver->driver)) {
563                 BKE_report(CTX_wm_reports(C), RPT_ERROR, "No valid driver data to create copy of");
564                 return NULL;
565         }
566         else {
567                 /* just make a copy of the existing one and add to self */
568                 FCurve *new_fcu = copy_fcurve(src_driver);
569                 
570                 /* XXX: if we impose any ordering on these someday, this will be problematic */
571                 BLI_addtail(&adt->drivers, new_fcu);
572                 return new_fcu;
573         }
574 }
575
576 static FCurve *rna_Driver_find(AnimData *adt, ReportList *reports, const char *data_path, int index)
577 {
578         if (data_path[0] == '\0') {
579                 BKE_report(reports, RPT_ERROR, "F-Curve data path empty, invalid argument");
580                 return NULL;
581         }
582
583         /* Returns NULL if not found. */
584         return list_find_fcurve(&adt->drivers, data_path, index);
585 }
586
587 #else
588
589 /* helper function for Keying Set -> keying settings */
590 static void rna_def_common_keying_flags(StructRNA *srna, short reg)
591 {
592         PropertyRNA *prop;
593         
594         /* override scene/userpref defaults? */
595         prop = RNA_def_property(srna, "use_insertkey_override_needed", PROP_BOOLEAN, PROP_NONE);
596         RNA_def_property_boolean_sdna(prop, NULL, "keyingoverride", INSERTKEY_NEEDED);
597         RNA_def_property_ui_text(prop, "Override Insert Keyframes Default- Only Needed", 
598                                  "Override default setting to only insert keyframes where they're needed in the relevant F-Curves");
599         if (reg) RNA_def_property_flag(prop, PROP_REGISTER_OPTIONAL);
600         
601         prop = RNA_def_property(srna, "use_insertkey_override_visual", PROP_BOOLEAN, PROP_NONE);
602         RNA_def_property_boolean_sdna(prop, NULL, "keyingoverride", INSERTKEY_MATRIX);
603         RNA_def_property_ui_text(prop, "Override Insert Keyframes Default - Visual", 
604                                  "Override default setting to insert keyframes based on 'visual transforms'");
605         if (reg) RNA_def_property_flag(prop, PROP_REGISTER_OPTIONAL);
606         
607         prop = RNA_def_property(srna, "use_insertkey_override_xyz_to_rgb", PROP_BOOLEAN, PROP_NONE);
608         RNA_def_property_boolean_sdna(prop, NULL, "keyingoverride", INSERTKEY_XYZ2RGB);
609         RNA_def_property_ui_text(prop, "Override F-Curve Colors - XYZ to RGB",
610                                 "Override default setting to set color for newly added transformation F-Curves "
611                                 "(Location, Rotation, Scale) to be based on the transform axis");
612         if (reg) RNA_def_property_flag(prop, PROP_REGISTER_OPTIONAL);
613         
614         
615         /* value to override defaults with */
616         prop = RNA_def_property(srna, "use_insertkey_needed", PROP_BOOLEAN, PROP_NONE);
617         RNA_def_property_boolean_sdna(prop, NULL, "keyingflag", INSERTKEY_NEEDED);
618         RNA_def_property_ui_text(prop, "Insert Keyframes - Only Needed", "Only insert keyframes where they're needed in the relevant F-Curves");
619         if (reg) RNA_def_property_flag(prop, PROP_REGISTER_OPTIONAL);
620         
621         prop = RNA_def_property(srna, "use_insertkey_visual", PROP_BOOLEAN, PROP_NONE);
622         RNA_def_property_boolean_sdna(prop, NULL, "keyingflag", INSERTKEY_MATRIX);
623         RNA_def_property_ui_text(prop, "Insert Keyframes - Visual", "Insert keyframes based on 'visual transforms'");
624         if (reg) RNA_def_property_flag(prop, PROP_REGISTER_OPTIONAL);
625         
626         prop = RNA_def_property(srna, "use_insertkey_xyz_to_rgb", PROP_BOOLEAN, PROP_NONE);
627         RNA_def_property_boolean_sdna(prop, NULL, "keyingflag", INSERTKEY_XYZ2RGB);
628         RNA_def_property_ui_text(prop, "F-Curve Colors - XYZ to RGB", "Color for newly added transformation F-Curves (Location, Rotation, Scale) is based on the transform axis");
629         if (reg) RNA_def_property_flag(prop, PROP_REGISTER_OPTIONAL);
630 }
631
632 /* --- */
633
634 /* To avoid repeating it twice! */
635 #define KEYINGSET_IDNAME_DOC \
636     "If this is set, the Keying Set gets a custom ID, otherwise it takes " \
637     "the name of the class used to define the Keying Set (for example, "   \
638     "if the class name is \"BUILTIN_KSI_location\", and bl_idname is not " \
639     "set by the script, then bl_idname = \"BUILTIN_KSI_location\")"
640
641
642 static void rna_def_keyingset_info(BlenderRNA *brna)
643 {
644         StructRNA *srna;
645         PropertyRNA *prop;
646         FunctionRNA *func;
647         PropertyRNA *parm;
648         
649         srna = RNA_def_struct(brna, "KeyingSetInfo", NULL);
650         RNA_def_struct_sdna(srna, "KeyingSetInfo");
651         RNA_def_struct_ui_text(srna, "Keying Set Info", "Callback function defines for builtin Keying Sets");
652         RNA_def_struct_refine_func(srna, "rna_KeyingSetInfo_refine");
653         RNA_def_struct_register_funcs(srna, "rna_KeyingSetInfo_register", "rna_KeyingSetInfo_unregister", NULL);
654         
655         /* Properties --------------------- */
656         
657         RNA_define_verify_sdna(0); /* not in sdna */
658         
659         prop = RNA_def_property(srna, "bl_idname", PROP_STRING, PROP_NONE);
660         RNA_def_property_string_sdna(prop, NULL, "idname");
661         RNA_def_property_flag(prop, PROP_REGISTER);
662         RNA_def_property_ui_text(prop, "ID Name", KEYINGSET_IDNAME_DOC);
663         
664         prop = RNA_def_property(srna, "bl_label", PROP_STRING, PROP_NONE);
665         RNA_def_property_string_sdna(prop, NULL, "name");
666         RNA_def_property_ui_text(prop, "UI Name", "");
667         RNA_def_struct_name_property(srna, prop);
668         RNA_def_property_flag(prop, PROP_REGISTER);
669         
670         prop = RNA_def_property(srna, "bl_description", PROP_STRING, PROP_NONE);
671         RNA_def_property_string_sdna(prop, NULL, "description");
672         RNA_def_property_string_maxlength(prop, RNA_DYN_DESCR_MAX); /* else it uses the pointer size! */
673         RNA_def_property_flag(prop, PROP_REGISTER_OPTIONAL);
674         RNA_def_property_ui_text(prop, "Description", "A short description of the keying set");
675         
676         /* Regarding why we don't use rna_def_common_keying_flags() here:
677          * - Using it would keep this case in sync with the other places 
678          *   where these options are exposed (which are optimized for being
679          *   used in the UI).
680          * - Unlike all the other places, this case is used for defining
681          *   new "built in" Keying Sets via the Python API. In that case,
682          *   it makes more sense to expose these in a way more similar to
683          *   other places featuring bl_idname/label/description (i.e. operators)
684          */
685         prop = RNA_def_property(srna, "bl_options", PROP_ENUM, PROP_NONE);
686         RNA_def_property_enum_sdna(prop, NULL, "keyingflag");
687         RNA_def_property_enum_items(prop, rna_enum_keying_flag_items);
688         RNA_def_property_flag(prop, PROP_REGISTER_OPTIONAL | PROP_ENUM_FLAG);
689         RNA_def_property_ui_text(prop, "Options",  "Keying Set options to use when inserting keyframes");
690         
691         RNA_define_verify_sdna(1);
692         
693         /* Function Callbacks ------------- */
694         /* poll */
695         func = RNA_def_function(srna, "poll", NULL);
696         RNA_def_function_ui_description(func, "Test if Keying Set can be used or not");
697         RNA_def_function_flag(func, FUNC_REGISTER);
698         RNA_def_function_return(func, RNA_def_boolean(func, "ok", 1, "", ""));
699         parm = RNA_def_pointer(func, "context", "Context", "", "");
700         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
701         
702         /* iterator */
703         func = RNA_def_function(srna, "iterator", NULL);
704         RNA_def_function_ui_description(func, "Call generate() on the structs which have properties to be keyframed");
705         RNA_def_function_flag(func, FUNC_REGISTER);
706         parm = RNA_def_pointer(func, "context", "Context", "", "");
707         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
708         parm = RNA_def_pointer(func, "ks", "KeyingSet", "", "");
709         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
710         
711         /* generate */
712         func = RNA_def_function(srna, "generate", NULL);
713         RNA_def_function_ui_description(func, "Add Paths to the Keying Set to keyframe the properties of the given data");
714         RNA_def_function_flag(func, FUNC_REGISTER);
715         parm = RNA_def_pointer(func, "context", "Context", "", "");
716         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
717         parm = RNA_def_pointer(func, "ks", "KeyingSet", "", "");
718         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
719         parm = RNA_def_pointer(func, "data", "AnyType", "", "");
720         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
721 }
722
723 static void rna_def_keyingset_path(BlenderRNA *brna)
724 {
725         StructRNA *srna;
726         PropertyRNA *prop;
727         
728         srna = RNA_def_struct(brna, "KeyingSetPath", NULL);
729         RNA_def_struct_sdna(srna, "KS_Path");
730         RNA_def_struct_ui_text(srna, "Keying Set Path", "Path to a setting for use in a Keying Set");
731         
732         /* ID */
733         prop = RNA_def_property(srna, "id", PROP_POINTER, PROP_NONE);
734         RNA_def_property_struct_type(prop, "ID");
735         RNA_def_property_flag(prop, PROP_EDITABLE);
736         RNA_def_property_editable_func(prop, "rna_ksPath_id_editable");
737         RNA_def_property_pointer_funcs(prop, NULL, NULL, "rna_ksPath_id_typef", NULL);
738         RNA_def_property_ui_text(prop, "ID-Block",
739                                  "ID-Block that keyframes for Keying Set should be added to "
740                                  "(for Absolute Keying Sets only)");
741         RNA_def_property_update(prop, NC_SCENE | ND_KEYINGSET | NA_EDITED, NULL); /* XXX: maybe a bit too noisy */
742         
743         prop = RNA_def_property(srna, "id_type", PROP_ENUM, PROP_NONE);
744         RNA_def_property_enum_sdna(prop, NULL, "idtype");
745         RNA_def_property_enum_items(prop, rna_enum_id_type_items);
746         RNA_def_property_enum_default(prop, ID_OB);
747         RNA_def_property_enum_funcs(prop, NULL, "rna_ksPath_id_type_set", NULL);
748         RNA_def_property_ui_text(prop, "ID Type", "Type of ID-block that can be used");
749         RNA_def_property_translation_context(prop, BLT_I18NCONTEXT_ID_ID);
750         RNA_def_property_update(prop, NC_SCENE | ND_KEYINGSET | NA_EDITED, NULL); /* XXX: maybe a bit too noisy */
751         
752         /* Group */
753         prop = RNA_def_property(srna, "group", PROP_STRING, PROP_NONE);
754         RNA_def_property_ui_text(prop, "Group Name", "Name of Action Group to assign setting(s) for this path to");
755         RNA_def_property_update(prop, NC_SCENE | ND_KEYINGSET | NA_EDITED, NULL); /* XXX: maybe a bit too noisy */
756         
757         /* Grouping */
758         prop = RNA_def_property(srna, "group_method", PROP_ENUM, PROP_NONE);
759         RNA_def_property_enum_sdna(prop, NULL, "groupmode");
760         RNA_def_property_enum_items(prop, rna_enum_keyingset_path_grouping_items);
761         RNA_def_property_ui_text(prop, "Grouping Method", "Method used to define which Group-name to use");
762         RNA_def_property_update(prop, NC_SCENE | ND_KEYINGSET | NA_EDITED, NULL); /* XXX: maybe a bit too noisy */
763         
764         /* Path + Array Index */
765         prop = RNA_def_property(srna, "data_path", PROP_STRING, PROP_NONE);
766         RNA_def_property_string_funcs(prop, "rna_ksPath_RnaPath_get", "rna_ksPath_RnaPath_length",
767                                       "rna_ksPath_RnaPath_set");
768         RNA_def_property_ui_text(prop, "Data Path", "Path to property setting");
769         RNA_def_struct_name_property(srna, prop); /* XXX this is the best indicator for now... */
770         RNA_def_property_update(prop, NC_SCENE | ND_KEYINGSET | NA_EDITED, NULL);
771
772         /* called 'index' when given as function arg */
773         prop = RNA_def_property(srna, "array_index", PROP_INT, PROP_NONE);
774         RNA_def_property_ui_text(prop, "RNA Array Index", "Index to the specific setting if applicable");
775         RNA_def_property_update(prop, NC_SCENE | ND_KEYINGSET | NA_EDITED, NULL); /* XXX: maybe a bit too noisy */
776         
777         /* Flags */
778         prop = RNA_def_property(srna, "use_entire_array", PROP_BOOLEAN, PROP_NONE);
779         RNA_def_property_boolean_sdna(prop, NULL, "flag", KSP_FLAG_WHOLE_ARRAY);
780         RNA_def_property_ui_text(prop, "Entire Array",
781                                  "When an 'array/vector' type is chosen (Location, Rotation, Color, etc.), "
782                                  "entire array is to be used");
783         RNA_def_property_update(prop, NC_SCENE | ND_KEYINGSET | NA_EDITED, NULL); /* XXX: maybe a bit too noisy */
784         
785         /* Keyframing Settings */
786         rna_def_common_keying_flags(srna, 0);
787 }
788
789
790 /* keyingset.paths */
791 static void rna_def_keyingset_paths(BlenderRNA *brna, PropertyRNA *cprop)
792 {
793         StructRNA *srna;
794
795         FunctionRNA *func;
796         PropertyRNA *parm;
797         
798         PropertyRNA *prop;
799
800         RNA_def_property_srna(cprop, "KeyingSetPaths");
801         srna = RNA_def_struct(brna, "KeyingSetPaths", NULL);
802         RNA_def_struct_sdna(srna, "KeyingSet");
803         RNA_def_struct_ui_text(srna, "Keying set paths", "Collection of keying set paths");
804
805         
806         /* Add Path */
807         func = RNA_def_function(srna, "add", "rna_KeyingSet_paths_add");
808         RNA_def_function_ui_description(func, "Add a new path for the Keying Set");
809         RNA_def_function_flag(func, FUNC_USE_REPORTS);
810         /* return arg */
811         parm = RNA_def_pointer(func, "ksp", "KeyingSetPath", "New Path", "Path created and added to the Keying Set");
812         RNA_def_function_return(func, parm);
813         /* ID-block for target */
814         parm = RNA_def_pointer(func, "target_id", "ID", "Target ID", "ID data-block for the destination");
815         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
816         /* rna-path */
817         /* XXX hopefully this is long enough */
818         parm = RNA_def_string(func, "data_path", NULL, 256, "Data-Path", "RNA-Path to destination property");
819         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
820         /* index (defaults to -1 for entire array) */
821         RNA_def_int(func, "index", -1, -1, INT_MAX, "Index",
822                     "The index of the destination property (i.e. axis of Location/Rotation/etc.), "
823                     "or -1 for the entire array", 0, INT_MAX);
824         /* grouping */
825         RNA_def_enum(func, "group_method", rna_enum_keyingset_path_grouping_items, KSP_GROUP_KSNAME,
826                      "Grouping Method", "Method used to define which Group-name to use");
827         RNA_def_string(func, "group_name", NULL, 64, "Group Name",
828                        "Name of Action Group to assign destination to (only if grouping mode is to use this name)");
829
830
831         /* Remove Path */
832         func = RNA_def_function(srna, "remove", "rna_KeyingSet_paths_remove");
833         RNA_def_function_ui_description(func, "Remove the given path from the Keying Set");
834         RNA_def_function_flag(func, FUNC_USE_REPORTS);
835         /* path to remove */
836         parm = RNA_def_pointer(func, "path", "KeyingSetPath", "Path", "");
837         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
838         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
839
840
841         /* Remove All Paths */
842         func = RNA_def_function(srna, "clear", "rna_KeyingSet_paths_clear");
843         RNA_def_function_ui_description(func, "Remove all the paths from the Keying Set");
844         RNA_def_function_flag(func, FUNC_USE_REPORTS);
845         
846         prop = RNA_def_property(srna, "active", PROP_POINTER, PROP_NONE);
847         RNA_def_property_struct_type(prop, "KeyingSetPath");
848         RNA_def_property_flag(prop, PROP_EDITABLE);
849         RNA_def_property_editable_func(prop, "rna_KeyingSet_active_ksPath_editable");
850         RNA_def_property_pointer_funcs(prop, "rna_KeyingSet_active_ksPath_get",
851                                        "rna_KeyingSet_active_ksPath_set", NULL, NULL);
852         RNA_def_property_ui_text(prop, "Active Keying Set", "Active Keying Set used to insert/delete keyframes");
853
854         prop = RNA_def_property(srna, "active_index", PROP_INT, PROP_NONE);
855         RNA_def_property_int_sdna(prop, NULL, "active_path");
856         RNA_def_property_int_funcs(prop, "rna_KeyingSet_active_ksPath_index_get", "rna_KeyingSet_active_ksPath_index_set",
857                                    "rna_KeyingSet_active_ksPath_index_range");
858         RNA_def_property_ui_text(prop, "Active Path Index", "Current Keying Set index");
859 }
860
861 static void rna_def_keyingset(BlenderRNA *brna)
862 {
863         StructRNA *srna;
864         PropertyRNA *prop;
865         
866         srna = RNA_def_struct(brna, "KeyingSet", NULL);
867         RNA_def_struct_ui_text(srna, "Keying Set", "Settings that should be keyframed together");
868         
869         /* Id/Label */
870         prop = RNA_def_property(srna, "bl_idname", PROP_STRING, PROP_NONE);
871         RNA_def_property_string_sdna(prop, NULL, "idname");
872         RNA_def_property_flag(prop, PROP_REGISTER);
873         RNA_def_property_ui_text(prop, "ID Name", KEYINGSET_IDNAME_DOC);
874 /*      RNA_def_property_update(prop, NC_SCENE | ND_KEYINGSET | NA_RENAME, NULL); */ /* NOTE: disabled, as ID name shouldn't be editable */
875         
876         prop = RNA_def_property(srna, "bl_label", PROP_STRING, PROP_NONE);
877         RNA_def_property_string_sdna(prop, NULL, "name");
878         RNA_def_property_string_funcs(prop, NULL, NULL, "rna_KeyingSet_name_set");
879         RNA_def_property_ui_text(prop, "UI Name", "");
880         RNA_def_struct_ui_icon(srna, ICON_KEYINGSET);
881         RNA_def_struct_name_property(srna, prop);
882         RNA_def_property_update(prop, NC_SCENE | ND_KEYINGSET | NA_RENAME, NULL);
883         
884         prop = RNA_def_property(srna, "bl_description", PROP_STRING, PROP_NONE);
885         RNA_def_property_string_sdna(prop, NULL, "description");
886         RNA_def_property_string_maxlength(prop, RNA_DYN_DESCR_MAX); /* else it uses the pointer size! */
887         RNA_def_property_flag(prop, PROP_REGISTER_OPTIONAL);
888         RNA_def_property_ui_text(prop, "Description", "A short description of the keying set");
889         
890         /* KeyingSetInfo (Type Info) for Builtin Sets only  */
891         prop = RNA_def_property(srna, "type_info", PROP_POINTER, PROP_NONE);
892         RNA_def_property_struct_type(prop, "KeyingSetInfo");
893         RNA_def_property_pointer_funcs(prop, "rna_KeyingSet_typeinfo_get", NULL, NULL, NULL);
894         RNA_def_property_ui_text(prop, "Type Info", "Callback function defines for built-in Keying Sets");
895         
896         /* Paths */
897         prop = RNA_def_property(srna, "paths", PROP_COLLECTION, PROP_NONE);
898         RNA_def_property_collection_sdna(prop, NULL, "paths", NULL);
899         RNA_def_property_struct_type(prop, "KeyingSetPath");
900         RNA_def_property_ui_text(prop, "Paths", "Keying Set Paths to define settings that get keyframed together");
901         rna_def_keyingset_paths(brna, prop);
902
903         /* Flags */
904         prop = RNA_def_property(srna, "is_path_absolute", PROP_BOOLEAN, PROP_NONE);
905         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
906         RNA_def_property_boolean_sdna(prop, NULL, "flag", KEYINGSET_ABSOLUTE);
907         RNA_def_property_ui_text(prop, "Absolute",
908                                  "Keying Set defines specific paths/settings to be keyframed "
909                                  "(i.e. is not reliant on context info)");
910         
911         /* Keyframing Flags */
912         rna_def_common_keying_flags(srna, 0);
913         
914         
915         /* Keying Set API */
916         RNA_api_keyingset(srna);
917 }
918
919 #undef KEYINGSET_IDNAME_DOC
920 /* --- */
921
922 static void rna_api_animdata_nla_tracks(BlenderRNA *brna, PropertyRNA *cprop)
923 {
924         StructRNA *srna;
925         PropertyRNA *parm;
926         FunctionRNA *func;
927
928         PropertyRNA *prop;
929         
930         RNA_def_property_srna(cprop, "NlaTracks");
931         srna = RNA_def_struct(brna, "NlaTracks", NULL);
932         RNA_def_struct_sdna(srna, "AnimData");
933         RNA_def_struct_ui_text(srna, "NLA Tracks", "Collection of NLA Tracks");
934         
935         func = RNA_def_function(srna, "new", "rna_NlaTrack_new");
936         RNA_def_function_flag(func, FUNC_USE_CONTEXT);
937         RNA_def_function_ui_description(func, "Add a new NLA Track");
938         RNA_def_pointer(func, "prev", "NlaTrack", "", "NLA Track to add the new one after");
939         /* return type */
940         parm = RNA_def_pointer(func, "track", "NlaTrack", "", "New NLA Track");
941         RNA_def_function_return(func, parm);
942         
943         func = RNA_def_function(srna, "remove", "rna_NlaTrack_remove");
944         RNA_def_function_flag(func, FUNC_USE_REPORTS | FUNC_USE_CONTEXT);
945         RNA_def_function_ui_description(func, "Remove a NLA Track");
946         parm = RNA_def_pointer(func, "track", "NlaTrack", "", "NLA Track to remove");
947         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
948         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
949
950         prop = RNA_def_property(srna, "active", PROP_POINTER, PROP_NONE);
951         RNA_def_property_struct_type(prop, "NlaTrack");
952         RNA_def_property_pointer_funcs(prop, "rna_NlaTrack_active_get", "rna_NlaTrack_active_set", NULL, NULL);
953         RNA_def_property_flag(prop, PROP_EDITABLE);
954         RNA_def_property_ui_text(prop, "Active Constraint", "Active Object constraint");
955         /* XXX: should (but doesn't) update the active track in the NLA window */
956         RNA_def_property_update(prop, NC_ANIMATION | ND_NLA | NA_SELECTED, NULL);
957 }
958
959 static void rna_api_animdata_drivers(BlenderRNA *brna, PropertyRNA *cprop)
960 {
961         StructRNA *srna;
962         PropertyRNA *parm;
963         FunctionRNA *func;
964
965         /* PropertyRNA *prop; */
966         
967         RNA_def_property_srna(cprop, "AnimDataDrivers");
968         srna = RNA_def_struct(brna, "AnimDataDrivers", NULL);
969         RNA_def_struct_sdna(srna, "AnimData");
970         RNA_def_struct_ui_text(srna, "Drivers", "Collection of Driver F-Curves");
971         
972         /* AnimData.drivers.from_existing(...) */
973         func = RNA_def_function(srna, "from_existing", "rna_Driver_from_existing");
974         RNA_def_function_flag(func, FUNC_USE_CONTEXT);
975         RNA_def_function_ui_description(func, "Add a new driver given an existing one");
976         RNA_def_pointer(func, "src_driver", "FCurve", "", "Existing Driver F-Curve to use as template for a new one");
977         /* return type */
978         parm = RNA_def_pointer(func, "driver", "FCurve", "", "New Driver F-Curve");
979         RNA_def_function_return(func, parm);
980         
981         /* AnimData.drivers.find(...) */
982         func = RNA_def_function(srna, "find", "rna_Driver_find");
983         RNA_def_function_ui_description(func, "Find a driver F-Curve. Note that this function performs a linear scan "
984                                         "of all driver F-Curves.");
985         RNA_def_function_flag(func, FUNC_USE_REPORTS);
986         parm = RNA_def_string(func, "data_path", NULL, 0, "Data Path", "F-Curve data path");
987         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
988         RNA_def_int(func, "index", 0, 0, INT_MAX, "Index", "Array index", 0, INT_MAX);
989         /* return type */
990         parm = RNA_def_pointer(func, "fcurve", "FCurve", "", "The found F-Curve, or None if it doesn't exist");
991         RNA_def_function_return(func, parm);
992 }
993
994 void rna_def_animdata_common(StructRNA *srna)
995 {
996         PropertyRNA *prop;
997         
998         prop = RNA_def_property(srna, "animation_data", PROP_POINTER, PROP_NONE);
999         RNA_def_property_pointer_sdna(prop, NULL, "adt");
1000         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1001         RNA_def_property_ui_text(prop, "Animation Data", "Animation data for this data-block");
1002 }
1003
1004 static void rna_def_animdata(BlenderRNA *brna)
1005 {
1006         StructRNA *srna;
1007         PropertyRNA *prop;
1008         
1009         srna = RNA_def_struct(brna, "AnimData", NULL);
1010         RNA_def_struct_ui_text(srna, "Animation Data", "Animation data for data-block");
1011         RNA_def_struct_ui_icon(srna, ICON_ANIM_DATA);
1012         
1013         /* NLA */
1014         prop = RNA_def_property(srna, "nla_tracks", PROP_COLLECTION, PROP_NONE);
1015         RNA_def_property_collection_sdna(prop, NULL, "nla_tracks", NULL);
1016         RNA_def_property_struct_type(prop, "NlaTrack");
1017         RNA_def_property_ui_text(prop, "NLA Tracks", "NLA Tracks (i.e. Animation Layers)");
1018
1019         rna_api_animdata_nla_tracks(brna, prop);
1020         
1021         /* Active Action */
1022         prop = RNA_def_property(srna, "action", PROP_POINTER, PROP_NONE);
1023         /* this flag as well as the dynamic test must be defined for this to be editable... */
1024         RNA_def_property_flag(prop, PROP_EDITABLE | PROP_ID_REFCOUNT);
1025         RNA_def_property_pointer_funcs(prop, NULL, "rna_AnimData_action_set", NULL, "rna_Action_id_poll");
1026         RNA_def_property_editable_func(prop, "rna_AnimData_action_editable");
1027         RNA_def_property_ui_text(prop, "Action", "Active Action for this data-block");
1028         RNA_def_property_update(prop, NC_ANIMATION | ND_NLA_ACTCHANGE, "rna_AnimData_update");
1029
1030         /* Active Action Settings */
1031         prop = RNA_def_property(srna, "action_extrapolation", PROP_ENUM, PROP_NONE);
1032         RNA_def_property_enum_sdna(prop, NULL, "act_extendmode");
1033         RNA_def_property_enum_items(prop, rna_enum_nla_mode_extend_items);
1034         RNA_def_property_ui_text(prop, "Action Extrapolation",
1035                                  "Action to take for gaps past the Active Action's range (when evaluating with NLA)");
1036         RNA_def_property_update(prop, NC_ANIMATION | ND_NLA, NULL);
1037         
1038         prop = RNA_def_property(srna, "action_blend_type", PROP_ENUM, PROP_NONE);
1039         RNA_def_property_enum_sdna(prop, NULL, "act_blendmode");
1040         RNA_def_property_enum_items(prop, rna_enum_nla_mode_blend_items);
1041         RNA_def_property_ui_text(prop, "Action Blending",
1042                                  "Method used for combining Active Action's result with result of NLA stack");
1043         RNA_def_property_update(prop, NC_ANIMATION | ND_NLA, NULL); /* this will do? */
1044         
1045         prop = RNA_def_property(srna, "action_influence", PROP_FLOAT, PROP_NONE);
1046         RNA_def_property_float_sdna(prop, NULL, "act_influence");
1047         RNA_def_property_float_default(prop, 1.0f);
1048         RNA_def_property_range(prop, 0.0f, 1.0f);
1049         RNA_def_property_ui_text(prop, "Action Influence",
1050                                  "Amount the Active Action contributes to the result of the NLA stack");
1051         RNA_def_property_update(prop, NC_ANIMATION | ND_NLA, NULL); /* this will do? */
1052         
1053         /* Drivers */
1054         prop = RNA_def_property(srna, "drivers", PROP_COLLECTION, PROP_NONE);
1055         RNA_def_property_collection_sdna(prop, NULL, "drivers", NULL);
1056         RNA_def_property_struct_type(prop, "FCurve");
1057         RNA_def_property_ui_text(prop, "Drivers", "The Drivers/Expressions for this data-block");
1058         
1059         rna_api_animdata_drivers(brna, prop);
1060         
1061         /* General Settings */
1062         prop = RNA_def_property(srna, "use_nla", PROP_BOOLEAN, PROP_NONE);
1063         RNA_def_property_boolean_negative_sdna(prop, NULL, "flag", ADT_NLA_EVAL_OFF);
1064         RNA_def_property_ui_text(prop, "NLA Evaluation Enabled", "NLA stack is evaluated when evaluating this block");
1065         RNA_def_property_update(prop, NC_ANIMATION | ND_NLA, NULL); /* this will do? */
1066
1067         prop = RNA_def_property(srna, "use_tweak_mode", PROP_BOOLEAN, PROP_NONE);
1068         RNA_def_property_boolean_sdna(prop, NULL, "flag", ADT_NLA_EDIT_ON);
1069         RNA_def_property_boolean_funcs(prop, NULL, "rna_AnimData_tweakmode_set");
1070         RNA_def_property_ui_text(prop, "Use NLA Tweak Mode", "Whether to enable or disable tweak mode in NLA");
1071         RNA_def_property_update(prop, NC_ANIMATION | ND_NLA, NULL);
1072 }
1073
1074 /* --- */
1075
1076 void RNA_def_animation(BlenderRNA *brna)
1077 {
1078         rna_def_animdata(brna);
1079         
1080         rna_def_keyingset(brna);
1081         rna_def_keyingset_path(brna);
1082         rna_def_keyingset_info(brna);
1083 }
1084
1085 #endif