Cleanup: RNA boolean names (use prefix conventions)
[blender.git] / source / blender / makesrna / intern / rna_pose.c
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  */
16
17 /** \file \ingroup RNA
18  */
19
20
21 #include <stdlib.h>
22 #include <string.h>
23
24 #include "RNA_define.h"
25 #include "RNA_enum_types.h"
26
27 #include "rna_internal.h"
28
29 #include "DNA_action_types.h"
30 #include "DNA_armature_types.h"
31 #include "DNA_constraint_types.h"
32 #include "DNA_object_types.h"
33 #include "DNA_scene_types.h"
34
35 #include "BLI_math.h"
36
37 #include "BLT_translation.h"
38
39 #include "UI_resources.h"
40
41 #include "WM_types.h"
42
43 /* Bone and Group Color Sets */
44 const EnumPropertyItem rna_enum_color_sets_items[] = {
45         {0, "DEFAULT", 0, "Default Colors", ""},
46         {1, "THEME01", ICON_COLORSET_01_VEC, "01 - Theme Color Set", ""},
47         {2, "THEME02", ICON_COLORSET_02_VEC, "02 - Theme Color Set", ""},
48         {3, "THEME03", ICON_COLORSET_03_VEC, "03 - Theme Color Set", ""},
49         {4, "THEME04", ICON_COLORSET_04_VEC, "04 - Theme Color Set", ""},
50         {5, "THEME05", ICON_COLORSET_05_VEC, "05 - Theme Color Set", ""},
51         {6, "THEME06", ICON_COLORSET_06_VEC, "06 - Theme Color Set", ""},
52         {7, "THEME07", ICON_COLORSET_07_VEC, "07 - Theme Color Set", ""},
53         {8, "THEME08", ICON_COLORSET_08_VEC, "08 - Theme Color Set", ""},
54         {9, "THEME09", ICON_COLORSET_09_VEC, "09 - Theme Color Set", ""},
55         {10, "THEME10", ICON_COLORSET_10_VEC, "10 - Theme Color Set", ""},
56         {11, "THEME11", ICON_COLORSET_11_VEC, "11 - Theme Color Set", ""},
57         {12, "THEME12", ICON_COLORSET_12_VEC, "12 - Theme Color Set", ""},
58         {13, "THEME13", ICON_COLORSET_13_VEC, "13 - Theme Color Set", ""},
59         {14, "THEME14", ICON_COLORSET_14_VEC, "14 - Theme Color Set", ""},
60         {15, "THEME15", ICON_COLORSET_15_VEC, "15 - Theme Color Set", ""},
61         {16, "THEME16", ICON_COLORSET_16_VEC, "16 - Theme Color Set", ""},
62         {17, "THEME17", ICON_COLORSET_17_VEC, "17 - Theme Color Set", ""},
63         {18, "THEME18", ICON_COLORSET_18_VEC, "18 - Theme Color Set", ""},
64         {19, "THEME19", ICON_COLORSET_19_VEC, "19 - Theme Color Set", ""},
65         {20, "THEME20", ICON_COLORSET_20_VEC, "20 - Theme Color Set", ""},
66         {-1, "CUSTOM", 0, "Custom Color Set", ""},
67         {0, NULL, 0, NULL, NULL},
68 };
69
70 #ifdef RNA_RUNTIME
71
72 #include "BLI_ghash.h"
73 #include "BLI_string_utils.h"
74
75 #include "BIK_api.h"
76 #include "BKE_action.h"
77 #include "BKE_armature.h"
78
79 #include "DNA_userdef_types.h"
80
81 #include "MEM_guardedalloc.h"
82
83 #include "BKE_context.h"
84 #include "BKE_constraint.h"
85 #include "BKE_global.h"
86 #include "BKE_idprop.h"
87
88 #include "DEG_depsgraph.h"
89 #include "DEG_depsgraph_build.h"
90
91 #include "ED_object.h"
92 #include "ED_armature.h"
93
94 #include "WM_api.h"
95
96 #include "RNA_access.h"
97
98 static void rna_Pose_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
99 {
100         /* XXX when to use this? ob->pose->flag |= (POSE_LOCKED|POSE_DO_UNLOCK); */
101
102         DEG_id_tag_update(ptr->id.data, ID_RECALC_GEOMETRY);
103         WM_main_add_notifier(NC_OBJECT | ND_POSE, ptr->id.data);
104 }
105
106 static void rna_Pose_dependency_update(Main *bmain, Scene *UNUSED(scene), PointerRNA *ptr)
107 {
108         DEG_relations_tag_update(bmain);
109
110         DEG_id_tag_update(ptr->id.data, ID_RECALC_GEOMETRY);
111         WM_main_add_notifier(NC_OBJECT | ND_POSE, ptr->id.data);
112 }
113
114 static void rna_Pose_IK_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
115 {
116         /* XXX when to use this? ob->pose->flag |= (POSE_LOCKED|POSE_DO_UNLOCK); */
117         Object *ob = ptr->id.data;
118
119         DEG_id_tag_update(&ob->id, ID_RECALC_GEOMETRY);
120         WM_main_add_notifier(NC_OBJECT | ND_POSE, ptr->id.data);
121
122         BIK_clear_data(ob->pose);
123 }
124
125 static char *rna_PoseBone_path(PointerRNA *ptr)
126 {
127         bPoseChannel *pchan = ptr->data;
128         char name_esc[sizeof(pchan->name) * 2];
129
130         BLI_strescape(name_esc, pchan->name, sizeof(name_esc));
131         return BLI_sprintfN("pose.bones[\"%s\"]", name_esc);
132 }
133
134 /* Bone groups only. */
135
136 static bActionGroup *rna_bone_group_new(ID *id, bPose *pose, const char *name)
137 {
138         bActionGroup *grp = BKE_pose_add_group(pose, name);
139         WM_main_add_notifier(NC_OBJECT | ND_POSE | NA_ADDED, id);
140         return grp;
141 }
142
143 static void rna_bone_group_remove(ID *id, bPose *pose, ReportList *reports, PointerRNA *grp_ptr)
144 {
145         bActionGroup *grp = grp_ptr->data;
146         const int grp_idx = BLI_findindex(&pose->agroups, grp);
147
148         if (grp_idx == -1) {
149                 BKE_reportf(reports, RPT_ERROR, "Bone group '%s' not found in this object", grp->name);
150                 return;
151         }
152
153         BKE_pose_remove_group(pose, grp, grp_idx + 1);
154         WM_main_add_notifier(NC_OBJECT | ND_POSE | NA_REMOVED, id);
155 }
156
157
158 /* shared for actions groups and bone groups */
159
160 void rna_ActionGroup_colorset_set(PointerRNA *ptr, int value)
161 {
162         bActionGroup *grp = ptr->data;
163
164         /* ensure only valid values get set */
165         if ((value >= -1) && (value < 21)) {
166                 grp->customCol = value;
167
168                 /* sync colors stored with theme colors based on the index specified */
169                 action_group_colors_sync(grp, NULL);
170         }
171 }
172
173 bool rna_ActionGroup_is_custom_colorset_get(PointerRNA *ptr)
174 {
175         bActionGroup *grp = ptr->data;
176
177         return (grp->customCol < 0);
178 }
179
180 static void rna_BoneGroup_name_set(PointerRNA *ptr, const char *value)
181 {
182         Object *ob = ptr->id.data;
183         bActionGroup *agrp = ptr->data;
184
185         /* copy the new name into the name slot */
186         BLI_strncpy_utf8(agrp->name, value, sizeof(agrp->name));
187
188         BLI_uniquename(&ob->pose->agroups, agrp, CTX_DATA_(BLT_I18NCONTEXT_ID_ARMATURE, "Group"), '.',
189                        offsetof(bActionGroup, name), sizeof(agrp->name));
190 }
191
192 static IDProperty *rna_PoseBone_idprops(PointerRNA *ptr, bool create)
193 {
194         bPoseChannel *pchan = ptr->data;
195
196         if (create && !pchan->prop) {
197                 IDPropertyTemplate val = {0};
198                 pchan->prop = IDP_New(IDP_GROUP, &val, "RNA_PoseBone group");
199         }
200
201         return pchan->prop;
202 }
203
204 static void rna_Pose_ik_solver_set(struct PointerRNA *ptr, int value)
205 {
206         bPose *pose = (bPose *)ptr->data;
207
208         if (pose->iksolver != value) {
209                 /* the solver has changed, must clean any temporary structures */
210                 BIK_clear_data(pose);
211                 if (pose->ikparam) {
212                         MEM_freeN(pose->ikparam);
213                         pose->ikparam = NULL;
214                 }
215                 pose->iksolver = value;
216                 BKE_pose_ikparam_init(pose);
217         }
218 }
219
220 static void rna_Pose_ik_solver_update(Main *bmain, Scene *UNUSED(scene), PointerRNA *ptr)
221 {
222         Object *ob = ptr->id.data;
223         bPose *pose = ptr->data;
224
225         BKE_pose_tag_recalc(bmain, pose);  /* checks & sorts pose channels */
226         DEG_relations_tag_update(bmain);
227
228         BKE_pose_update_constraint_flags(pose);
229
230         object_test_constraints(bmain, ob);
231
232         DEG_id_tag_update(&ob->id, ID_RECALC_GEOMETRY | ID_RECALC_TRANSFORM);
233 }
234
235 /* rotation - axis-angle */
236 static void rna_PoseChannel_rotation_axis_angle_get(PointerRNA *ptr, float *value)
237 {
238         bPoseChannel *pchan = ptr->data;
239
240         /* for now, assume that rotation mode is axis-angle */
241         value[0] = pchan->rotAngle;
242         copy_v3_v3(&value[1], pchan->rotAxis);
243 }
244
245 /* rotation - axis-angle */
246 static void rna_PoseChannel_rotation_axis_angle_set(PointerRNA *ptr, const float *value)
247 {
248         bPoseChannel *pchan = ptr->data;
249
250         /* for now, assume that rotation mode is axis-angle */
251         pchan->rotAngle = value[0];
252         copy_v3_v3(pchan->rotAxis, &value[1]);
253
254         /* TODO: validate axis? */
255 }
256
257 static void rna_PoseChannel_rotation_mode_set(PointerRNA *ptr, int value)
258 {
259         bPoseChannel *pchan = ptr->data;
260
261         /* use API Method for conversions... */
262         BKE_rotMode_change_values(pchan->quat, pchan->eul, pchan->rotAxis, &pchan->rotAngle,
263                                   pchan->rotmode, (short)value);
264
265         /* finally, set the new rotation type */
266         pchan->rotmode = value;
267 }
268
269 static void rna_PoseChannel_name_set(PointerRNA *ptr, const char *value)
270 {
271         Object *ob = (Object *)ptr->id.data;
272         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
273         char oldname[sizeof(pchan->name)], newname[sizeof(pchan->name)];
274
275         /* need to be on the stack */
276         BLI_strncpy_utf8(newname, value, sizeof(pchan->name));
277         BLI_strncpy(oldname, pchan->name, sizeof(pchan->name));
278
279         BLI_assert(BKE_id_is_in_global_main(&ob->id));
280         BLI_assert(BKE_id_is_in_global_main(ob->data));
281         ED_armature_bone_rename(G_MAIN, ob->data, oldname, newname);
282 }
283
284 static bool rna_PoseChannel_has_ik_get(PointerRNA *ptr)
285 {
286         Object *ob = (Object *)ptr->id.data;
287         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
288
289         return BKE_pose_channel_in_IK_chain(ob, pchan);
290 }
291
292 static StructRNA *rna_IKParam_refine(PointerRNA *ptr)
293 {
294         bIKParam *param = (bIKParam *)ptr->data;
295
296         switch (param->iksolver) {
297                 case IKSOLVER_ITASC:
298                         return &RNA_Itasc;
299                 default:
300                         return &RNA_IKParam;
301         }
302 }
303
304 static PointerRNA rna_Pose_ikparam_get(struct PointerRNA *ptr)
305 {
306         bPose *pose = (bPose *)ptr->data;
307         return rna_pointer_inherit_refine(ptr, &RNA_IKParam, pose->ikparam);
308 }
309
310 static StructRNA *rna_Pose_ikparam_typef(PointerRNA *ptr)
311 {
312         bPose *pose = (bPose *)ptr->data;
313
314         switch (pose->iksolver) {
315                 case IKSOLVER_ITASC:
316                         return &RNA_Itasc;
317                 default:
318                         return &RNA_IKParam;
319         }
320 }
321
322 static void rna_Itasc_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
323 {
324         Object *ob = ptr->id.data;
325         bItasc *itasc = ptr->data;
326
327         /* verify values */
328         if (itasc->precision < 0.0001f)
329                 itasc->precision = 0.0001f;
330         if (itasc->minstep < 0.001f)
331                 itasc->minstep = 0.001f;
332         if (itasc->maxstep < itasc->minstep)
333                 itasc->maxstep = itasc->minstep;
334         if (itasc->feedback < 0.01f)
335                 itasc->feedback = 0.01f;
336         if (itasc->feedback > 100.f)
337                 itasc->feedback = 100.f;
338         if (itasc->maxvel < 0.01f)
339                 itasc->maxvel = 0.01f;
340         if (itasc->maxvel > 100.f)
341                 itasc->maxvel = 100.f;
342         BIK_update_param(ob->pose);
343
344         DEG_id_tag_update(&ob->id, ID_RECALC_GEOMETRY);
345 }
346
347 static void rna_Itasc_update_rebuild(Main *bmain, Scene *scene, PointerRNA *ptr)
348 {
349         Object *ob = ptr->id.data;
350         bPose *pose = ob->pose;
351
352         BKE_pose_tag_recalc(bmain, pose);  /* checks & sorts pose channels */
353         rna_Itasc_update(bmain, scene, ptr);
354 }
355
356 static void rna_PoseChannel_bone_custom_set(PointerRNA *ptr, PointerRNA value)
357 {
358         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
359
360
361         if (pchan->custom) {
362                 id_us_min(&pchan->custom->id);
363                 pchan->custom = NULL;
364         }
365
366         pchan->custom = value.data;
367
368         id_us_plus(&pchan->custom->id);
369 }
370
371 static PointerRNA rna_PoseChannel_bone_group_get(PointerRNA *ptr)
372 {
373         Object *ob = (Object *)ptr->id.data;
374         bPose *pose = (ob) ? ob->pose : NULL;
375         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
376         bActionGroup *grp;
377
378         if (pose)
379                 grp = BLI_findlink(&pose->agroups, pchan->agrp_index - 1);
380         else
381                 grp = NULL;
382
383         return rna_pointer_inherit_refine(ptr, &RNA_BoneGroup, grp);
384 }
385
386 static void rna_PoseChannel_bone_group_set(PointerRNA *ptr, PointerRNA value)
387 {
388         Object *ob = (Object *)ptr->id.data;
389         bPose *pose = (ob) ? ob->pose : NULL;
390         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
391
392         if (pose)
393                 pchan->agrp_index = BLI_findindex(&pose->agroups, value.data) + 1;
394         else
395                 pchan->agrp_index = 0;
396 }
397
398 static int rna_PoseChannel_bone_group_index_get(PointerRNA *ptr)
399 {
400         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
401         return MAX2(pchan->agrp_index - 1, 0);
402 }
403
404 static void rna_PoseChannel_bone_group_index_set(PointerRNA *ptr, int value)
405 {
406         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
407         pchan->agrp_index = value + 1;
408 }
409
410 static void rna_PoseChannel_bone_group_index_range(PointerRNA *ptr, int *min, int *max,
411                                                    int *UNUSED(softmin), int *UNUSED(softmax))
412 {
413         Object *ob = (Object *)ptr->id.data;
414         bPose *pose = (ob) ? ob->pose : NULL;
415
416         *min = 0;
417         *max = pose ? max_ii(0, BLI_listbase_count(&pose->agroups) - 1) : 0;
418 }
419
420 static PointerRNA rna_Pose_active_bone_group_get(PointerRNA *ptr)
421 {
422         bPose *pose = (bPose *)ptr->data;
423         return rna_pointer_inherit_refine(ptr, &RNA_BoneGroup, BLI_findlink(&pose->agroups, pose->active_group - 1));
424 }
425
426 static void rna_Pose_active_bone_group_set(PointerRNA *ptr, PointerRNA value)
427 {
428         bPose *pose = (bPose *)ptr->data;
429         pose->active_group = BLI_findindex(&pose->agroups, value.data) + 1;
430 }
431
432 static int rna_Pose_active_bone_group_index_get(PointerRNA *ptr)
433 {
434         bPose *pose = (bPose *)ptr->data;
435         return MAX2(pose->active_group - 1, 0);
436 }
437
438 static void rna_Pose_active_bone_group_index_set(PointerRNA *ptr, int value)
439 {
440         bPose *pose = (bPose *)ptr->data;
441         pose->active_group = value + 1;
442 }
443
444 static void rna_Pose_active_bone_group_index_range(PointerRNA *ptr, int *min, int *max,
445                                                    int *UNUSED(softmin), int *UNUSED(softmax))
446 {
447         bPose *pose = (bPose *)ptr->data;
448
449         *min = 0;
450         *max = max_ii(0, BLI_listbase_count(&pose->agroups) - 1);
451 }
452
453 #if 0
454 static void rna_pose_bgroup_name_index_get(PointerRNA *ptr, char *value, int index)
455 {
456         bPose *pose = (bPose *)ptr->data;
457         bActionGroup *grp;
458
459         grp = BLI_findlink(&pose->agroups, index - 1);
460
461         if (grp) BLI_strncpy(value, grp->name, sizeof(grp->name));
462         else value[0] = '\0';
463 }
464
465 static int rna_pose_bgroup_name_index_length(PointerRNA *ptr, int index)
466 {
467         bPose *pose = (bPose *)ptr->data;
468         bActionGroup *grp;
469
470         grp = BLI_findlink(&pose->agroups, index - 1);
471         return (grp) ? strlen(grp->name) : 0;
472 }
473
474 static void rna_pose_bgroup_name_index_set(PointerRNA *ptr, const char *value, short *index)
475 {
476         bPose *pose = (bPose *)ptr->data;
477         bActionGroup *grp;
478         int a;
479
480         for (a = 1, grp = pose->agroups.first; grp; grp = grp->next, a++) {
481                 if (STREQ(grp->name, value)) {
482                         *index = a;
483                         return;
484                 }
485         }
486
487         *index = 0;
488 }
489
490 static void rna_pose_pgroup_name_set(PointerRNA *ptr, const char *value, char *result, int maxlen)
491 {
492         bPose *pose = (bPose *)ptr->data;
493         bActionGroup *grp;
494
495         for (grp = pose->agroups.first; grp; grp = grp->next) {
496                 if (STREQ(grp->name, value)) {
497                         BLI_strncpy(result, value, maxlen);
498                         return;
499                 }
500         }
501
502         result[0] = '\0';
503 }
504 #endif
505
506 static PointerRNA rna_PoseChannel_active_constraint_get(PointerRNA *ptr)
507 {
508         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
509         bConstraint *con = BKE_constraints_active_get(&pchan->constraints);
510         return rna_pointer_inherit_refine(ptr, &RNA_Constraint, con);
511 }
512
513 static void rna_PoseChannel_active_constraint_set(PointerRNA *ptr, PointerRNA value)
514 {
515         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
516         BKE_constraints_active_set(&pchan->constraints, (bConstraint *)value.data);
517 }
518
519 static bConstraint *rna_PoseChannel_constraints_new(ID *id, bPoseChannel *pchan, Main *main, int type)
520 {
521         Object *ob = (Object *)id;
522         bConstraint *new_con = BKE_constraint_add_for_pose(ob, pchan, NULL, type);
523
524         ED_object_constraint_dependency_tag_update(main, ob, new_con);
525         WM_main_add_notifier(NC_OBJECT | ND_CONSTRAINT | NA_ADDED, id);
526
527         return new_con;
528 }
529
530 static void rna_PoseChannel_constraints_remove(
531         ID *id, bPoseChannel *pchan, Main *bmain, ReportList *reports, PointerRNA *con_ptr)
532 {
533         bConstraint *con = con_ptr->data;
534         const bool is_ik = ELEM(con->type, CONSTRAINT_TYPE_KINEMATIC, CONSTRAINT_TYPE_SPLINEIK);
535         Object *ob = (Object *)id;
536
537         if (BLI_findindex(&pchan->constraints, con) == -1) {
538                 BKE_reportf(reports, RPT_ERROR, "Constraint '%s' not found in pose bone '%s'", con->name, pchan->name);
539                 return;
540         }
541
542         BKE_constraint_remove(&pchan->constraints, con);
543         RNA_POINTER_INVALIDATE(con_ptr);
544
545         ED_object_constraint_update(bmain, ob);
546
547         BKE_constraints_active_set(&pchan->constraints, NULL);  /* XXX, is this really needed? - Campbell */
548
549         WM_main_add_notifier(NC_OBJECT | ND_CONSTRAINT | NA_REMOVED, id);
550
551         if (is_ik) {
552                 BIK_clear_data(ob->pose);
553         }
554 }
555
556 bool rna_PoseChannel_constraints_override_apply(
557         Main *UNUSED(bmain),
558         PointerRNA *ptr_dst, PointerRNA *ptr_src, PointerRNA *UNUSED(ptr_storage),
559         PropertyRNA *UNUSED(prop_dst), PropertyRNA *UNUSED(prop_src), PropertyRNA *UNUSED(prop_storage),
560         const int UNUSED(len_dst), const int UNUSED(len_src), const int UNUSED(len_storage),
561         PointerRNA *UNUSED(ptr_item_dst), PointerRNA *UNUSED(ptr_item_src), PointerRNA *UNUSED(ptr_item_storage),
562         IDOverrideStaticPropertyOperation *opop)
563 {
564         BLI_assert(opop->operation == IDOVERRIDESTATIC_OP_INSERT_AFTER &&
565                    "Unsupported RNA override operation on constraints collection");
566
567         bPoseChannel *pchan_dst = (bPoseChannel *)ptr_dst->data;
568         bPoseChannel *pchan_src = (bPoseChannel *)ptr_src->data;
569
570         /* Remember that insertion operations are defined and stored in correct order, which means that
571          * even if we insert several items in a row, we alays insert first one, then second one, etc.
572          * So we should always find 'anchor' constraint in both _src *and* _dst> */
573         bConstraint *con_anchor = NULL;
574         if (opop->subitem_local_name && opop->subitem_local_name[0]) {
575                 con_anchor = BLI_findstring(&pchan_dst->constraints, opop->subitem_local_name, offsetof(bConstraint, name));
576         }
577         if (con_anchor == NULL && opop->subitem_local_index >= 0) {
578                 con_anchor = BLI_findlink(&pchan_dst->constraints, opop->subitem_local_index);
579         }
580         /* Otherwise we just insert in first position. */
581
582         bConstraint *con_src = NULL;
583         if (opop->subitem_local_name && opop->subitem_local_name[0]) {
584                 con_src = BLI_findstring(&pchan_src->constraints, opop->subitem_local_name, offsetof(bConstraint, name));
585         }
586         if (con_src == NULL && opop->subitem_local_index >= 0) {
587                 con_src = BLI_findlink(&pchan_src->constraints, opop->subitem_local_index);
588         }
589         con_src = con_src ? con_src->next : pchan_src->constraints.first;
590
591         BLI_assert(con_src != NULL);
592
593         bConstraint *con_dst = BKE_constraint_duplicate_ex(con_src, 0, true);
594
595         /* This handles NULL anchor as expected by adding at head of list. */
596         BLI_insertlinkafter(&pchan_dst->constraints, con_anchor, con_dst);
597
598         /* This should actually *not* be needed in typical cases. However, if overridden source was edited,
599          * we *may* have some new conflicting names. */
600         BKE_constraint_unique_name(con_dst, &pchan_dst->constraints);
601
602 //      printf("%s: We inserted a constraint...\n", __func__);
603         return true;
604 }
605
606 static int rna_PoseChannel_proxy_editable(PointerRNA *ptr, const char **r_info)
607 {
608         Object *ob = (Object *)ptr->id.data;
609         bArmature *arm = ob->data;
610         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
611
612         if (ob->proxy && pchan->bone && (pchan->bone->layer & arm->layer_protected)) {
613                 *r_info = "Can't edit property of a proxy on a protected layer";
614                 return 0;
615         }
616
617         return PROP_EDITABLE;
618 }
619
620 static int rna_PoseChannel_location_editable(PointerRNA *ptr, int index)
621 {
622         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
623
624         /* only if the axis in question is locked, not editable... */
625         if ((index == 0) && (pchan->protectflag & OB_LOCK_LOCX))
626                 return 0;
627         else if ((index == 1) && (pchan->protectflag & OB_LOCK_LOCY))
628                 return 0;
629         else if ((index == 2) && (pchan->protectflag & OB_LOCK_LOCZ))
630                 return 0;
631         else
632                 return PROP_EDITABLE;
633 }
634
635 static int rna_PoseChannel_scale_editable(PointerRNA *ptr, int index)
636 {
637         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
638
639         /* only if the axis in question is locked, not editable... */
640         if ((index == 0) && (pchan->protectflag & OB_LOCK_SCALEX))
641                 return 0;
642         else if ((index == 1) && (pchan->protectflag & OB_LOCK_SCALEY))
643                 return 0;
644         else if ((index == 2) && (pchan->protectflag & OB_LOCK_SCALEZ))
645                 return 0;
646         else
647                 return PROP_EDITABLE;
648 }
649
650 static int rna_PoseChannel_rotation_euler_editable(PointerRNA *ptr, int index)
651 {
652         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
653
654         /* only if the axis in question is locked, not editable... */
655         if ((index == 0) && (pchan->protectflag & OB_LOCK_ROTX))
656                 return 0;
657         else if ((index == 1) && (pchan->protectflag & OB_LOCK_ROTY))
658                 return 0;
659         else if ((index == 2) && (pchan->protectflag & OB_LOCK_ROTZ))
660                 return 0;
661         else
662                 return PROP_EDITABLE;
663 }
664
665 static int rna_PoseChannel_rotation_4d_editable(PointerRNA *ptr, int index)
666 {
667         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
668
669         /* only consider locks if locking components individually... */
670         if (pchan->protectflag & OB_LOCK_ROT4D) {
671                 /* only if the axis in question is locked, not editable... */
672                 if ((index == 0) && (pchan->protectflag & OB_LOCK_ROTW))
673                         return 0;
674                 else if ((index == 1) && (pchan->protectflag & OB_LOCK_ROTX))
675                         return 0;
676                 else if ((index == 2) && (pchan->protectflag & OB_LOCK_ROTY))
677                         return 0;
678                 else if ((index == 3) && (pchan->protectflag & OB_LOCK_ROTZ))
679                         return 0;
680         }
681
682         return PROP_EDITABLE;
683 }
684
685 /* not essential, but much faster then the default lookup function */
686 static int rna_PoseBones_lookup_string(PointerRNA *ptr, const char *key, PointerRNA *r_ptr)
687 {
688         bPose *pose = (bPose *)ptr->data;
689         bPoseChannel *pchan = BKE_pose_channel_find_name(pose, key);
690         if (pchan) {
691                 RNA_pointer_create(ptr->id.data, &RNA_PoseBone, pchan, r_ptr);
692                 return true;
693         }
694         else {
695                 return false;
696         }
697 }
698
699 static void rna_PoseChannel_matrix_basis_get(PointerRNA *ptr, float *values)
700 {
701         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
702         BKE_pchan_to_mat4(pchan, (float (*)[4])values);
703 }
704
705 static void rna_PoseChannel_matrix_basis_set(PointerRNA *ptr, const float *values)
706 {
707         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
708         BKE_pchan_apply_mat4(pchan, (float (*)[4])values, false); /* no compat for predictable result */
709 }
710
711 static void rna_PoseChannel_matrix_set(PointerRNA *ptr, const float *values)
712 {
713         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
714         Object *ob = (Object *)ptr->id.data;
715         float tmat[4][4];
716
717         BKE_armature_mat_pose_to_bone_ex(NULL, ob, pchan, (float (*)[4])values, tmat);
718
719         BKE_pchan_apply_mat4(pchan, tmat, false); /* no compat for predictable result */
720 }
721
722 static bPoseChannel *rna_PoseChannel_ensure_own_pchan(Object *ob, Object *ref_ob, bPoseChannel *ref_pchan)
723 {
724         if (ref_ob != ob) {
725                 /* We are trying to set a pchan from another object! Forbidden, try to find by name, or abort. */
726                 if (ref_pchan != NULL) {
727                         ref_pchan = BKE_pose_channel_find_name(ob->pose, ref_pchan->name);
728                 }
729         }
730         return ref_pchan;
731 }
732
733 static void rna_PoseChannel_custom_shape_transform_set(PointerRNA *ptr, PointerRNA value)
734 {
735         bPoseChannel *pchan = (bPoseChannel *)ptr->data;
736         Object *ob = (Object *)ptr->id.data;
737
738         pchan->custom_tx = rna_PoseChannel_ensure_own_pchan(ob, value.id.data, value.data);
739 }
740
741 #else
742
743 /* common properties for Action/Bone Groups - related to color */
744 void rna_def_actionbone_group_common(StructRNA *srna, int update_flag, const char *update_cb)
745 {
746         PropertyRNA *prop;
747
748         /* color set + colors */
749         prop = RNA_def_property(srna, "color_set", PROP_ENUM, PROP_NONE);
750         RNA_def_property_enum_sdna(prop, NULL, "customCol");
751         RNA_def_property_enum_items(prop, rna_enum_color_sets_items);
752         RNA_def_property_enum_funcs(prop, NULL, "rna_ActionGroup_colorset_set", NULL);
753         RNA_def_property_ui_text(prop, "Color Set", "Custom color set to use");
754         RNA_def_property_update(prop, update_flag, update_cb);
755
756         prop = RNA_def_property(srna, "is_custom_color_set", PROP_BOOLEAN, PROP_NONE);
757         RNA_def_property_boolean_funcs(prop, "rna_ActionGroup_is_custom_colorset_get", NULL);
758         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
759         RNA_def_property_ui_text(prop, "Custom Color Set", "Color set is user-defined instead of a fixed theme color set");
760
761         /* TODO: editing the colors for this should result in changes to the color type... */
762         prop = RNA_def_property(srna, "colors", PROP_POINTER, PROP_NONE);
763         RNA_def_property_flag(prop, PROP_NEVER_NULL);
764         RNA_def_property_struct_type(prop, "ThemeBoneColorSet");
765         /* NOTE: the DNA data is not really a pointer, but this code works :) */
766         RNA_def_property_pointer_sdna(prop, NULL, "cs");
767         RNA_def_property_ui_text(prop, "Colors", "Copy of the colors associated with the group's color set");
768         RNA_def_property_update(prop, update_flag, update_cb);
769 }
770
771 static void rna_def_bone_group(BlenderRNA *brna)
772 {
773         StructRNA *srna;
774         PropertyRNA *prop;
775
776         /* struct */
777         srna = RNA_def_struct(brna, "BoneGroup", NULL);
778         RNA_def_struct_sdna(srna, "bActionGroup");
779         RNA_def_struct_ui_text(srna, "Bone Group", "Groups of Pose Channels (Bones)");
780         RNA_def_struct_ui_icon(srna, ICON_GROUP_BONE);
781
782         /* name */
783         prop = RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
784         RNA_def_property_ui_text(prop, "Name", "");
785         RNA_def_property_string_funcs(prop, NULL, NULL, "rna_BoneGroup_name_set");
786         RNA_def_struct_name_property(srna, prop);
787
788         /* TODO: add some runtime-collections stuff to access grouped bones  */
789
790         /* color set */
791         rna_def_actionbone_group_common(srna, NC_OBJECT | ND_POSE, "rna_Pose_update");
792 }
793
794 static const EnumPropertyItem prop_iksolver_items[] = {
795         {IKSOLVER_STANDARD, "LEGACY", 0, "Standard", "Original IK solver"},
796         {IKSOLVER_ITASC, "ITASC", 0, "iTaSC", "Multi constraint, stateful IK solver"},
797         {0, NULL, 0, NULL, NULL},
798 };
799
800 static const EnumPropertyItem prop_solver_items[] = {
801         {ITASC_SOLVER_SDLS, "SDLS", 0, "SDLS", "Selective Damped Least Square"},
802         {ITASC_SOLVER_DLS, "DLS", 0, "DLS", "Damped Least Square with Numerical Filtering"},
803         {0, NULL, 0, NULL, NULL},
804 };
805
806
807 static void rna_def_pose_channel_constraints(BlenderRNA *brna, PropertyRNA *cprop)
808 {
809         StructRNA *srna;
810         PropertyRNA *prop;
811
812         FunctionRNA *func;
813         PropertyRNA *parm;
814
815         RNA_def_property_srna(cprop, "PoseBoneConstraints");
816         srna = RNA_def_struct(brna, "PoseBoneConstraints", NULL);
817         RNA_def_struct_sdna(srna, "bPoseChannel");
818         RNA_def_struct_ui_text(srna, "PoseBone Constraints", "Collection of pose bone constraints");
819
820         /* Collection active property */
821         prop = RNA_def_property(srna, "active", PROP_POINTER, PROP_NONE);
822         RNA_def_property_struct_type(prop, "Constraint");
823         RNA_def_property_pointer_funcs(prop, "rna_PoseChannel_active_constraint_get",
824                                        "rna_PoseChannel_active_constraint_set", NULL, NULL);
825         RNA_def_property_flag(prop, PROP_EDITABLE);
826         RNA_def_property_ui_text(prop, "Active Constraint", "Active PoseChannel constraint");
827
828
829         /* Constraint collection */
830         func = RNA_def_function(srna, "new", "rna_PoseChannel_constraints_new");
831         RNA_def_function_ui_description(func, "Add a constraint to this object");
832         RNA_def_function_flag(func, FUNC_USE_MAIN | FUNC_USE_SELF_ID); /* ID and Main needed for refresh */
833         /* return type */
834         parm = RNA_def_pointer(func, "constraint", "Constraint", "", "New constraint");
835         RNA_def_function_return(func, parm);
836         /* constraint to add */
837         parm = RNA_def_enum(func, "type", rna_enum_constraint_type_items, 1, "", "Constraint type to add");
838         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
839
840         func = RNA_def_function(srna, "remove", "rna_PoseChannel_constraints_remove");
841         RNA_def_function_ui_description(func, "Remove a constraint from this object");
842         RNA_def_function_flag(func, FUNC_USE_SELF_ID | FUNC_USE_MAIN | FUNC_USE_REPORTS ); /* ID needed for refresh */
843         /* constraint to remove */
844         parm = RNA_def_pointer(func, "constraint", "Constraint", "", "Removed constraint");
845         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
846         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
847 }
848
849 static void rna_def_pose_channel(BlenderRNA *brna)
850 {
851         static float default_quat[4] = {1, 0, 0, 0};    /* default quaternion values */
852         static float default_axisAngle[4] = {0, 0, 1, 0};   /* default axis-angle rotation values */
853         static float default_scale[3] = {1, 1, 1}; /* default scale values */
854
855         StructRNA *srna;
856         PropertyRNA *prop;
857
858         srna = RNA_def_struct(brna, "PoseBone", NULL);
859         RNA_def_struct_sdna(srna, "bPoseChannel");
860         RNA_def_struct_ui_text(srna, "Pose Bone", "Channel defining pose data for a bone in a Pose");
861         RNA_def_struct_path_func(srna, "rna_PoseBone_path");
862         RNA_def_struct_idprops_func(srna, "rna_PoseBone_idprops");
863         RNA_def_struct_ui_icon(srna, ICON_BONE_DATA);
864
865         /* Bone Constraints */
866         prop = RNA_def_property(srna, "constraints", PROP_COLLECTION, PROP_NONE);
867         RNA_def_property_struct_type(prop, "Constraint");
868         RNA_def_property_override_flag(prop, PROPOVERRIDE_OVERRIDABLE_STATIC | PROPOVERRIDE_STATIC_INSERTION);
869         RNA_def_property_ui_text(prop, "Constraints", "Constraints that act on this PoseChannel");
870         RNA_def_property_override_funcs(prop, NULL, NULL, "rna_PoseChannel_constraints_override_apply");
871
872         rna_def_pose_channel_constraints(brna, prop);
873
874         /* Name + Selection Status */
875         prop = RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
876         RNA_def_property_string_funcs(prop, NULL, NULL, "rna_PoseChannel_name_set");
877         RNA_def_property_ui_text(prop, "Name", "");
878         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
879         RNA_def_struct_name_property(srna, prop);
880
881         /* Baked Bone Path cache data */
882         rna_def_motionpath_common(srna);
883
884         /* Relationships to other bones */
885         prop = RNA_def_property(srna, "bone", PROP_POINTER, PROP_NONE);
886         RNA_def_property_flag(prop, PROP_NEVER_NULL);
887         RNA_def_property_struct_type(prop, "Bone");
888         RNA_def_property_flag(prop, PROP_PTR_NO_OWNERSHIP);
889         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
890         RNA_def_property_ui_text(prop, "Bone", "Bone associated with this PoseBone");
891
892         prop = RNA_def_property(srna, "parent", PROP_POINTER, PROP_NONE);
893         RNA_def_property_struct_type(prop, "PoseBone");
894         RNA_def_property_flag(prop, PROP_PTR_NO_OWNERSHIP);
895         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
896         RNA_def_property_ui_text(prop, "Parent", "Parent of this pose bone");
897
898         prop = RNA_def_property(srna, "child", PROP_POINTER, PROP_NONE);
899         RNA_def_property_struct_type(prop, "PoseBone");
900         RNA_def_property_flag(prop, PROP_PTR_NO_OWNERSHIP);
901         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
902         RNA_def_property_ui_text(prop, "Child", "Child of this pose bone");
903
904         /* Transformation settings */
905         prop = RNA_def_property(srna, "location", PROP_FLOAT, PROP_TRANSLATION);
906         RNA_def_property_float_sdna(prop, NULL, "loc");
907         RNA_def_property_override_flag(prop, PROPOVERRIDE_OVERRIDABLE_STATIC);
908         RNA_def_property_editable_array_func(prop, "rna_PoseChannel_location_editable");
909         RNA_def_property_ui_text(prop, "Location", "");
910         RNA_def_property_ui_range(prop, -FLT_MAX, FLT_MAX, 1, RNA_TRANSLATION_PREC_DEFAULT);
911         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
912
913         prop = RNA_def_property(srna, "scale", PROP_FLOAT, PROP_XYZ);
914         RNA_def_property_float_sdna(prop, NULL, "size");
915         RNA_def_property_flag(prop, PROP_PROPORTIONAL);
916         RNA_def_property_override_flag(prop, PROPOVERRIDE_OVERRIDABLE_STATIC);
917         RNA_def_property_editable_array_func(prop, "rna_PoseChannel_scale_editable");
918         RNA_def_property_float_array_default(prop, default_scale);
919         RNA_def_property_ui_text(prop, "Scale", "");
920         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
921
922         prop = RNA_def_property(srna, "rotation_quaternion", PROP_FLOAT, PROP_QUATERNION);
923         RNA_def_property_float_sdna(prop, NULL, "quat");
924         RNA_def_property_override_flag(prop, PROPOVERRIDE_OVERRIDABLE_STATIC);
925         RNA_def_property_editable_array_func(prop, "rna_PoseChannel_rotation_4d_editable");
926         RNA_def_property_float_array_default(prop, default_quat);
927         RNA_def_property_ui_text(prop, "Quaternion Rotation", "Rotation in Quaternions");
928         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
929
930         /* XXX: for axis-angle, it would have been nice to have 2 separate fields for UI purposes, but
931          * having a single one is better for Keyframing and other property-management situations...
932          */
933         prop = RNA_def_property(srna, "rotation_axis_angle", PROP_FLOAT, PROP_AXISANGLE);
934         RNA_def_property_override_flag(prop, PROPOVERRIDE_OVERRIDABLE_STATIC);
935         RNA_def_property_array(prop, 4);
936         RNA_def_property_float_funcs(prop, "rna_PoseChannel_rotation_axis_angle_get",
937                                      "rna_PoseChannel_rotation_axis_angle_set", NULL);
938         RNA_def_property_editable_array_func(prop, "rna_PoseChannel_rotation_4d_editable");
939         RNA_def_property_float_array_default(prop, default_axisAngle);
940         RNA_def_property_ui_text(prop, "Axis-Angle Rotation", "Angle of Rotation for Axis-Angle rotation representation");
941         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
942
943         prop = RNA_def_property(srna, "rotation_euler", PROP_FLOAT, PROP_EULER);
944         RNA_def_property_float_sdna(prop, NULL, "eul");
945         RNA_def_property_override_flag(prop, PROPOVERRIDE_OVERRIDABLE_STATIC);
946         RNA_def_property_editable_array_func(prop, "rna_PoseChannel_rotation_euler_editable");
947         RNA_def_property_ui_text(prop, "Euler Rotation", "Rotation in Eulers");
948         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
949
950         prop = RNA_def_property(srna, "rotation_mode", PROP_ENUM, PROP_NONE);
951         RNA_def_property_enum_sdna(prop, NULL, "rotmode");
952         RNA_def_property_enum_items(prop, rna_enum_object_rotation_mode_items);
953         RNA_def_property_enum_funcs(prop, NULL, "rna_PoseChannel_rotation_mode_set", NULL);
954         /* XXX... disabled, since proxy-locked layers are currently used for ensuring proxy-syncing too */
955         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
956         RNA_def_property_ui_text(prop, "Rotation Mode", "");
957         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
958
959         /* Curved bones settings - Applied on top of restpose values */
960         rna_def_bone_curved_common(srna, true);
961
962         /* Custom BBone next/prev sources */
963         prop = RNA_def_property(srna, "bbone_custom_handle_start", PROP_POINTER, PROP_NONE);
964         RNA_def_property_pointer_sdna(prop, NULL, "bbone_prev");
965         RNA_def_property_struct_type(prop, "PoseBone");
966         RNA_def_property_flag(prop, PROP_PTR_NO_OWNERSHIP);
967         RNA_def_property_override_flag(prop, PROPOVERRIDE_NO_COMPARISON);
968         RNA_def_property_ui_text(prop, "B-Bone Start Handle",
969                                  "Bone that serves as the start handle for the B-Bone curve");
970         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_dependency_update");
971
972         prop = RNA_def_property(srna, "bbone_custom_handle_end", PROP_POINTER, PROP_NONE);
973         RNA_def_property_pointer_sdna(prop, NULL, "bbone_next");
974         RNA_def_property_struct_type(prop, "PoseBone");
975         RNA_def_property_flag(prop, PROP_PTR_NO_OWNERSHIP);
976         RNA_def_property_override_flag(prop, PROPOVERRIDE_NO_COMPARISON);
977         RNA_def_property_ui_text(prop, "B-Bone End Handle",
978                                  "Bone that serves as the end handle for the B-Bone curve");
979         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_dependency_update");
980
981         /* transform matrices - should be read-only since these are set directly by AnimSys evaluation */
982         prop = RNA_def_property(srna, "matrix_channel", PROP_FLOAT, PROP_MATRIX);
983         RNA_def_property_float_sdna(prop, NULL, "chan_mat");
984         RNA_def_property_multi_array(prop, 2, rna_matrix_dimsize_4x4);
985         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
986         RNA_def_property_ui_text(prop, "Channel Matrix", "4x4 matrix, before constraints");
987
988         /* writable because it touches loc/scale/rot directly */
989         prop = RNA_def_property(srna, "matrix_basis", PROP_FLOAT, PROP_MATRIX);
990         RNA_def_property_multi_array(prop, 2, rna_matrix_dimsize_4x4);
991         RNA_def_property_ui_text(prop, "Basis Matrix",
992                                  "Alternative access to location/scale/rotation relative to the parent and own rest bone");
993         RNA_def_property_float_funcs(prop, "rna_PoseChannel_matrix_basis_get", "rna_PoseChannel_matrix_basis_set", NULL);
994         RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
995         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
996
997         /* final matrix */
998         prop = RNA_def_property(srna, "matrix", PROP_FLOAT, PROP_MATRIX);
999         RNA_def_property_float_sdna(prop, NULL, "pose_mat");
1000         RNA_def_property_multi_array(prop, 2, rna_matrix_dimsize_4x4);
1001         RNA_def_property_float_funcs(prop, NULL, "rna_PoseChannel_matrix_set", NULL);
1002         RNA_def_property_ui_text(prop, "Pose Matrix",
1003                                  "Final 4x4 matrix after constraints and drivers are applied (object space)");
1004         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1005
1006         /* Head/Tail Coordinates (in Pose Space) - Automatically calculated... */
1007         prop = RNA_def_property(srna, "head", PROP_FLOAT, PROP_TRANSLATION);
1008         RNA_def_property_float_sdna(prop, NULL, "pose_head");
1009         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1010         RNA_def_property_ui_text(prop, "Pose Head Position", "Location of head of the channel's bone");
1011         RNA_def_property_ui_range(prop, -FLT_MAX, FLT_MAX, 1, RNA_TRANSLATION_PREC_DEFAULT);
1012
1013         prop = RNA_def_property(srna, "tail", PROP_FLOAT, PROP_TRANSLATION);
1014         RNA_def_property_float_sdna(prop, NULL, "pose_tail");
1015         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1016         RNA_def_property_ui_text(prop, "Pose Tail Position", "Location of tail of the channel's bone");
1017         RNA_def_property_ui_range(prop, -FLT_MAX, FLT_MAX, 1, RNA_TRANSLATION_PREC_DEFAULT);
1018
1019         /* IK Settings */
1020         prop = RNA_def_property(srna, "is_in_ik_chain", PROP_BOOLEAN, PROP_NONE);
1021         RNA_def_property_boolean_funcs(prop,  "rna_PoseChannel_has_ik_get", NULL);
1022         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1023         RNA_def_property_ui_text(prop, "Has IK", "Is part of an IK chain");
1024         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1025
1026         prop = RNA_def_property(srna, "lock_ik_x", PROP_BOOLEAN, PROP_NONE);
1027         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_NO_XDOF);
1028         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, true);
1029         RNA_def_property_ui_text(prop, "IK X Lock", "Disallow movement around the X axis");
1030         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1031         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1032
1033         prop = RNA_def_property(srna, "lock_ik_y", PROP_BOOLEAN, PROP_NONE);
1034         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_NO_YDOF);
1035         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, true);
1036         RNA_def_property_ui_text(prop, "IK Y Lock", "Disallow movement around the Y axis");
1037         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1038         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1039
1040         prop = RNA_def_property(srna, "lock_ik_z", PROP_BOOLEAN, PROP_NONE);
1041         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_NO_ZDOF);
1042         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, true);
1043         RNA_def_property_ui_text(prop, "IK Z Lock", "Disallow movement around the Z axis");
1044         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1045         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1046
1047         prop = RNA_def_property(srna, "use_ik_limit_x", PROP_BOOLEAN, PROP_NONE);
1048         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_XLIMIT);
1049         RNA_def_property_ui_text(prop, "IK X Limit", "Limit movement around the X axis");
1050         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1051         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1052
1053         prop = RNA_def_property(srna, "use_ik_limit_y", PROP_BOOLEAN, PROP_NONE);
1054         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_YLIMIT);
1055         RNA_def_property_ui_text(prop, "IK Y Limit", "Limit movement around the Y axis");
1056         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1057         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1058
1059         prop = RNA_def_property(srna, "use_ik_limit_z", PROP_BOOLEAN, PROP_NONE);
1060         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_ZLIMIT);
1061         RNA_def_property_ui_text(prop, "IK Z Limit", "Limit movement around the Z axis");
1062         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1063         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1064
1065         prop = RNA_def_property(srna, "use_ik_rotation_control", PROP_BOOLEAN, PROP_NONE);
1066         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_ROTCTL);
1067         RNA_def_property_ui_text(prop, "IK rot control", "Apply channel rotation as IK constraint");
1068         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1069         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1070
1071         prop = RNA_def_property(srna, "use_ik_linear_control", PROP_BOOLEAN, PROP_NONE);
1072         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_LINCTL);
1073         RNA_def_property_ui_text(prop, "IK rot control", "Apply channel size as IK constraint if stretching is enabled");
1074         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1075         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1076
1077         prop = RNA_def_property(srna, "ik_min_x", PROP_FLOAT, PROP_ANGLE);
1078         RNA_def_property_float_sdna(prop, NULL, "limitmin[0]");
1079         RNA_def_property_range(prop, -M_PI, 0.0f);
1080         RNA_def_property_ui_text(prop, "IK X Minimum", "Minimum angles for IK Limit");
1081         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1082         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1083
1084         prop = RNA_def_property(srna, "ik_max_x", PROP_FLOAT, PROP_ANGLE);
1085         RNA_def_property_float_sdna(prop, NULL, "limitmax[0]");
1086         RNA_def_property_range(prop, 0.0f, M_PI);
1087         RNA_def_property_ui_text(prop, "IK X Maximum", "Maximum angles for IK Limit");
1088         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1089         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1090
1091         prop = RNA_def_property(srna, "ik_min_y", PROP_FLOAT, PROP_ANGLE);
1092         RNA_def_property_float_sdna(prop, NULL, "limitmin[1]");
1093         RNA_def_property_range(prop, -M_PI, 0.0f);
1094         RNA_def_property_ui_text(prop, "IK Y Minimum", "Minimum angles for IK Limit");
1095         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1096         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1097
1098         prop = RNA_def_property(srna, "ik_max_y", PROP_FLOAT, PROP_ANGLE);
1099         RNA_def_property_float_sdna(prop, NULL, "limitmax[1]");
1100         RNA_def_property_range(prop, 0.0f, M_PI);
1101         RNA_def_property_ui_text(prop, "IK Y Maximum", "Maximum angles for IK Limit");
1102         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1103         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1104
1105         prop = RNA_def_property(srna, "ik_min_z", PROP_FLOAT, PROP_ANGLE);
1106         RNA_def_property_float_sdna(prop, NULL, "limitmin[2]");
1107         RNA_def_property_range(prop, -M_PI, 0.0f);
1108         RNA_def_property_ui_text(prop, "IK Z Minimum", "Minimum angles for IK Limit");
1109         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1110         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1111
1112         prop = RNA_def_property(srna, "ik_max_z", PROP_FLOAT, PROP_ANGLE);
1113         RNA_def_property_float_sdna(prop, NULL, "limitmax[2]");
1114         RNA_def_property_range(prop, 0.0f, M_PI);
1115         RNA_def_property_ui_text(prop, "IK Z Maximum", "Maximum angles for IK Limit");
1116         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1117         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1118
1119         prop = RNA_def_property(srna, "ik_stiffness_x", PROP_FLOAT, PROP_NONE);
1120         RNA_def_property_float_sdna(prop, NULL, "stiffness[0]");
1121         RNA_def_property_range(prop, 0.0f, 0.99f);
1122         RNA_def_property_ui_text(prop, "IK X Stiffness", "IK stiffness around the X axis");
1123         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1124         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1125
1126         prop = RNA_def_property(srna, "ik_stiffness_y", PROP_FLOAT, PROP_NONE);
1127         RNA_def_property_float_sdna(prop, NULL, "stiffness[1]");
1128         RNA_def_property_range(prop, 0.0f, 0.99f);
1129         RNA_def_property_ui_text(prop, "IK Y Stiffness", "IK stiffness around the Y axis");
1130         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1131         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1132
1133         prop = RNA_def_property(srna, "ik_stiffness_z", PROP_FLOAT, PROP_NONE);
1134         RNA_def_property_float_sdna(prop, NULL, "stiffness[2]");
1135         RNA_def_property_range(prop, 0.0f, 0.99f);
1136         RNA_def_property_ui_text(prop, "IK Z Stiffness", "IK stiffness around the Z axis");
1137         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1138         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1139
1140         prop = RNA_def_property(srna, "ik_stretch", PROP_FLOAT, PROP_NONE);
1141         RNA_def_property_float_sdna(prop, NULL, "ikstretch");
1142         RNA_def_property_range(prop, 0.0f, 1.0f);
1143         RNA_def_property_ui_text(prop, "IK Stretch", "Allow scaling of the bone for IK");
1144         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1145         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_IK_update");
1146
1147         prop = RNA_def_property(srna, "ik_rotation_weight", PROP_FLOAT, PROP_NONE);
1148         RNA_def_property_float_sdna(prop, NULL, "ikrotweight");
1149         RNA_def_property_range(prop, 0.0f, 1.0f);
1150         RNA_def_property_ui_text(prop, "IK Rot Weight", "Weight of rotation constraint for IK");
1151         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1152         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1153
1154         prop = RNA_def_property(srna, "ik_linear_weight", PROP_FLOAT, PROP_NONE);
1155         RNA_def_property_float_sdna(prop, NULL, "iklinweight");
1156         RNA_def_property_range(prop, 0.0f, 1.0f);
1157         RNA_def_property_ui_text(prop, "IK Lin Weight", "Weight of scale constraint for IK");
1158         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1159         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1160
1161         /* custom bone shapes */
1162         prop = RNA_def_property(srna, "custom_shape", PROP_POINTER, PROP_NONE);
1163         RNA_def_property_pointer_sdna(prop, NULL, "custom");
1164         RNA_def_property_struct_type(prop, "Object");
1165         RNA_def_property_flag(prop, PROP_EDITABLE);
1166         RNA_def_property_pointer_funcs(prop, NULL, "rna_PoseChannel_bone_custom_set", NULL, NULL);
1167         RNA_def_property_ui_text(prop, "Custom Object", "Object that defines custom draw type for this bone");
1168         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1169         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1170
1171         prop = RNA_def_property(srna, "custom_shape_scale", PROP_FLOAT, PROP_NONE);
1172         RNA_def_property_float_sdna(prop, NULL, "custom_scale");
1173         RNA_def_property_range(prop, 0.0f, 1000.0f);
1174         RNA_def_property_ui_text(prop, "Custom Shape Scale", "Adjust the size of the custom shape");
1175         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1176
1177         prop = RNA_def_property(srna, "use_custom_shape_bone_size", PROP_BOOLEAN, PROP_NONE);
1178         RNA_def_property_boolean_negative_sdna(prop, NULL, "drawflag", PCHAN_DRAW_NO_CUSTOM_BONE_SIZE);
1179         RNA_def_property_ui_text(prop, "Use Bone Size", "Scale the custom object by the bone length");
1180         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1181
1182         prop = RNA_def_property(srna, "custom_shape_transform", PROP_POINTER, PROP_NONE);
1183         RNA_def_property_pointer_sdna(prop, NULL, "custom_tx");
1184         RNA_def_property_struct_type(prop, "PoseBone");
1185         RNA_def_property_flag(prop, PROP_EDITABLE | PROP_PTR_NO_OWNERSHIP);
1186         RNA_def_property_override_flag(prop, PROPOVERRIDE_OVERRIDABLE_STATIC);
1187         RNA_def_property_ui_text(prop, "Custom Shape Transform",
1188                                  "Bone that defines the display transform of this custom shape");
1189         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1190         RNA_def_property_pointer_funcs(prop, NULL, "rna_PoseChannel_custom_shape_transform_set", NULL, NULL);
1191         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1192
1193         /* bone groups */
1194         prop = RNA_def_property(srna, "bone_group_index", PROP_INT, PROP_NONE);
1195         RNA_def_property_int_sdna(prop, NULL, "agrp_index");
1196         RNA_def_property_flag(prop, PROP_EDITABLE);
1197         RNA_def_property_clear_flag(prop, PROP_ANIMATABLE);
1198         RNA_def_property_int_funcs(prop, "rna_PoseChannel_bone_group_index_get", "rna_PoseChannel_bone_group_index_set",
1199                                    "rna_PoseChannel_bone_group_index_range");
1200         RNA_def_property_ui_text(prop, "Bone Group Index", "Bone Group this pose channel belongs to (0=no group)");
1201         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1202         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1203
1204         prop = RNA_def_property(srna, "bone_group", PROP_POINTER, PROP_NONE);
1205         RNA_def_property_struct_type(prop, "BoneGroup");
1206         RNA_def_property_flag(prop, PROP_EDITABLE);
1207         RNA_def_property_pointer_funcs(prop, "rna_PoseChannel_bone_group_get",
1208                                        "rna_PoseChannel_bone_group_set", NULL, NULL);
1209         RNA_def_property_ui_text(prop, "Bone Group", "Bone Group this pose channel belongs to");
1210         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1211         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1212
1213         /* transform locks */
1214         prop = RNA_def_property(srna, "lock_location", PROP_BOOLEAN, PROP_NONE);
1215         RNA_def_property_boolean_sdna(prop, NULL, "protectflag", OB_LOCK_LOCX);
1216         RNA_def_property_array(prop, 3);
1217         RNA_def_property_ui_text(prop, "Lock Location", "Lock editing of location in the interface");
1218         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, 1);
1219         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1220         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1221
1222         prop = RNA_def_property(srna, "lock_rotation", PROP_BOOLEAN, PROP_NONE);
1223         RNA_def_property_boolean_sdna(prop, NULL, "protectflag", OB_LOCK_ROTX);
1224         RNA_def_property_array(prop, 3);
1225         RNA_def_property_ui_text(prop, "Lock Rotation", "Lock editing of rotation in the interface");
1226         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, 1);
1227         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1228         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1229
1230         /* XXX this is sub-optimal - it really should be included above, but due to technical reasons
1231          *     we can't do this! */
1232         prop = RNA_def_property(srna, "lock_rotation_w", PROP_BOOLEAN, PROP_NONE);
1233         RNA_def_property_boolean_sdna(prop, NULL, "protectflag", OB_LOCK_ROTW);
1234         RNA_def_property_ui_text(prop, "Lock Rotation (4D Angle)",
1235                                  "Lock editing of 'angle' component of four-component rotations in the interface");
1236         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, 1);
1237         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1238         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1239
1240         /* XXX this needs a better name */
1241         prop = RNA_def_property(srna, "lock_rotations_4d", PROP_BOOLEAN, PROP_NONE);
1242         RNA_def_property_boolean_sdna(prop, NULL, "protectflag", OB_LOCK_ROT4D);
1243         RNA_def_property_ui_text(prop, "Lock Rotations (4D)",
1244                                  "Lock editing of four component rotations by components (instead of as Eulers)");
1245         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1246         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1247
1248         prop = RNA_def_property(srna, "lock_scale", PROP_BOOLEAN, PROP_NONE);
1249         RNA_def_property_boolean_sdna(prop, NULL, "protectflag", OB_LOCK_SCALEX);
1250         RNA_def_property_array(prop, 3);
1251         RNA_def_property_ui_text(prop, "Lock Scale", "Lock editing of scale in the interface");
1252         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, 1);
1253         RNA_def_property_editable_func(prop, "rna_PoseChannel_proxy_editable");
1254         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1255
1256         RNA_api_pose_channel(srna);
1257 }
1258
1259 static void rna_def_pose_itasc(BlenderRNA *brna)
1260 {
1261         static const EnumPropertyItem prop_itasc_mode_items[] = {
1262                 {0, "ANIMATION", 0, "Animation",
1263                     "Stateless solver computing pose starting from current action and non-IK constraints"},
1264                 {ITASC_SIMULATION, "SIMULATION", 0, "Simulation",
1265                                    "State-full solver running in real-time context and ignoring actions "
1266                                    "and non-IK constraints"},
1267                 {0, NULL, 0, NULL, NULL},
1268         };
1269         static const EnumPropertyItem prop_itasc_reiteration_items[] = {
1270                 {0, "NEVER", 0, "Never", "The solver does not reiterate, not even on first frame (starts from rest pose)"},
1271                 {ITASC_INITIAL_REITERATION, "INITIAL", 0, "Initial",
1272                                             "The solver reiterates (converges) on the first frame but not on "
1273                                             "subsequent frame"},
1274                 {ITASC_INITIAL_REITERATION | ITASC_REITERATION, "ALWAYS", 0, "Always",
1275                                                                 "The solver reiterates (converges) on all frames"},
1276                 {0, NULL, 0, NULL, NULL},
1277         };
1278
1279         StructRNA *srna;
1280         PropertyRNA *prop;
1281
1282         srna = RNA_def_struct(brna, "Itasc", "IKParam");
1283         RNA_def_struct_sdna(srna, "bItasc");
1284         RNA_def_struct_ui_text(srna, "bItasc", "Parameters for the iTaSC IK solver");
1285
1286         prop = RNA_def_property(srna, "precision", PROP_FLOAT, PROP_NONE);
1287         RNA_def_property_float_sdna(prop, NULL, "precision");
1288         RNA_def_property_range(prop, 0.0f, 0.1f);
1289         RNA_def_property_ui_text(prop, "Precision", "Precision of convergence in case of reiteration");
1290         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1291
1292         prop = RNA_def_property(srna, "iterations", PROP_INT, PROP_NONE);
1293         RNA_def_property_int_sdna(prop, NULL, "numiter");
1294         RNA_def_property_range(prop, 0, 1000);
1295         RNA_def_property_ui_text(prop, "Iterations",
1296                                  "Maximum number of iterations for convergence in case of reiteration");
1297         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1298
1299         prop = RNA_def_property(srna, "step_count", PROP_INT, PROP_NONE);
1300         RNA_def_property_int_sdna(prop, NULL, "numstep");
1301         RNA_def_property_range(prop, 1.f, 50.f);
1302         RNA_def_property_ui_text(prop, "Num steps", "Divide the frame interval into this many steps");
1303         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1304
1305         prop = RNA_def_property(srna, "mode", PROP_ENUM, PROP_NONE);
1306         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
1307         RNA_def_property_enum_items(prop, prop_itasc_mode_items);
1308         RNA_def_property_ui_text(prop, "Mode", NULL);
1309         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update_rebuild");
1310
1311         prop = RNA_def_property(srna, "reiteration_method", PROP_ENUM, PROP_NONE);
1312         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
1313         RNA_def_property_enum_items(prop, prop_itasc_reiteration_items);
1314         RNA_def_property_ui_text(prop, "Reiteration",
1315                                  "Defines if the solver is allowed to reiterate (converge until "
1316                                  "precision is met) on none, first or all frames");
1317         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1318
1319         prop = RNA_def_property(srna, "use_auto_step", PROP_BOOLEAN, PROP_NONE);
1320         RNA_def_property_boolean_sdna(prop, NULL, "flag", ITASC_AUTO_STEP);
1321         RNA_def_property_ui_text(prop, "Auto step",
1322                                  "Automatically determine the optimal number of steps for best "
1323                                  "performance/accuracy trade off");
1324         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1325
1326         prop = RNA_def_property(srna, "step_min", PROP_FLOAT, PROP_NONE);
1327         RNA_def_property_float_sdna(prop, NULL, "minstep");
1328         RNA_def_property_range(prop, 0.0f, 0.1f);
1329         RNA_def_property_ui_text(prop, "Min step", "Lower bound for timestep in second in case of automatic substeps");
1330         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1331
1332         prop = RNA_def_property(srna, "step_max", PROP_FLOAT, PROP_NONE);
1333         RNA_def_property_float_sdna(prop, NULL, "maxstep");
1334         RNA_def_property_range(prop, 0.0f, 1.0f);
1335         RNA_def_property_ui_text(prop, "Max step", "Higher bound for timestep in second in case of automatic substeps");
1336         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1337
1338         prop = RNA_def_property(srna, "feedback", PROP_FLOAT, PROP_NONE);
1339         RNA_def_property_float_sdna(prop, NULL, "feedback");
1340         RNA_def_property_range(prop, 0.0f, 100.0f);
1341         RNA_def_property_ui_text(prop, "Feedback",
1342                                  "Feedback coefficient for error correction, average response time is 1/feedback "
1343                                  "(default=20)");
1344         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1345
1346         prop = RNA_def_property(srna, "velocity_max", PROP_FLOAT, PROP_NONE);
1347         RNA_def_property_float_sdna(prop, NULL, "maxvel");
1348         RNA_def_property_range(prop, 0.0f, 100.0f);
1349         RNA_def_property_ui_text(prop, "Max Velocity", "Maximum joint velocity in rad/s (default=50)");
1350         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1351
1352         prop = RNA_def_property(srna, "solver", PROP_ENUM, PROP_NONE);
1353         RNA_def_property_enum_sdna(prop, NULL, "solver");
1354         RNA_def_property_enum_items(prop, prop_solver_items);
1355         RNA_def_property_ui_text(prop, "Solver", "Solving method selection: automatic damping or manual damping");
1356         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update_rebuild");
1357
1358         prop = RNA_def_property(srna, "damping_max", PROP_FLOAT, PROP_NONE);
1359         RNA_def_property_float_sdna(prop, NULL, "dampmax");
1360         RNA_def_property_range(prop, 0.0f, 1.0f);
1361         RNA_def_property_ui_text(prop, "Damp",
1362                                  "Maximum damping coefficient when singular value is nearly 0 "
1363                                  "(higher values=more stability, less reactivity - default=0.5)");
1364         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1365
1366         prop = RNA_def_property(srna, "damping_epsilon", PROP_FLOAT, PROP_NONE);
1367         RNA_def_property_float_sdna(prop, NULL, "dampeps");
1368         RNA_def_property_range(prop, 0.0f, 1.0f);
1369         RNA_def_property_ui_text(prop, "Epsilon",
1370                                  "Singular value under which damping is progressively applied "
1371                                  "(higher values=more stability, less reactivity - default=0.1)");
1372         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Itasc_update");
1373 }
1374
1375 static void rna_def_pose_ikparam(BlenderRNA *brna)
1376 {
1377         StructRNA *srna;
1378         PropertyRNA *prop;
1379
1380         srna = RNA_def_struct(brna, "IKParam", NULL);
1381         RNA_def_struct_sdna(srna, "bIKParam");
1382         RNA_def_struct_ui_text(srna, "IKParam", "Base type for IK solver parameters");
1383         RNA_def_struct_refine_func(srna, "rna_IKParam_refine");
1384
1385         prop = RNA_def_property(srna, "ik_solver", PROP_ENUM, PROP_NONE);
1386         RNA_def_property_enum_sdna(prop, NULL, "iksolver");
1387         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1388         RNA_def_property_enum_items(prop, prop_iksolver_items);
1389         RNA_def_property_ui_text(prop, "IK Solver", "IK solver for which these parameters are defined");
1390 }
1391
1392 /* pose.bone_groups */
1393 static void rna_def_bone_groups(BlenderRNA *brna, PropertyRNA *cprop)
1394 {
1395         StructRNA *srna;
1396         PropertyRNA *prop;
1397
1398         FunctionRNA *func;
1399         PropertyRNA *parm;
1400
1401         RNA_def_property_srna(cprop, "BoneGroups");
1402         srna = RNA_def_struct(brna, "BoneGroups", NULL);
1403         RNA_def_struct_sdna(srna, "bPose");
1404         RNA_def_struct_ui_text(srna, "Bone Groups", "Collection of bone groups");
1405
1406         func = RNA_def_function(srna, "new", "rna_bone_group_new");
1407         RNA_def_function_ui_description(func, "Add a new bone group to the object");
1408         RNA_def_function_flag(func, FUNC_USE_SELF_ID); /* ID needed for refresh */
1409         RNA_def_string(func, "name", "Group", MAX_NAME, "", "Name of the new group");
1410         /* return type */
1411         parm = RNA_def_pointer(func, "group", "BoneGroup", "", "New bone group");
1412         RNA_def_function_return(func, parm);
1413
1414         func = RNA_def_function(srna, "remove", "rna_bone_group_remove");
1415         RNA_def_function_ui_description(func, "Remove a bone group from this object");
1416         RNA_def_function_flag(func, FUNC_USE_REPORTS | FUNC_USE_SELF_ID); /* ID needed for refresh */
1417         /* bone group to remove */
1418         parm = RNA_def_pointer(func, "group", "BoneGroup", "", "Removed bone group");
1419         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1420         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1421
1422         prop = RNA_def_property(srna, "active", PROP_POINTER, PROP_NONE);
1423         RNA_def_property_struct_type(prop, "BoneGroup");
1424         RNA_def_property_flag(prop, PROP_EDITABLE);
1425         RNA_def_property_pointer_funcs(prop, "rna_Pose_active_bone_group_get",
1426                                        "rna_Pose_active_bone_group_set", NULL, NULL);
1427         RNA_def_property_ui_text(prop, "Active Bone Group", "Active bone group for this pose");
1428         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1429
1430         prop = RNA_def_property(srna, "active_index", PROP_INT, PROP_UNSIGNED);
1431         RNA_def_property_int_sdna(prop, NULL, "active_group");
1432         RNA_def_property_int_funcs(prop, "rna_Pose_active_bone_group_index_get", "rna_Pose_active_bone_group_index_set",
1433                                    "rna_Pose_active_bone_group_index_range");
1434         RNA_def_property_ui_text(prop, "Active Bone Group Index", "Active index in bone groups array");
1435         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_update");
1436 }
1437
1438 static void rna_def_pose(BlenderRNA *brna)
1439 {
1440         StructRNA *srna;
1441         PropertyRNA *prop;
1442
1443         /* struct definition */
1444         srna = RNA_def_struct(brna, "Pose", NULL);
1445         RNA_def_struct_sdna(srna, "bPose");
1446         RNA_def_struct_ui_text(srna, "Pose", "A collection of pose channels, including settings for animating bones");
1447
1448         /* pose channels */
1449         prop = RNA_def_property(srna, "bones", PROP_COLLECTION, PROP_NONE);
1450         RNA_def_property_collection_sdna(prop, NULL, "chanbase", NULL);
1451         RNA_def_property_struct_type(prop, "PoseBone");
1452         RNA_def_property_override_flag(prop, PROPOVERRIDE_OVERRIDABLE_STATIC);
1453         RNA_def_property_ui_text(prop, "Pose Bones", "Individual pose bones for the armature");
1454         /* can be removed, only for fast lookup */
1455         RNA_def_property_collection_funcs(prop, NULL, NULL, NULL, NULL, NULL, NULL, "rna_PoseBones_lookup_string", NULL);
1456
1457         /* bone groups */
1458         prop = RNA_def_property(srna, "bone_groups", PROP_COLLECTION, PROP_NONE);
1459         RNA_def_property_collection_sdna(prop, NULL, "agroups", NULL);
1460         RNA_def_property_struct_type(prop, "BoneGroup");
1461         RNA_def_property_ui_text(prop, "Bone Groups", "Groups of the bones");
1462         rna_def_bone_groups(brna, prop);
1463
1464         /* ik solvers */
1465         prop = RNA_def_property(srna, "ik_solver", PROP_ENUM, PROP_NONE);
1466         RNA_def_property_enum_sdna(prop, NULL, "iksolver");
1467         RNA_def_property_enum_funcs(prop, NULL, "rna_Pose_ik_solver_set", NULL);
1468         RNA_def_property_enum_items(prop, prop_iksolver_items);
1469         RNA_def_property_ui_text(prop, "IK Solver", "Selection of IK solver for IK chain");
1470         RNA_def_property_update(prop, NC_OBJECT | ND_POSE, "rna_Pose_ik_solver_update");
1471
1472         prop = RNA_def_property(srna, "ik_param", PROP_POINTER, PROP_NONE);
1473         RNA_def_property_struct_type(prop, "IKParam");
1474         RNA_def_property_pointer_funcs(prop, "rna_Pose_ikparam_get", NULL, "rna_Pose_ikparam_typef", NULL);
1475         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1476         RNA_def_property_ui_text(prop, "IK Param", "Parameters for IK solver");
1477
1478         /* animviz */
1479         rna_def_animviz_common(srna);
1480
1481         RNA_api_pose(srna);
1482 }
1483
1484 void RNA_def_pose(BlenderRNA *brna)
1485 {
1486         rna_def_pose(brna);
1487         rna_def_pose_channel(brna);
1488         rna_def_pose_ikparam(brna);
1489         rna_def_pose_itasc(brna);
1490         rna_def_bone_group(brna);
1491 }
1492
1493 #endif