f3db904287925cba0c89f064e5b92b4e89747975
[blender.git] / source / blender / editors / armature / armature_intern.h
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  * The Original Code is Copyright (C) 2009 Blender Foundation.
19  * All rights reserved.
20  *
21  * 
22  * Contributor(s): Blender Foundation
23  *
24  * ***** END GPL LICENSE BLOCK *****
25  */
26
27 /** \file blender/editors/armature/armature_intern.h
28  *  \ingroup edarmature
29  */
30
31 #ifndef __ARMATURE_INTERN_H__
32 #define __ARMATURE_INTERN_H__
33
34 /* internal exports only */
35 struct wmOperatorType;
36
37 struct bContext;
38 struct Scene;
39 struct Object;
40 struct Base;
41 struct bAction;
42 struct bPoseChannel;
43
44 struct bArmature;
45 struct EditBone;
46 struct Bone;
47
48 struct ListBase;
49 struct LinkData;
50
51 /* ******************************************************* */
52 /* Armature EditMode Operators */
53 void ARMATURE_OT_bone_primitive_add(struct wmOperatorType *ot);
54
55 void ARMATURE_OT_align(struct wmOperatorType *ot);
56 void ARMATURE_OT_calculate_roll(struct wmOperatorType *ot);
57 void ARMATURE_OT_switch_direction(struct wmOperatorType *ot);
58
59 void ARMATURE_OT_subdivide(struct wmOperatorType *ot);
60
61 void ARMATURE_OT_parent_set(struct wmOperatorType *ot);
62 void ARMATURE_OT_parent_clear(struct wmOperatorType *ot);
63
64 void ARMATURE_OT_select_all(struct wmOperatorType *ot);
65 void ARMATURE_OT_select_mirror(struct wmOperatorType *ot);
66 void ARMATURE_OT_select_more(struct wmOperatorType *ot);
67 void ARMATURE_OT_select_less(struct wmOperatorType *ot);
68 void ARMATURE_OT_select_hierarchy(struct wmOperatorType *ot);
69 void ARMATURE_OT_select_linked(struct wmOperatorType *ot);
70 void ARMATURE_OT_select_similar(struct wmOperatorType *ot);
71 void ARMATURE_OT_shortest_path_pick(struct wmOperatorType *ot);
72
73 void ARMATURE_OT_delete(struct wmOperatorType *ot);
74 void ARMATURE_OT_duplicate(struct wmOperatorType *ot);
75 void ARMATURE_OT_extrude(struct wmOperatorType *ot);
76 void ARMATURE_OT_hide(struct wmOperatorType *ot);
77 void ARMATURE_OT_reveal(struct wmOperatorType *ot);
78 void ARMATURE_OT_click_extrude(struct wmOperatorType *ot);
79 void ARMATURE_OT_fill(struct wmOperatorType *ot);
80 void ARMATURE_OT_merge(struct wmOperatorType *ot);
81 void ARMATURE_OT_separate(struct wmOperatorType *ot);
82 void ARMATURE_OT_split(struct wmOperatorType *ot);
83
84 void ARMATURE_OT_autoside_names(struct wmOperatorType *ot);
85 void ARMATURE_OT_flip_names(struct wmOperatorType *ot);
86
87 void ARMATURE_OT_layers_show_all(struct wmOperatorType *ot);
88 void ARMATURE_OT_armature_layers(struct wmOperatorType *ot);
89 void ARMATURE_OT_bone_layers(struct wmOperatorType *ot);
90
91 /* ******************************************************* */
92 /* Pose-Mode Operators */
93 void POSE_OT_hide(struct wmOperatorType *ot);
94 void POSE_OT_reveal(struct wmOperatorType *ot);
95
96 void POSE_OT_armature_apply(struct wmOperatorType *ot);
97 void POSE_OT_visual_transform_apply(struct wmOperatorType *ot);
98
99 void POSE_OT_rot_clear(struct wmOperatorType *ot);
100 void POSE_OT_loc_clear(struct wmOperatorType *ot);
101 void POSE_OT_scale_clear(struct wmOperatorType *ot);
102 void POSE_OT_transforms_clear(struct wmOperatorType *ot);
103 void POSE_OT_user_transforms_clear(struct wmOperatorType *ot);
104
105 void POSE_OT_copy(struct wmOperatorType *ot);
106 void POSE_OT_paste(struct wmOperatorType *ot);
107
108 void POSE_OT_select_all(struct wmOperatorType *ot);
109 void POSE_OT_select_parent(struct wmOperatorType *ot);
110 void POSE_OT_select_hierarchy(struct wmOperatorType *ot);
111 void POSE_OT_select_linked(struct wmOperatorType *ot);
112 void POSE_OT_select_constraint_target(struct wmOperatorType *ot);
113 void POSE_OT_select_grouped(struct wmOperatorType *ot);
114 void POSE_OT_select_mirror(struct wmOperatorType *ot);
115
116 void POSE_OT_group_add(struct wmOperatorType *ot);
117 void POSE_OT_group_remove(struct wmOperatorType *ot);
118 void POSE_OT_group_move(struct wmOperatorType *ot);
119 void POSE_OT_group_sort(struct wmOperatorType *ot);
120 void POSE_OT_group_assign(struct wmOperatorType *ot);
121 void POSE_OT_group_unassign(struct wmOperatorType *ot);
122 void POSE_OT_group_select(struct wmOperatorType *ot);
123 void POSE_OT_group_deselect(struct wmOperatorType *ot);
124
125 void POSE_OT_paths_calculate(struct wmOperatorType *ot);
126 void POSE_OT_paths_update(struct wmOperatorType *ot);
127 void POSE_OT_paths_clear(struct wmOperatorType *ot);
128
129 void POSE_OT_autoside_names(struct wmOperatorType *ot);
130 void POSE_OT_flip_names(struct wmOperatorType *ot);
131
132 void POSE_OT_rotation_mode_set(struct wmOperatorType *ot);
133
134 void POSE_OT_quaternions_flip(struct wmOperatorType *ot);
135
136 void POSE_OT_armature_layers(struct wmOperatorType *ot);
137 void POSE_OT_bone_layers(struct wmOperatorType *ot);
138
139 /* ******************************************************* */
140 /* Etch-A-Ton (Skeleton Sketching) Operators */
141
142 void SKETCH_OT_gesture(struct wmOperatorType *ot);
143 void SKETCH_OT_delete(struct wmOperatorType *ot);
144 void SKETCH_OT_draw_stroke(struct wmOperatorType *ot);
145 void SKETCH_OT_draw_preview(struct wmOperatorType *ot);
146 void SKETCH_OT_finish_stroke(struct wmOperatorType *ot);
147 void SKETCH_OT_cancel_stroke(struct wmOperatorType *ot);
148 void SKETCH_OT_convert(struct wmOperatorType *ot);
149 void SKETCH_OT_select(struct wmOperatorType *ot);
150
151 /* ******************************************************* */
152 /* Pose Tool Utilities (for PoseLib, Pose Sliding, etc.) */
153 /* pose_utils.c */
154
155 /* Temporary data linking PoseChannels with the F-Curves they affect */
156 typedef struct tPChanFCurveLink {
157         struct tPChanFCurveLink *next, *prev;
158         
159         ListBase fcurves;               /* F-Curves for this PoseChannel (wrapped with LinkData) */
160         struct bPoseChannel *pchan;     /* Pose Channel which data is attached to */
161         
162         char *pchan_path;               /* RNA Path to this Pose Channel (needs to be freed when we're done) */
163         
164         float oldloc[3];                /* transform values at start of operator (to be restored before each modal step) */
165         float oldrot[3];
166         float oldscale[3];
167         float oldquat[4];
168         float oldangle;
169         float oldaxis[3];
170         
171         struct IDProperty *oldprops;    /* copy of custom properties at start of operator (to be restored before each modal step) */
172 } tPChanFCurveLink;
173
174 /* ----------- */
175
176 void poseAnim_mapping_get(struct bContext *C, ListBase *pfLinks, struct Object *ob, struct bAction *act);
177 void poseAnim_mapping_free(ListBase *pfLinks);
178
179 void poseAnim_mapping_refresh(struct bContext *C, struct Scene *scene, struct Object *ob);
180 void poseAnim_mapping_reset(ListBase *pfLinks);
181 void poseAnim_mapping_autoKeyframe(struct bContext *C, struct Scene *scene, struct Object *ob, ListBase *pfLinks, float cframe);
182
183 LinkData *poseAnim_mapping_getNextFCurve(ListBase *fcuLinks, LinkData *prev, const char *path);
184
185 /* ******************************************************* */
186 /* PoseLib */
187 /* pose_lib.c */
188
189 void POSELIB_OT_new(struct wmOperatorType *ot);
190 void POSELIB_OT_unlink(struct wmOperatorType *ot);
191
192 void POSELIB_OT_action_sanitize(struct wmOperatorType *ot);
193
194 void POSELIB_OT_pose_add(struct wmOperatorType *ot);
195 void POSELIB_OT_pose_remove(struct wmOperatorType *ot);
196 void POSELIB_OT_pose_rename(struct wmOperatorType *ot);
197
198 void POSELIB_OT_browse_interactive(struct wmOperatorType *ot);
199 void POSELIB_OT_apply_pose(struct wmOperatorType *ot);
200
201 /* ******************************************************* */
202 /* Pose Sliding Tools */
203 /* pose_slide.c */
204
205 void POSE_OT_push(struct wmOperatorType *ot);
206 void POSE_OT_relax(struct wmOperatorType *ot);
207 void POSE_OT_breakdown(struct wmOperatorType *ot);
208
209 void POSE_OT_propagate(struct wmOperatorType *ot);
210
211 /* ******************************************************* */
212 /* Various Armature Edit/Pose Editing API's */
213
214 /* Ideally, many of these defines would not be needed as everything would be strictly self-contained
215  * within each file, but some tools still have a bit of overlap which makes things messy -- Feb 2013
216  */
217
218 EditBone *make_boneList(struct ListBase *edbo, struct ListBase *bones, struct EditBone *parent, struct Bone *actBone);
219 void BIF_sk_selectStroke(struct bContext *C, const int mval[2], short extend);
220
221 /* duplicate method */
222 void preEditBoneDuplicate(struct ListBase *editbones);
223 struct EditBone *duplicateEditBone(struct EditBone *curBone, const char *name, struct ListBase *editbones, struct Object *ob);
224 void updateDuplicateSubtarget(struct EditBone *dupBone, struct ListBase *editbones, struct Object *ob);
225
226 /* duplicate method (cross objects) */
227 /* editbones is the target list */
228 struct EditBone *duplicateEditBoneObjects(struct EditBone *curBone, const char *name, struct ListBase *editbones, struct Object *src_ob, struct Object *dst_ob);
229
230 /* editbones is the source list */
231 void updateDuplicateSubtargetObjects(struct EditBone *dupBone, struct ListBase *editbones, struct Object *src_ob, struct Object *dst_ob);
232
233 EditBone *add_points_bone(struct Object *obedit, float head[3], float tail[3]);
234 void bone_free(struct bArmature *arm, struct EditBone *bone);
235
236 void armature_tag_select_mirrored(struct bArmature *arm);
237 void armature_select_mirrored(struct bArmature *arm);
238 void armature_tag_unselect(struct bArmature *arm);
239
240 void *get_nearest_bone(struct bContext *C, short findunsel, int x, int y);
241 void *get_bone_from_selectbuffer(struct Scene *scene, struct Base *base, unsigned int *buffer, short hits, short findunsel);
242
243 int bone_looper(struct Object *ob, struct Bone *bone, void *data,
244                 int (*bone_func)(struct Object *, struct Bone *, void *));
245
246
247 #endif /* __ARMATURE_INTERN_H__ */
248