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