Merge with -r 22620:23107.
[blender.git] / source / blender / blenkernel / BKE_armature.h
index 1f9725a4f413b27fa9ddf443d7fc13ced6f08d85..1cbb2331782f223aa5193bd2dc4ff9f94bfdf67b 100644 (file)
@@ -3,15 +3,12 @@
  *     
  * $Id$ 
  *
- * ***** BEGIN GPL/BL DUAL LICENSE BLOCK *****
+ * ***** BEGIN GPL LICENSE BLOCK *****
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License
  * as published by the Free Software Foundation; either version 2
- * of the License, or (at your option) any later version. The Blender
- * Foundation also sells licenses for use in proprietary software under
- * the Blender License.  See http://www.blender.org/BL/ for information
- * about this.
+ * of the License, or (at your option) any later version.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -29,7 +26,7 @@
  *
  * Contributor(s): none yet.
  *
- * ***** END GPL/BL DUAL LICENSE BLOCK *****
+ * ***** END GPL LICENSE BLOCK *****
  */
 #ifndef BKE_ARMATURE_H
 #define BKE_ARMATURE_H
@@ -38,83 +35,84 @@ struct Bone;
 struct Main;
 struct bArmature;
 struct bPose;
+struct bPoseChannel;
+struct bConstraint;
+struct Scene;
 struct Object;
 struct MDeformVert;
 struct Mesh;
-struct PoseChain;
+struct PoseTree;
 struct ListBase;
 
-typedef struct PoseChain
+typedef struct PoseTarget
 {
-       struct PoseChain *next, *prev;
-       struct Bone     *root;
-       struct Bone     *target;
-       struct bPose *pose;
-       float   goal[3];
-       float   tolerance;
-       int             iterations;
-       float   goalinv[4][4];
-       struct IK_Chain_Extern *solver;
-} PoseChain;
+       struct PoseTarget *next, *prev;
+
+       struct bConstraint *con;                /* the constrait of this target */
+       int tip;                                                /* index of tip pchan in PoseTree */
+} PoseTarget;
+
+typedef struct PoseTree
+{
+       struct PoseTree *next, *prev;
+
+       struct ListBase targets;                /* list of targets of the tree */
+       struct bPoseChannel     **pchan;        /* array of pose channels */
+       int             *parent;                                /* and their parents */
+       int             totchannel;                             /* number of pose channels */
+       float   (*basis_change)[3][3];  /* basis change result from solver */
+       int             iterations;                             /* iterations from the constraint */
+       int     stretch;                                /* disable stretching */
+} PoseTree;
 
 /*     Core armature functionality */
 #ifdef __cplusplus
 extern "C" {
 #endif
-struct bArmature *add_armature(void);
+
+struct bArmature *add_armature(char *name);
+struct bArmature *get_armature(struct Object *ob);
 void free_boneChildren(struct Bone *bone);
 void free_bones (struct bArmature *arm);
-void unlink_armature(struct bArmature *arm);
 void free_armature(struct bArmature *arm);
 void make_local_armature(struct bArmature *arm);
 struct bArmature *copy_armature(struct bArmature *arm);
-void apply_pose_armature (struct bArmature* arm, struct bPose* pose, int doit);
-void calc_armature_deform (struct Object *ob, float *co, int index);
-int verify_boneptr (struct bArmature *arm, struct Bone *tBone);
-void init_armature_deform(struct Object *parent, struct Object *ob);
-struct bArmature* get_armature (struct Object* ob);
+
+void bone_flip_name (char *name, int strip_number);
+void bone_autoside_name (char *name, int strip_number, short axis, float head, float tail);
+
 struct Bone *get_named_bone (struct bArmature *arm, const char *name);
-struct Bone *get_indexed_bone (struct bArmature *arm, int index);
-void make_displists_by_armature (struct Object *ob);
-void calc_bone_deform (struct Bone *bone, float weight, float *vec, float *co, float *contrib);
-float dist_to_bone (float vec[3], float b1[3], float b2[3]);
-
-void where_is_armature_time (struct Object *ob, float ctime);
-void where_is_armature (struct Object *ob);
-void where_is_bone1_time (struct Object *ob, struct Bone *bone, float ctime);
-
-/*     Handy bone matrix functions */
-void bone_to_mat4(struct Bone *bone, float mat[][4]);
-void bone_to_mat3(struct Bone *bone, float mat[][3]);
-void make_boneMatrixvr (float outmatrix[][4],float delta[3], float roll);
-void make_boneMatrix (float outmatrix[][4], struct Bone *bone);
-void get_bone_root_pos (struct Bone* bone, float vec[3], int posed);
-void get_bone_tip_pos (struct Bone* bone, float vec[3], int posed);
-float get_bone_length (struct Bone *bone);
+
+float distfactor_to_bone (float vec[3], float b1[3], float b2[3], float rad1, float rad2, float rdist);
+
+void where_is_armature (struct bArmature *arm);
+void where_is_armature_bone(struct Bone *bone, struct Bone *prevbone);
+void armature_rebuild_pose(struct Object *ob, struct bArmature *arm);
+void where_is_pose (struct Scene *scene, struct Object *ob);
+
+/* get_objectspace_bone_matrix has to be removed still */
 void get_objectspace_bone_matrix (struct Bone* bone, float M_accumulatedMatrix[][4], int root, int posed);
-void precalc_bone_irestmat (struct Bone *bone);
-void precalc_armature_posemats (struct bArmature *arm);
-void precalc_bonelist_irestmats (struct ListBase* bonelist);
-void apply_bonemat(struct Bone *bone);
+void vec_roll_to_mat3(float *vec, float roll, float mat[][3]);
+void mat3_to_vec_roll(float mat[][3], float *vec, float *roll);
 
-/* void make_armatureParentMatrices (struct bArmature *arm); */
-void precalc_bone_defmat (struct Bone *bone);
-void rebuild_bone_parent_matrix (struct Bone *bone);
+/* Common Conversions Between Co-ordinate Spaces */
+void armature_mat_world_to_pose(struct Object *ob, float inmat[][4], float outmat[][4]);
+void armature_loc_world_to_pose(struct Object *ob, float *inloc, float *outloc);
+void armature_mat_pose_to_bone(struct bPoseChannel *pchan, float inmat[][4], float outmat[][4]);
+void armature_loc_pose_to_bone(struct bPoseChannel *pchan, float *inloc, float *outloc);
+void armature_mat_pose_to_delta(float delta_mat[][4], float pose_mat[][4], float arm_mat[][4]);
 
 /*     Animation functions */
-void where_is_bone_time (struct Object *ob, struct Bone *bone, float ctime);
-void where_is_bone (struct Object *ob, struct Bone *bone);
-struct PoseChain *ik_chain_to_posechain (struct Object *ob, struct Bone *bone);
-void solve_posechain (PoseChain *chain);
-void free_posechain (PoseChain *chain);
-
-/*     Gameblender hacks */
-void GB_init_armature_deform(struct ListBase *defbase, float premat[][4], float postmat[][4]);
-void GB_calc_armature_deform (float *co, struct MDeformVert *dvert);
-void GB_build_mats (float parmat[][4], float obmat[][4], float premat[][4], float postmat[][4]);
-void GB_validate_defgroups (struct Mesh *mesh, struct ListBase *defbase);
-
-/*void make_boneParentMatrix (struct Bone* bone, float mat[][4]);*/ 
+struct PoseTree *ik_tree_to_posetree(struct Object *ob, struct Bone *bone);
+void solve_posetree(PoseTree *tree);
+void free_posetree(PoseTree *tree);
+
+/* B-Bone support */
+typedef struct Mat4 {
+       float mat[4][4];
+} Mat4;
+
+Mat4 *b_bone_spline_setup(struct bPoseChannel *pchan, int rest);
 
 #ifdef __cplusplus
 }