Third and last commit for Brecht's IK work.
[blender.git] / source / blender / blenkernel / BKE_armature.h
1 /**
2  * blenlib/BKE_armature.h (mar-2001 nzc)
3  *      
4  * $Id$ 
5  *
6  * ***** BEGIN GPL/BL DUAL LICENSE BLOCK *****
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License
10  * as published by the Free Software Foundation; either version 2
11  * of the License, or (at your option) any later version. The Blender
12  * Foundation also sells licenses for use in proprietary software under
13  * the Blender License.  See http://www.blender.org/BL/ for information
14  * about this.
15  *
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  * GNU General Public License for more details.
20  *
21  * You should have received a copy of the GNU General Public License
22  * along with this program; if not, write to the Free Software Foundation,
23  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
24  *
25  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
26  * All rights reserved.
27  *
28  * The Original Code is: all of this file.
29  *
30  * Contributor(s): none yet.
31  *
32  * ***** END GPL/BL DUAL LICENSE BLOCK *****
33  */
34 #ifndef BKE_ARMATURE_H
35 #define BKE_ARMATURE_H
36
37 struct Bone;
38 struct Main;
39 struct bArmature;
40 struct bPose;
41 struct bPoseChannel;
42 struct bConstraint;
43 struct Object;
44 struct MDeformVert;
45 struct Mesh;
46 struct PoseChain;
47 struct ListBase;
48
49 typedef struct PoseTarget
50 {
51         struct PoseTarget *next, *prev;
52         struct bConstraint *con;
53         int tip;
54 } PoseTarget;
55
56 typedef struct PoseChain
57 {
58         struct PoseChain *next, *prev;  // hurms
59         struct bPoseChannel     **pchanchain;
60         struct ListBase targets;
61         int             totchannel;
62         float   (*basis_change)[3][3];
63         char    group[32];
64         float   tolerance;
65         int             iterations;
66 } PoseChain;
67
68 /*      Core armature functionality */
69 #ifdef __cplusplus
70 extern "C" {
71 #endif
72 struct bArmature *add_armature(void);
73 void free_boneChildren(struct Bone *bone);
74 void free_bones (struct bArmature *arm);
75 void unlink_armature(struct bArmature *arm);
76 void free_armature(struct bArmature *arm);
77 void make_local_armature(struct bArmature *arm);
78 struct bArmature *copy_armature(struct bArmature *arm);
79 void bone_flip_name (char *name, int strip_number);
80
81 struct bArmature* get_armature (struct Object* ob);
82 struct Bone *get_named_bone (struct bArmature *arm, const char *name);
83
84 float distfactor_to_bone (float vec[3], float b1[3], float b2[3], float rad1, float rad2, float rdist);
85
86 void where_is_armature (struct bArmature *arm);
87 void where_is_armature_bone(struct Bone *bone, struct Bone *prevbone);
88 void armature_rebuild_pose(struct Object *ob, struct bArmature *arm);
89 void where_is_pose (struct Object *ob);
90
91 /* get_objectspace_bone_matrix has to be removed still */
92 void get_objectspace_bone_matrix (struct Bone* bone, float M_accumulatedMatrix[][4], int root, int posed);
93 void vec_roll_to_mat3(float *vec, float roll, float mat[][3]);
94
95
96 /*      Animation functions */
97
98 struct PoseChain *ik_chain_to_posechain (struct Object *ob, struct Bone *bone);
99 void solve_posechain (PoseChain *chain);
100 void free_posechain (PoseChain *chain);
101
102 /*      Gameblender hacks */
103 void GB_init_armature_deform(struct ListBase *defbase, float premat[][4], float postmat[][4]);
104 void GB_calc_armature_deform (float *co, struct MDeformVert *dvert);
105 void GB_build_mats (float parmat[][4], float obmat[][4], float premat[][4], float postmat[][4]);
106 void GB_validate_defgroups (struct Mesh *mesh, struct ListBase *defbase);
107
108 /* B-Bone support */
109 typedef struct Mat4 {
110         float mat[4][4];
111 } Mat4;
112
113 Mat4 *b_bone_spline_setup(struct bPoseChannel *pchan);
114
115
116 #ifdef __cplusplus
117 }
118 #endif
119
120 #endif
121