Pose Channels - changing settings in RNA updates them correctly again
[blender.git] / source / blender / makesrna / intern / rna_pose.c
1 /**
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19  *
20  * Contributor(s): Blender Foundation (2008), Roland Hess
21  *
22  * ***** END GPL LICENSE BLOCK *****
23  */
24
25 #include <stdlib.h>
26
27 #include "RNA_define.h"
28 #include "RNA_types.h"
29
30 #include "rna_internal.h"
31
32 #include "DNA_action_types.h"
33 #include "DNA_armature_types.h"
34 #include "DNA_constraint_types.h"
35 #include "DNA_object_types.h"
36 #include "DNA_scene_types.h"
37
38 #include "WM_types.h"
39
40 #ifdef RNA_RUNTIME
41
42 #include "BKE_context.h"
43 #include "BKE_depsgraph.h"
44
45 static void rna_Pose_update(bContext *C, PointerRNA *ptr)
46 {
47         DAG_object_flush_update(CTX_data_scene(C), ptr->id.data, OB_RECALC_DATA);
48 }
49
50 #else
51
52 /* users shouldn't be editing pose channel data directly -- better to set ipos and let blender calc pose_channel stuff */
53 /* it's going to be weird for users to find IK flags and other such here, instead of in bone where they would expect them
54         -- is there any way to put a doc in bone, pointing them here? */
55
56 static void rna_def_pose_channel(BlenderRNA *brna)
57 {
58         static EnumPropertyItem prop_rotmode_items[] = {
59                 {PCHAN_ROT_QUAT, "QUATERNION", "Quaternion (WXYZ)", "No Gimbal Lock (default)"},
60                 {PCHAN_ROT_EUL, "EULER", "Euler (XYZ)", "Prone to Gimbal Lock"},
61                 {0, NULL, NULL, NULL}};
62         
63         StructRNA *srna;
64         PropertyRNA *prop;
65
66         srna= RNA_def_struct(brna, "PoseChannel", NULL);
67         RNA_def_struct_sdna(srna, "bPoseChannel");
68         RNA_def_struct_ui_text(srna, "Pose Channel", "Channel defining pose data for a bone in a Pose.");
69
70         prop= RNA_def_property(srna, "constraints", PROP_COLLECTION, PROP_NONE);
71         RNA_def_property_collection_sdna(prop, NULL, "constraints", NULL);
72         RNA_def_property_struct_type(prop, "Constraint");
73         RNA_def_property_ui_text(prop, "Constraints", "Constraints that act on this PoseChannel."); 
74
75         prop= RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
76         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
77         RNA_def_property_ui_text(prop, "Name", "");
78         RNA_def_struct_name_property(srna, prop);
79
80         prop= RNA_def_property(srna, "ik_dof_x", PROP_BOOLEAN, PROP_NONE);
81         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_NO_XDOF);
82         RNA_def_property_ui_text(prop, "IK X DoF", "Allow movement around the X axis.");
83
84         prop= RNA_def_property(srna, "ik_dof_y", PROP_BOOLEAN, PROP_NONE);
85         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_NO_YDOF);
86         RNA_def_property_ui_text(prop, "IK Y DoF", "Allow movement around the Y axis.");
87
88         prop= RNA_def_property(srna, "ik_dof_z", PROP_BOOLEAN, PROP_NONE);
89         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_NO_ZDOF);
90         RNA_def_property_ui_text(prop, "IK Z DoF", "Allow movement around the Z axis.");
91
92         prop= RNA_def_property(srna, "ik_limit_x", PROP_BOOLEAN, PROP_NONE);
93         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_XLIMIT);
94         RNA_def_property_ui_text(prop, "IK X Limit", "Limit movement around the X axis.");
95
96         prop= RNA_def_property(srna, "ik_limit_y", PROP_BOOLEAN, PROP_NONE);
97         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_YLIMIT);
98         RNA_def_property_ui_text(prop, "IK Y Limit", "Limit movement around the Y axis.");
99
100         prop= RNA_def_property(srna, "ik_limit_z", PROP_BOOLEAN, PROP_NONE);
101         RNA_def_property_boolean_sdna(prop, NULL, "ikflag", BONE_IK_ZLIMIT);
102         RNA_def_property_ui_text(prop, "IK Z Limit", "Limit movement around the Z axis.");
103         
104         prop= RNA_def_property(srna, "selected", PROP_BOOLEAN, PROP_NONE);
105         RNA_def_property_boolean_sdna(prop, NULL, "selectflag", BONE_SELECTED);
106         RNA_def_property_ui_text(prop, "Selected", "");
107         
108                 /* XXX note: bone groups are stored internally as bActionGroups :) - Aligorith */
109         prop= RNA_def_property(srna, "bone_group_index", PROP_INT, PROP_NONE);
110         RNA_def_property_int_sdna(prop, NULL, "agrp_index");
111         RNA_def_property_ui_text(prop, "Bone Group Index", "Bone Group this pose channel belongs to (0=no group).");
112
113         prop= RNA_def_property(srna, "path_start_frame", PROP_INT, PROP_NONE);
114         RNA_def_property_int_sdna(prop, NULL, "pathsf");
115         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
116         RNA_def_property_ui_text(prop, "Bone Paths Calculation Start Frame", "Starting frame of range of frames to use for Bone Path calculations.");
117
118         prop= RNA_def_property(srna, "path_end_frame", PROP_INT, PROP_NONE);
119         RNA_def_property_int_sdna(prop, NULL, "pathef");
120         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
121         RNA_def_property_ui_text(prop, "Bone Paths Calculation End Frame", "End frame of range of frames to use for Bone Path calculations.");
122
123         prop= RNA_def_property(srna, "bone", PROP_POINTER, PROP_NEVER_NULL);
124         RNA_def_property_struct_type(prop, "Bone");
125         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
126         RNA_def_property_ui_text(prop, "Bone", "Bone associated with this Pose Channel.");
127
128         prop= RNA_def_property(srna, "parent", PROP_POINTER, PROP_NONE);
129         RNA_def_property_struct_type(prop, "PoseChannel");
130         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
131         RNA_def_property_ui_text(prop, "Parent", "Parent of this pose channel.");
132
133         prop= RNA_def_property(srna, "child", PROP_POINTER, PROP_NONE);
134         RNA_def_property_struct_type(prop, "PoseChannel");
135         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
136         RNA_def_property_ui_text(prop, "Child", "Child of this pose channel.");
137
138         prop= RNA_def_property(srna, "location", PROP_FLOAT, PROP_VECTOR);
139         RNA_def_property_float_sdna(prop, NULL, "loc");
140         RNA_def_property_ui_text(prop, "Location", "");
141         RNA_def_property_update(prop, NC_OBJECT|ND_POSE|ND_TRANSFORM, "rna_Pose_update");
142
143         prop= RNA_def_property(srna, "scale", PROP_FLOAT, PROP_VECTOR);
144         RNA_def_property_float_sdna(prop, NULL, "size");
145         RNA_def_property_ui_text(prop, "Scale", "");
146         RNA_def_property_update(prop, NC_OBJECT|ND_POSE|ND_TRANSFORM, "rna_Pose_update");
147
148         prop= RNA_def_property(srna, "rotation", PROP_FLOAT, PROP_ROTATION);
149         RNA_def_property_float_sdna(prop, NULL, "quat");
150         RNA_def_property_ui_text(prop, "Rotation", "Rotation in Quaternions.");
151         RNA_def_property_update(prop, NC_OBJECT|ND_POSE|ND_TRANSFORM, "rna_Pose_update");
152         
153         prop= RNA_def_property(srna, "euler_rotation", PROP_FLOAT, PROP_ROTATION);
154         RNA_def_property_float_sdna(prop, NULL, "eul");
155         RNA_def_property_ui_text(prop, "Rotation (Euler)", "Rotation in Eulers.");
156         RNA_def_property_update(prop, NC_OBJECT|ND_POSE|ND_TRANSFORM, "rna_Pose_update");
157         
158         prop= RNA_def_property(srna, "rotation_mode", PROP_ENUM, PROP_NONE);
159         RNA_def_property_enum_sdna(prop, NULL, "rotmode");
160         RNA_def_property_enum_items(prop, prop_rotmode_items);
161         RNA_def_property_ui_text(prop, "Rotation Mode", "");
162         RNA_def_property_update(prop, NC_OBJECT|ND_POSE|ND_TRANSFORM, "rna_Pose_update");
163
164         /* These three matrix properties await an implementation of the PROP_MATRIX subtype, which currently doesn't exist. */
165 /*      prop= RNA_def_property(srna, "channel_matrix", PROP_FLOAT, PROP_MATRIX);
166         RNA_def_property_struct_type(prop, "chan_mat");
167         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
168         RNA_def_property_ui_text(prop, "Channel Matrix", "4x4 matrix, before constraints.");*/
169
170         /* kaito says this should be not user-editable; I disagree; power users should be able to force this in python; he's the boss. */
171 /*      prop= RNA_def_property(srna, "pose_matrix", PROP_FLOAT, PROP_MATRIX);
172         RNA_def_property_struct_type(prop, "pose_mat");
173         RNA_def_property_flag(prop, PROP_NOT_EDITABLE); 
174         RNA_def_property_ui_text(prop, "Pose Matrix", "Final 4x4 matrix for this channel.");
175
176         prop= RNA_def_property(srna, "constraint_inverse_matrix", PROP_FLOAT, PROP_MATRIX);
177         RNA_def_property_struct_type(prop, "constinv");
178         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
179         RNA_def_property_ui_text(prop, "Constraint Inverse Matrix", "4x4 matrix, defines transform from final position to unconstrained position."); */
180         
181         prop= RNA_def_property(srna, "pose_head", PROP_FLOAT, PROP_VECTOR);
182         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
183         RNA_def_property_ui_text(prop, "Pose Head Position", "Location of head of the channel's bone.");
184
185         prop= RNA_def_property(srna, "pose_tail", PROP_FLOAT, PROP_VECTOR);
186         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
187         RNA_def_property_ui_text(prop, "Pose Tail Position", "Location of tail of the channel's bone.");
188
189         prop= RNA_def_property(srna, "ik_min_limits", PROP_FLOAT, PROP_VECTOR);
190         RNA_def_property_float_sdna(prop, NULL, "limitmin");
191         RNA_def_property_range(prop, -180.0f, 0.0f);
192         RNA_def_property_ui_text(prop, "IK Minimum Limits", "Minimum angles for IK Limit");
193
194         prop= RNA_def_property(srna, "ik_max_limits", PROP_FLOAT, PROP_VECTOR);
195         RNA_def_property_float_sdna(prop, NULL, "limitmax");
196         RNA_def_property_range(prop, 0.0f, 180.0f);
197         RNA_def_property_ui_text(prop, "IK Maximum Limits", "Maximum angles for IK Limit");
198
199         prop= RNA_def_property(srna, "ik_stiffness", PROP_FLOAT, PROP_VECTOR);
200         RNA_def_property_float_sdna(prop, NULL, "stiffness");
201         RNA_def_property_range(prop, 0.0f,0.99f);
202         RNA_def_property_ui_text(prop, "IK Stiffness", "Stiffness around the different axes.");
203
204         prop= RNA_def_property(srna, "ik_stretch", PROP_FLOAT, PROP_NONE);
205         RNA_def_property_float_sdna(prop, NULL, "ikstretch");
206         RNA_def_property_range(prop, 0.0f,1.0f);
207         RNA_def_property_ui_text(prop, "IK Stretch", "Allow scaling of the bone for IK.");
208
209         prop= RNA_def_property(srna, "custom", PROP_POINTER, PROP_NONE);
210         RNA_def_property_ui_text(prop, "Custom Object", "Object that defines custom draw type for this bone.");
211
212         prop= RNA_def_property(srna, "lock_location", PROP_BOOLEAN, PROP_VECTOR);
213         RNA_def_property_boolean_sdna(prop, NULL, "protectflag", OB_LOCK_LOCX);
214         RNA_def_property_array(prop, 3);
215         RNA_def_property_ui_text(prop, "Lock Location", "Lock editing of location in the interface.");
216
217         prop= RNA_def_property(srna, "lock_rotation", PROP_BOOLEAN, PROP_VECTOR);
218         RNA_def_property_boolean_sdna(prop, NULL, "protectflag", OB_LOCK_ROTX);
219         RNA_def_property_array(prop, 3);
220         RNA_def_property_ui_text(prop, "Lock Rotation", "Lock editing of rotation in the interface.");
221
222         prop= RNA_def_property(srna, "lock_scale", PROP_BOOLEAN, PROP_VECTOR);
223         RNA_def_property_boolean_sdna(prop, NULL, "protectflag", OB_LOCK_SCALEX);
224         RNA_def_property_array(prop, 3);
225         RNA_def_property_ui_text(prop, "Lock Scale", "Lock editing of scale in the interface.");
226 }
227
228 void RNA_def_pose(BlenderRNA *brna)
229 {
230         StructRNA *srna;
231         PropertyRNA *prop;
232
233         rna_def_pose_channel(brna);
234
235         srna= RNA_def_struct(brna, "Pose", NULL);
236         RNA_def_struct_sdna(srna, "bPose");
237         RNA_def_struct_ui_text(srna, "Pose", "A collection of pose channels, including settings for animating bones.");
238
239         prop= RNA_def_property(srna, "pose_channels", PROP_COLLECTION, PROP_NONE);
240         RNA_def_property_collection_sdna(prop, NULL, "chanbase", NULL);
241         RNA_def_property_struct_type(prop, "PoseChannel");
242         RNA_def_property_ui_text(prop, "Pose Channels", "Individual pose channels for the armature.");
243
244         /* commented for now... missing info... */
245         /*prop= RNA_def_property(srna, "action_groups", PROP_COLLECTION, PROP_NONE);
246         RNA_def_property_collection_sdna(prop, NULL, "agroups", NULL);
247         RNA_def_property_struct_type(prop, "ActionGroup");
248         RNA_def_property_ui_text(prop, "Action Groups", "Groups of bones.");*/
249 }
250
251 #endif