Merge with -r 22620:23107.
[blender.git] / source / blender / blenkernel / BKE_armature.h
index 354b065773c10c5d47c5f204da3bf9a70bcee23a..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
@@ -40,77 +37,82 @@ 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;  // hurms
-       struct bPoseChannel     **pchanchain;
-       struct bConstraint *con;
-       struct Bone *root, *target;
-       struct bPose *pose;
-       int totchannel;
-       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 bone_flip_name (char *name);
 
-void calc_armature_deform (struct Object *ob, float *co, int index);
+void bone_flip_name (char *name, int strip_number);
+void bone_autoside_name (char *name, int strip_number, short axis, float head, float tail);
 
-void init_armature_deform(struct Object *parent, struct Object *ob);
-struct bArmature* get_armature (struct Object* ob);
 struct Bone *get_named_bone (struct bArmature *arm, const char *name);
 
-float dist_to_bone (float vec[3], float b1[3], float b2[3]);
+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 Object *ob);
+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 vec_roll_to_mat3(float *vec, float roll, float mat[][3]);
+void mat3_to_vec_roll(float mat[][3], float *vec, float *roll);
 
+/* 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 */
-
-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);
+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);
-
+Mat4 *b_bone_spline_setup(struct bPoseChannel *pchan, int rest);
 
 #ifdef __cplusplus
 }