GSOC 2013 paint
[blender.git] / source / blender / makesdna / DNA_armature_types.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) 2001-2002 by NaN Holding BV.
19  * All rights reserved.
20  *
21  * Contributor(s): Full recode, Ton Roosendaal, Crete 2005
22  *
23  * ***** END GPL LICENSE BLOCK *****
24  */
25
26 /** \file DNA_armature_types.h
27  *  \ingroup DNA
28  */
29
30 #ifndef __DNA_ARMATURE_TYPES_H__
31 #define __DNA_ARMATURE_TYPES_H__
32
33 #include "DNA_defs.h"
34 #include "DNA_listBase.h"
35 #include "DNA_ID.h"
36
37 struct AnimData;
38
39 /* this system works on different transformation space levels;
40  *
41  * 1) Bone Space;      with each Bone having own (0,0,0) origin
42  * 2) Armature Space;  the rest position, in Object space, Bones Spaces are applied hierarchical
43  * 3) Pose Space;      the animation position, in Object space
44  * 4) World Space;     Object matrix applied to Pose or Armature space
45  *
46  */
47
48 typedef struct Bone {
49         struct Bone *next, *prev;    /*  Next/prev elements within this list */
50         IDProperty  *prop;           /* User-Defined Properties on this Bone */
51         struct Bone *parent;         /*  Parent (ik parent if appropriate flag is set */
52         ListBase     childbase;      /*  Children    */
53         char         name[64];       /*  Name of the bone - must be unique within the armature, MAXBONENAME */
54
55         float        roll;           /*  roll is input for editmode, length calculated */
56         float        head[3];
57         float        tail[3];        /*  head/tail and roll in Bone Space    */
58         float        bone_mat[3][3]; /*  rotation derived from head/tail/roll */
59
60         int          flag;
61
62         float        arm_head[3];
63         float        arm_tail[3];    /*  head/tail in Armature Space (rest pos) */
64         float        arm_mat[4][4];  /*  matrix: (bonemat(b)+head(b))*arm_mat(b-1), rest pos*/
65         float        arm_roll;       /* roll in Armature Space (rest pos) */
66
67         float        dist, weight;           /*  dist, weight: for non-deformgroup deforms */
68         float        xwidth, length, zwidth; /*  width: for block bones. keep in this order, transform! */
69         float        ease1, ease2;           /*  length of bezier handles */
70         float        rad_head, rad_tail;     /* radius for head/tail sphere, defining deform as well, parent->rad_tip overrides rad_head */
71
72         float        size[3];        /*  patch for upward compat, UNUSED! */
73         int          layer;          /* layers that bone appears on */
74         short        segments;       /*  for B-bones */
75         short        pad[1];
76 } Bone;
77
78 typedef struct bArmature {
79         ID          id;
80         struct AnimData *adt;
81
82         ListBase    bonebase;
83         ListBase    chainbase;
84         ListBase   *edbo;                   /* editbone listbase, we use pointer so we can check state */
85
86         /* active bones should work like active object where possible
87          * - active and selection are unrelated
88          * - active & hidden is not allowed
89          * - from the user perspective active == last selected
90          * - active should be ignored when not visible (hidden layer) */
91
92         Bone       *act_bone;               /* active bone */
93         struct EditBone *act_edbone;        /* active editbone (in editmode) */
94
95         void       *sketch;                 /* sketch struct for etch-a-ton */
96
97         int         flag;
98         int         drawtype;
99         int         gevertdeformer;         /* how vertex deformation is handled in the ge */
100         int         pad;
101         short       deformflag;
102         short       pathflag;
103
104         unsigned int layer_used;             /* for UI, to show which layers are there */
105         unsigned int layer, layer_protected; /* for buttons to work, both variables in this order together */
106
107 // XXX deprecated... old animaton system (armature only viz) ---
108         short       ghostep, ghostsize;     /* number of frames to ghosts to show, and step between them  */
109         short       ghosttype, pathsize;        /* ghost drawing options and number of frames between points of path */
110         int         ghostsf, ghostef;       /* start and end frames of ghost-drawing range */
111         int         pathsf, pathef;         /* start and end frames of path-calculation range for all bones */
112         int         pathbc, pathac;         /* number of frames before/after current frame of path-calculation for all bones  */
113 // XXX end of deprecated code ----------------------------------
114 } bArmature;
115
116 /* armature->flag */
117 /* don't use bit 7, was saved in files to disable stuff */
118 typedef enum eArmature_Flag {
119         ARM_RESTPOS         = (1<<0),
120         ARM_DRAWXRAY        = (1<<1),   /* XRAY is here only for backwards converting */
121         ARM_DRAWAXES        = (1<<2),
122         ARM_DRAWNAMES       = (1<<3),
123         ARM_POSEMODE        = (1<<4),
124         ARM_EDITMODE        = (1<<5),
125         ARM_DELAYDEFORM     = (1<<6),
126         ARM_DONT_USE        = (1<<7),
127         ARM_MIRROR_EDIT     = (1<<8),
128         ARM_AUTO_IK         = (1<<9),
129         ARM_NO_CUSTOM       = (1<<10),  /* made option negative, for backwards compat */
130         ARM_COL_CUSTOM      = (1<<11),  /* draw custom colors  */
131         ARM_GHOST_ONLYSEL   = (1<<12),  /* when ghosting, only show selected bones (this should belong to ghostflag instead) */ /* XXX deprecated */
132         ARM_DS_EXPAND       = (1<<13),  /* dopesheet channel is expanded */
133         ARM_HAS_VIZ_DEPS    = (1<<14),  /* other objects are used for visualizing various states (hack for efficient updates) */
134 } eArmature_Flag;
135
136 /* armature->drawtype */
137 typedef enum eArmature_Drawtype {
138         ARM_OCTA = 0,
139         ARM_LINE = 1,
140         ARM_B_BONE = 2,
141         ARM_ENVELOPE = 3,
142         ARM_WIRE = 4
143 } eArmature_Drawtype;
144
145 /* armature->gevertdeformer */
146 typedef enum eArmature_VertDeformer {
147         ARM_VDEF_BLENDER = 0,
148         ARM_VDEF_BGE_CPU = 1
149 } eArmature_VertDeformer;
150
151 /* armature->deformflag */
152 typedef enum eArmature_DeformFlag {
153         ARM_DEF_VGROUP                  = (1<<0),
154         ARM_DEF_ENVELOPE                = (1<<1),
155         ARM_DEF_QUATERNION              = (1<<2),
156         ARM_DEF_B_BONE_REST             = (1<<3),       /* deprecated */
157         ARM_DEF_INVERT_VGROUP   = (1<<4)
158 } eArmature_DeformFlag;
159
160 #if (DNA_DEPRECATED_GCC_POISON == 1)
161 #pragma GCC poison ARM_DEF_B_BONE_REST
162 #endif
163
164 /* armature->pathflag */
165 // XXX deprecated... old animation system (armature only viz)
166 typedef enum eArmature_PathFlag {
167         ARM_PATH_FNUMS          = (1<<0),
168         ARM_PATH_KFRAS          = (1<<1),
169         ARM_PATH_HEADS          = (1<<2),
170         ARM_PATH_ACFRA          = (1<<3),
171         ARM_PATH_KFNOS          = (1<<4)
172 } eArmature_PathFlag;
173
174 #if (DNA_DEPRECATED_GCC_POISON == 1)
175 #pragma GCC poison ARM_PATH_FNUMS ARM_PATH_KFRAS ARM_PATH_HEADS ARM_PATH_ACFRA ARM_PATH_KFNOS
176 #endif
177
178 /* armature->ghosttype */
179 // XXX deprecated... old animation system (armature only viz)
180 typedef enum eArmature_GhostType {
181         ARM_GHOST_CUR = 0,
182         ARM_GHOST_RANGE = 1,
183         ARM_GHOST_KEYS = 2
184 } eArmature_GhostType;
185
186 /* bone->flag */
187 typedef enum eBone_Flag {
188         BONE_SELECTED               = (1 << 0),
189         BONE_ROOTSEL                = (1 << 1),
190         BONE_TIPSEL                 = (1 << 2),
191         BONE_TRANSFORM              = (1 << 3),   /* Used instead of BONE_SELECTED during transform */
192         BONE_CONNECTED              = (1 << 4),   /* when bone has a parent, connect head of bone to parent's tail*/
193         /* 32 used to be quatrot, was always set in files, do not reuse unless you clear it always */
194         BONE_HIDDEN_P               = (1 << 6),   /* hidden Bones when drawing PoseChannels */
195         BONE_DONE                   = (1 << 7),   /* For detecting cyclic dependencies */
196         BONE_DRAW_ACTIVE            = (1 << 8),   /* active is on mouse clicks only - deprecated, ONLY USE FOR DRAWING */
197         BONE_HINGE                  = (1 << 9),   /* No parent rotation or scale */
198         BONE_HIDDEN_A               = (1 << 10),  /* hidden Bones when drawing Armature Editmode */
199         BONE_MULT_VG_ENV            = (1 << 11),  /* multiplies vgroup with envelope */
200         BONE_NO_DEFORM              = (1 << 12),  /* bone doesn't deform geometry */
201         BONE_UNKEYED                = (1 << 13),  /* set to prevent destruction of its unkeyframed pose (after transform) */
202         BONE_HINGE_CHILD_TRANSFORM  = (1 << 14),  /* set to prevent hinge child bones from influencing the transform center */
203         BONE_NO_SCALE               = (1 << 15),  /* No parent scale */
204         BONE_HIDDEN_PG              = (1 << 16),  /* hidden bone when drawing PoseChannels (for ghost drawing) */
205         BONE_DRAWWIRE               = (1 << 17),  /* bone should be drawn as OB_WIRE, regardless of draw-types of view+armature */
206         BONE_NO_CYCLICOFFSET        = (1 << 18),  /* when no parent, bone will not get cyclic offset */
207         BONE_EDITMODE_LOCKED        = (1 << 19),  /* bone transforms are locked in EditMode */
208         BONE_TRANSFORM_CHILD        = (1 << 20),  /* Indicates that a parent is also being transformed */
209         BONE_UNSELECTABLE           = (1 << 21),  /* bone cannot be selected */
210         BONE_NO_LOCAL_LOCATION      = (1 << 22),  /* bone location is in armature space */
211         BONE_RELATIVE_PARENTING     = (1 << 23)   /* object child will use relative transform (like deform) */
212         
213 } eBone_Flag;
214
215 #define MAXBONENAME 64
216
217 #endif