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