Fix related to T65963: Ctest: Failing test script_load_keymap passes.
[blender.git] / source / blender / makesdna / DNA_armature_types.h
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  *
16  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
17  * All rights reserved.
18  */
19
20 /** \file
21  * \ingroup DNA
22  */
23
24 #ifndef __DNA_ARMATURE_TYPES_H__
25 #define __DNA_ARMATURE_TYPES_H__
26
27 #include "DNA_defs.h"
28 #include "DNA_listBase.h"
29 #include "DNA_ID.h"
30
31 struct AnimData;
32
33 /* this system works on different transformation space levels;
34  *
35  * 1) Bone Space;      with each Bone having own (0,0,0) origin
36  * 2) Armature Space;  the rest position, in Object space, Bones Spaces are applied hierarchical
37  * 3) Pose Space;      the animation position, in Object space
38  * 4) World Space;     Object matrix applied to Pose or Armature space
39  */
40
41 typedef struct Bone {
42   /**  Next/prev elements within this list. */
43   struct Bone *next, *prev;
44   /** User-Defined Properties on this Bone. */
45   IDProperty *prop;
46   /**  Parent (ik parent if appropriate flag is set. */
47   struct Bone *parent;
48   /**  Children   . */
49   ListBase childbase;
50   /**  Name of the bone - must be unique within the armature, MAXBONENAME. */
51   char name[64];
52
53   /**  roll is input for editmode, length calculated. */
54   float roll;
55   float head[3];
56   /**  head/tail and roll in Bone Space   . */
57   float tail[3];
58   /**  rotation derived from head/tail/roll. */
59   float bone_mat[3][3];
60
61   int flag;
62
63   float arm_head[3];
64   /**  head/tail in Armature Space (rest pos). */
65   float arm_tail[3];
66   /**  matrix: (bonemat(b)+head(b))*arm_mat(b-1), rest po.s*/
67   float arm_mat[4][4];
68   /** Roll in Armature Space (rest pos). */
69   float arm_roll;
70
71   /**  dist, weight: for non-deformgroup deforms. */
72   float dist, weight;
73   /**  width: for block bones. keep in this order, transform!. */
74   float xwidth, length, zwidth;
75   /** Radius for head/tail sphere, defining deform as well, parent->rad_tip overrides rad_head. */
76   float rad_head, rad_tail;
77
78   /** Curved bones settings - these define the "restpose" for a curved bone. */
79   float roll1, roll2;
80   float curve_in_x, curve_in_y;
81   float curve_out_x, curve_out_y;
82   /** Length of bezier handles. */
83   float ease1, ease2;
84   float scale_in_x, scale_in_y;
85   float scale_out_x, scale_out_y;
86
87   /**  patch for upward compat, UNUSED!. */
88   float size[3];
89   /** Layers that bone appears on. */
90   int layer;
91   /**  for B-bones. */
92   short segments;
93
94   /** Type of next/prev bone handles. */
95   char bbone_prev_type;
96   char bbone_next_type;
97   /** Next/prev bones to use as handle references when calculating bbones (optional). */
98   struct Bone *bbone_prev;
99   struct Bone *bbone_next;
100 } Bone;
101
102 typedef struct bArmature {
103   ID id;
104   struct AnimData *adt;
105
106   ListBase bonebase;
107
108   /** Ghash for quicker lookups of bones by name. */
109   struct GHash *bonehash;
110   void *_pad1;
111
112   /** Editbone listbase, we use pointer so we can check state. */
113   ListBase *edbo;
114
115   /* active bones should work like active object where possible
116    * - active and selection are unrelated
117    * - active & hidden is not allowed
118    * - from the user perspective active == last selected
119    * - active should be ignored when not visible (hidden layer) */
120
121   /** Active bone. */
122   Bone *act_bone;
123   /** Active editbone (in editmode). */
124   struct EditBone *act_edbone;
125
126   int flag;
127   int drawtype;
128   /** How vertex deformation is handled in the ge. */
129   int gevertdeformer;
130   char _pad[4];
131   short deformflag;
132   short pathflag;
133
134   /** For UI, to show which layers are there. */
135   unsigned int layer_used;
136   /** For buttons to work, both variables in this order together. */
137   unsigned int layer, layer_protected;
138 } bArmature;
139
140 /* armature->flag */
141 /* don't use bit 7, was saved in files to disable stuff */
142 typedef enum eArmature_Flag {
143   ARM_RESTPOS = (1 << 0),
144   /** XRAY is here only for backwards converting */
145   ARM_FLAG_UNUSED_1 = (1 << 1), /* cleared */
146   ARM_DRAWAXES = (1 << 2),
147   ARM_DRAWNAMES = (1 << 3),
148   ARM_POSEMODE = (1 << 4),
149   ARM_FLAG_UNUSED_5 = (1 << 5), /* cleared */
150   ARM_FLAG_UNUSED_6 = (1 << 6), /* cleared */
151   ARM_FLAG_UNUSED_7 = (1 << 7),
152   ARM_MIRROR_EDIT = (1 << 8),
153   ARM_FLAG_UNUSED_9 = (1 << 9),
154   /** made option negative, for backwards compat */
155   ARM_NO_CUSTOM = (1 << 10),
156   /** draw custom colors  */
157   ARM_COL_CUSTOM = (1 << 11),
158   /** when ghosting, only show selected bones (this should belong to ghostflag instead) */
159   ARM_FLAG_UNUSED_12 = (1 << 12), /* cleared */
160   /** dopesheet channel is expanded */
161   ARM_DS_EXPAND = (1 << 13),
162   /** other objects are used for visualizing various states (hack for efficient updates) */
163   ARM_HAS_VIZ_DEPS = (1 << 14),
164 } eArmature_Flag;
165
166 /* armature->drawtype */
167 typedef enum eArmature_Drawtype {
168   ARM_OCTA = 0,
169   ARM_LINE = 1,
170   ARM_B_BONE = 2,
171   ARM_ENVELOPE = 3,
172   ARM_WIRE = 4,
173 } eArmature_Drawtype;
174
175 /* armature->gevertdeformer */
176 typedef enum eArmature_VertDeformer {
177   ARM_VDEF_BLENDER = 0,
178   ARM_VDEF_BGE_CPU = 1,
179 } eArmature_VertDeformer;
180
181 /* armature->deformflag */
182 typedef enum eArmature_DeformFlag {
183   ARM_DEF_VGROUP = (1 << 0),
184   ARM_DEF_ENVELOPE = (1 << 1),
185   ARM_DEF_QUATERNION = (1 << 2),
186 #ifdef DNA_DEPRECATED
187   ARM_DEF_B_BONE_REST = (1 << 3), /* deprecated */
188 #endif
189   ARM_DEF_INVERT_VGROUP = (1 << 4),
190 } eArmature_DeformFlag;
191
192 /* armature->pathflag */
193 // XXX deprecated... old animation system (armature only viz)
194 #ifdef DNA_DEPRECATED
195 typedef enum eArmature_PathFlag {
196   ARM_PATH_FNUMS = (1 << 0),
197   ARM_PATH_KFRAS = (1 << 1),
198   ARM_PATH_HEADS = (1 << 2),
199   ARM_PATH_ACFRA = (1 << 3),
200   ARM_PATH_KFNOS = (1 << 4),
201 } eArmature_PathFlag;
202 #endif
203
204 /* bone->flag */
205 typedef enum eBone_Flag {
206   BONE_SELECTED = (1 << 0),
207   BONE_ROOTSEL = (1 << 1),
208   BONE_TIPSEL = (1 << 2),
209   /** Used instead of BONE_SELECTED during transform (clear before use) */
210   BONE_TRANSFORM = (1 << 3),
211   /** when bone has a parent, connect head of bone to parent's tail*/
212   BONE_CONNECTED = (1 << 4),
213   /* 32 used to be quatrot, was always set in files, do not reuse unless you clear it always */
214   /** hidden Bones when drawing PoseChannels */
215   BONE_HIDDEN_P = (1 << 6),
216   /** For detecting cyclic dependencies */
217   BONE_DONE = (1 << 7),
218   /** active is on mouse clicks only - deprecated, ONLY USE FOR DRAWING */
219   BONE_DRAW_ACTIVE = (1 << 8),
220   /** No parent rotation or scale */
221   BONE_HINGE = (1 << 9),
222   /** hidden Bones when drawing Armature Editmode */
223   BONE_HIDDEN_A = (1 << 10),
224   /** multiplies vgroup with envelope */
225   BONE_MULT_VG_ENV = (1 << 11),
226   /** bone doesn't deform geometry */
227   BONE_NO_DEFORM = (1 << 12),
228   /** set to prevent destruction of its unkeyframed pose (after transform) */
229   BONE_UNKEYED = (1 << 13),
230   /** set to prevent hinge child bones from influencing the transform center */
231   BONE_HINGE_CHILD_TRANSFORM = (1 << 14),
232   /** No parent scale */
233   BONE_NO_SCALE = (1 << 15),
234   /** hidden bone when drawing PoseChannels (for ghost drawing) */
235   BONE_HIDDEN_PG = (1 << 16),
236   /** bone should be drawn as OB_WIRE, regardless of draw-types of view+armature */
237   BONE_DRAWWIRE = (1 << 17),
238   /** when no parent, bone will not get cyclic offset */
239   BONE_NO_CYCLICOFFSET = (1 << 18),
240   /** bone transforms are locked in EditMode */
241   BONE_EDITMODE_LOCKED = (1 << 19),
242   /** Indicates that a parent is also being transformed */
243   BONE_TRANSFORM_CHILD = (1 << 20),
244   /** bone cannot be selected */
245   BONE_UNSELECTABLE = (1 << 21),
246   /** bone location is in armature space */
247   BONE_NO_LOCAL_LOCATION = (1 << 22),
248   /** object child will use relative transform (like deform) */
249   BONE_RELATIVE_PARENTING = (1 << 23),
250   /** it will add the parent end roll to the inroll */
251   BONE_ADD_PARENT_END_ROLL = (1 << 24),
252   /** this bone was transformed by the mirror function */
253   BONE_TRANSFORM_MIRROR = (1 << 25),
254
255 } eBone_Flag;
256
257 /* bone->bbone_prev_type, bbone_next_type */
258 typedef enum eBone_BBoneHandleType {
259   BBONE_HANDLE_AUTO = 0, /* Default mode based on parents & children. */
260   BBONE_HANDLE_ABSOLUTE, /* Custom handle in absolute position mode. */
261   BBONE_HANDLE_RELATIVE, /* Custom handle in relative position mode. */
262   BBONE_HANDLE_TANGENT,  /* Custom handle in tangent mode (use direction, not location). */
263 } eBone_BBoneHandleType;
264
265 #define MAXBONENAME 64
266
267 #endif