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