File Browser fixes:
[blender.git] / source / blender / makesdna / DNA_action_types.h
1 /*  
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version. 
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19  *
20  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
21  * All rights reserved.
22  *
23  * Contributor(s): Original design: Reevan McKay
24  * Contributor(s): Full recode, Ton Roosendaal, Crete 2005
25  * Contributor(s): Animation recode, Joshua Leung
26  *
27  * ***** END GPL LICENSE BLOCK *****
28  */
29
30
31 #ifndef DNA_ACTION_TYPES_H
32 #define DNA_ACTION_TYPES_H
33
34 #include "DNA_listBase.h"
35 #include "DNA_ID.h"
36 #include "DNA_gpencil_types.h"
37 #include "DNA_view2d_types.h"
38 #include "DNA_userdef_types.h"
39
40 struct SpaceLink;
41 struct Object;
42
43 /* ************************************************ */
44 /* Visualisation */
45
46 /* Motion Paths ------------------------------------ */
47 /* (used for Pose Channels and Objects) */
48
49 /* Data point for motion path */
50 typedef struct bMotionPathVert {
51         float co[3];                            /* coordinates of point in 3D-space */
52         int flag;                                       /* quick settings */
53 } bMotionPathVert;
54
55 /* Motion Path data cache - for elements providing transforms (i.e. Objects or PoseChannels) */
56 typedef struct bMotionPath {
57         bMotionPathVert *points;        /* path samples */
58         int     length;                                 /* the number of cached verts */
59         
60         int start_frame;                        /* for drawing paths, the start frame number */
61         int     end_frame;                              /* for drawing paths, the end frame number */
62         
63         int flag;                                       /* extra settings */
64 } bMotionPath;
65
66
67
68 /* Animation Visualisation Settings - for Objects or Armatures (not PoseChannels) */
69 typedef struct bAnimVizSettings {
70         int pad;
71         int pathflag;                           /* eMotionPath_Settings */
72         
73         int pathsf, pathef;                     /* start and end frames of path-calculation range */
74         int     pathbc, pathac;                 /* number of frames before/after current frame of path-calculation */
75 } bAnimVizSettings;
76
77 /* bMotionPathSettings->flag */
78 typedef enum eMotionPath_Settings {
79                 /* show frames on path */
80         MOTIONPATH_FLAG_FNUMS           = (1<<0),
81                 /* show keyframes on path */
82         MOTIONPATH_FLAG_KFRAS           = (1<<1),
83                 /* for bones - calculate head-points for curves instead of tips */
84         MOTIONPATH_FLAG_HEADS           = (1<<2),
85                 /* show path around current frame */
86         MOTIONPATH_FLAG_ACFRA           = (1<<3),
87                 /* show keyframe/frame numbers */
88         MOTIONPATH_FLAG_KFNOS           = (1<<4)
89 } eMotionPath_Settings;
90
91 /* ************************************************ */
92 /* Poses */
93
94 /* PoseChannel ------------------------------------ */
95
96 /* PoseChannel 
97  *
98  * A PoseChannel stores the results of Actions and transform information 
99  * with respect to the restposition of Armature bones 
100  */
101 typedef struct bPoseChannel {
102         struct bPoseChannel     *next, *prev;
103         
104         IDProperty                      *prop;          /* User-Defined Properties on this PoseChannel */                       
105         
106         ListBase                        constraints;/* Constraints that act on this PoseChannel */
107         char                            name[32];       /* Channels need longer names than normal blender objects */
108         
109         short                           flag;           /* dynamic, for detecting transform changes */
110         short                           constflag;  /* for quick detecting which constraints affect this channel */
111         short                           ikflag;         /* settings for IK bones */
112         short               selectflag; /* copy of bone flag, so you can work with library armatures */
113         short                           protectflag; /* protect channels from being transformed */
114         short                           agrp_index; /* index of action-group this bone belongs to (0 = default/no group) */
115         
116         int                                 pathlen;    /* for drawing paths, the amount of frames */
117         int                             pathsf;         /* for drawing paths, the start frame number */
118         int                                     pathef;         /* for drawing paths, the end frame number */
119         
120         struct Bone                     *bone;          /* set on read file or rebuild pose */
121         struct bPoseChannel *parent;    /* set on read file or rebuild pose */
122         struct bPoseChannel *child;             /* set on read file or rebuild pose, the 'ik' child, for b-bones */
123         struct ListBase          iktree;                /* only while evaluating pose */
124         
125         /* only while deform, stores precalculated b_bone deform mats,
126            dual quaternions */
127         void                            *b_bone_mats;   
128         void                            *dual_quat;
129         void                            *b_bone_dual_quats;
130         
131         float           loc[3];                         /* transforms - written in by actions or transform */
132         float           size[3];
133         
134         float           eul[3];                         /* rotations - written in by actions or transform (but only euler/quat in use at any one time!) */
135         float           quat[4];
136         short           rotmode;                        /* for now either quat (0), or xyz-euler (1) */
137         short           pad;
138         
139         float           chan_mat[4][4];         /* matrix result of loc/quat/size , and where we put deform in, see next line */
140         float           pose_mat[4][4];         /* constraints accumulate here. in the end, pose_mat = bone->arm_mat * chan_mat */
141         float           constinv[4][4];         /* inverse result of constraints. doesn't include effect of restposition, parent, and local transform*/
142         
143         float           pose_head[3];           /* actually pose_mat[3] */
144         float           pose_tail[3];           /* also used for drawing help lines... */
145         
146         float           limitmin[3], limitmax[3];       /* DOF constraint */
147         float           stiffness[3];                           /* DOF stiffness */
148         float           ikstretch;
149         float           ikrotweight;            /* weight of joint rotation constraint */
150         float           iklinweight;            /* weight of joint stretch constraint */
151
152         float           *path;                          /* totpath x 3 x float */
153         struct Object *custom;                  /* draws custom object instead of this channel */
154 } bPoseChannel;
155
156
157 /* PoseChannel (transform) flags */
158 typedef enum ePchan_Flag {
159         POSE_LOC                =       0x0001,
160         POSE_ROT                =       0x0002,
161         POSE_SIZE               =       0x0004,
162         POSE_IK_MAT             =       0x0008,
163         POSE_UNUSED2    =       0x0010,
164         POSE_UNUSED3    =       0x0020,
165         POSE_UNUSED4    =       0x0040,
166         POSE_UNUSED5    =       0x0080,
167         POSE_HAS_IK             =       0x0100,
168         POSE_CHAIN              =       0x0200,
169         POSE_DONE               =   0x0400,
170         POSE_KEY                =       0x1000,
171         POSE_STRIDE             =       0x2000,
172         POSE_IKTREE             =   0x4000,
173 } ePchan_Flag;
174
175 /* PoseChannel constflag (constraint detection) */
176 typedef enum ePchan_ConstFlag {
177         PCHAN_HAS_IK            = (1<<0),
178         PCHAN_HAS_CONST         = (1<<1),
179                 /* only used for drawing Posemode, not stored in channel */
180         PCHAN_HAS_ACTION        = (1<<2),
181         PCHAN_HAS_TARGET        = (1<<3),
182                 /* only for drawing Posemode too */
183         PCHAN_HAS_STRIDE        = (1<<4)
184 } ePchan_ConstFlag;
185
186 /* PoseChannel->ikflag */
187 typedef enum ePchan_IkFlag {
188         BONE_IK_NO_XDOF = (1<<0),
189         BONE_IK_NO_YDOF = (1<<1),
190         BONE_IK_NO_ZDOF = (1<<2),
191
192         BONE_IK_XLIMIT  = (1<<3),
193         BONE_IK_YLIMIT  = (1<<4),
194         BONE_IK_ZLIMIT  = (1<<5),
195         
196         BONE_IK_ROTCTL  = (1<<6),
197         BONE_IK_LINCTL  = (1<<7),
198
199         BONE_IK_NO_XDOF_TEMP = (1<<10),
200         BONE_IK_NO_YDOF_TEMP = (1<<11),
201         BONE_IK_NO_ZDOF_TEMP = (1<<12),
202
203 } ePchan_IkFlag;
204
205 /* PoseChannel->rotmode and Object->rotmode */
206 typedef enum eRotationModes {
207                 /* quaternion rotations (default, and for older Blender versions) */
208         ROT_MODE_QUAT   = 0,
209                 /* euler rotations - keep in sync with enum in BLI_arithb.h */
210         ROT_MODE_EUL = 1,               /* Blender 'default' (classic) - must be as 1 to sync with arithb defines */
211         ROT_MODE_XYZ = 1,               /* Blender 'default' (classic) - must be as 1 to sync with arithb defines */
212         ROT_MODE_XZY,
213         ROT_MODE_YXZ,
214         ROT_MODE_YZX,
215         ROT_MODE_ZXY,
216         ROT_MODE_ZYX,
217         /* NOTE: space is reserved here for 18 other possible 
218          * euler rotation orders not implemented 
219          */
220         ROT_MODE_MAX,   /* sentinel for Py API */
221                 /* axis angle rotations */
222         ROT_MODE_AXISANGLE = -1
223 } eRotationModes;
224
225 /* Pose ------------------------------------ */
226
227 /* Pose-Object. 
228  *
229  * It is only found under ob->pose. It is not library data, even
230  * though there is a define for it (hack for the outliner).
231  */
232 typedef struct bPose {
233         ListBase chanbase;                      /* list of pose channels */
234         
235         short flag, proxy_layer;        /* proxy layer: copy from armature, gets synced */
236         
237         float ctime;                            /* local action time of this pose */
238         float stride_offset[3];         /* applied to object */
239         float cyclic_offset[3];         /* result of match and cycles, applied in where_is_pose() */
240         
241         
242         ListBase agroups;                       /* list of bActionGroups */
243         
244         int active_group;                       /* index of active group (starts from 1) */
245         int     iksolver;                               /* ik solver to use, see ePose_IKSolverType */
246         void *ikdata;                           /* temporary IK data, depends on the IK solver. Not saved in file */
247         void *ikparam;                          /* IK solver parameters, structure depends on iksolver */ 
248 } bPose;
249
250
251 /* Pose->flag */
252 typedef enum ePose_Flags {
253                 /* results in armature_rebuild_pose being called */
254         POSE_RECALC = (1<<0),
255                 /* prevents any channel from getting overridden by anim from IPO */
256         POSE_LOCKED     = (1<<1),
257                 /* clears the POSE_LOCKED flag for the next time the pose is evaluated */
258         POSE_DO_UNLOCK  = (1<<2),
259                 /* pose has constraints which depend on time (used when depsgraph updates for a new frame) */
260         POSE_CONSTRAINTS_TIMEDEPEND = (1<<3),
261                 /* recalculate bone paths */
262         POSE_RECALCPATHS = (1<<4),
263             /* set by armature_rebuild_pose to give a chance to the IK solver to rebuild IK tree */
264         POSE_WAS_REBUILT = (1<<5),
265             /* set by game_copy_pose to indicate that this pose is used in the game engine */
266         POSE_GAME_ENGINE = (1<<6),
267 } ePose_Flags;
268
269 /* IK Solvers ------------------------------------ */
270
271 /* bPose->iksolver and bPose->ikparam->iksolver */
272 typedef enum {
273         IKSOLVER_LEGACY = 0,
274         IKSOLVER_ITASC,
275 } ePose_IKSolverType;
276
277 /* header for all bPose->ikparam structures */
278 typedef struct bIKParam {
279         int   iksolver;
280 } bIKParam;
281
282 /* bPose->ikparam when bPose->iksolver=1 */
283 typedef struct bItasc {
284         int   iksolver;
285         float precision;
286         short numiter;
287         short numstep;
288         float minstep;
289         float maxstep;
290         short solver;   
291         short flag;
292         float feedback;
293         float maxvel;   /* max velocity to SDLS solver */
294         float dampmax;  /* maximum damping for DLS solver */
295         float dampeps;  /* threshold of singular value from which the damping start progressively */
296 } bItasc;
297
298 /* bItasc->flag */
299 typedef enum {
300         ITASC_AUTO_STEP = (1<<0),
301         ITASC_INITIAL_REITERATION = (1<<1),
302         ITASC_REITERATION = (1<<2),
303         ITASC_SIMULATION = (1<<3),
304 } eItasc_Flags;
305
306 /* bItasc->solver */
307 typedef enum {
308         ITASC_SOLVER_SDLS = 0,  /* selective damped least square, suitable for CopyPose constraint */
309         ITASC_SOLVER_DLS                /* damped least square with numerical filtering of damping */
310 } eItasc_Solver;
311
312 /* ************************************************ */
313 /* Action */
314
315 /* Groups -------------------------------------- */
316
317 /* Action-Channel Group (agrp)
318
319  * These are stored as a list per-Action, and are only used to 
320  * group that Action's channels in an Animation Editor. 
321  *
322  * Even though all FCurves live in a big list per Action, each group they are in also
323  * holds references to the achans within that list which belong to it. Care must be taken to
324  * ensure that action-groups never end up being the sole 'owner' of a channel.
325  * 
326  * This is also exploited for bone-groups. Bone-Groups are stored per bPose, and are used 
327  * primarily to colour bones in the 3d-view. There are other benefits too, but those are mostly related
328  * to Action-Groups.
329  */
330 typedef struct bActionGroup {
331         struct bActionGroup *next, *prev;
332         
333         ListBase channels;                      /* Note: this must not be touched by standard listbase functions which would clear links to other channels */
334         
335         int flag;                                       /* settings for this action-group */
336         int customCol;                          /* index of custom color set to use when used for bones (0=default - used for all old files, -1=custom set) */                          
337         char name[64];                          /* name of the group */
338         
339         ThemeWireColor cs;                      /* color set to use when customCol == -1 */
340 } bActionGroup;
341
342 /* Action Group flags */
343 typedef enum eActionGroup_Flag {
344                 /* group is selected */
345         AGRP_SELECTED   = (1<<0),
346                 /* group is 'active' / last selected one */
347         AGRP_ACTIVE     = (1<<1),
348                 /* keyframes/channels belonging to it cannot be edited */
349         AGRP_PROTECTED  = (1<<2),
350                 /* for UI, sub-channels are shown */
351         AGRP_EXPANDED   = (1<<3),
352                 /* sub-channels are not evaluated */
353         AGRP_MUTED              = (1<<4),
354                 /* sub-channels are not visible in Graph Editor */
355         AGRP_NOTVISIBLE = (1<<5),
356         
357         AGRP_TEMP               = (1<<30),
358         AGRP_MOVED              = (1<<31)
359 } eActionGroup_Flag;
360
361
362 /* Actions -------------------------------------- */
363
364 /* Action - reusable F-Curve 'bag'  (act) 
365  *
366  * This contains F-Curves that may affect settings from more than one ID blocktype and/or 
367  * datablock (i.e. sub-data linked/used directly to the ID block that the animation data is linked to), 
368  * but with the restriction that the other unrelated data (i.e. data that is not directly used or linked to
369  * by the source ID block).
370  *
371  * It serves as a 'unit' of reusable animation information (i.e. keyframes/motion data), that 
372  * affects a group of related settings (as defined by the user). 
373  */
374 typedef struct bAction {
375         ID      id;                             /* ID-serialisation for relinking */
376         
377         ListBase curves;        /* function-curves (FCurve) */
378         ListBase chanbase;      /* legacy data - Action Channels (bActionChannel) in pre-2.5 animation system */
379         ListBase groups;        /* groups of function-curves (bActionGroup) */
380         ListBase markers;       /* markers local to the Action (used to provide Pose-Libraries) */
381         
382         int flag;                       /* settings for this action */
383         int active_marker;      /* index of the active marker */
384 } bAction;
385
386
387 /* Flags for the action */
388 typedef enum eAction_Flags {
389                 /* flags for displaying in UI */
390         ACT_COLLAPSED   = (1<<0),
391         ACT_SELECTED    = (1<<1),
392         
393                 /* flags for evaluation/editing */
394         ACT_MUTED               = (1<<9),
395         ACT_PROTECTED   = (1<<10),
396         ACT_DISABLED    = (1<<11),
397 } eAction_Flags;
398
399
400 /* ************************************************ */
401 /* Action/Dopesheet Editor */
402
403 /* Storage for Dopesheet/Grease-Pencil Editor data */
404 typedef struct bDopeSheet {
405         ID              *source;                /* currently ID_SCE (for Dopesheet), and ID_SC (for Grease Pencil) */
406         ListBase chanbase;              /* cache for channels (only initialised when pinned) */  // XXX not used!
407         
408         int filterflag;                 /* flags to use for filtering data */
409         int flag;                               /* standard flags */
410 } bDopeSheet;
411
412
413 /* DopeSheet filter-flag */
414 typedef enum DOPESHEET_FILTERFLAG {
415                 /* general filtering */
416         ADS_FILTER_ONLYSEL                      = (1<<0),       /* only include channels relating to selected data */
417         
418                 /* temporary (runtime flags) */
419         ADS_FILTER_ONLYDRIVERS          = (1<<1),       /* for 'Drivers' editor - only include Driver data from AnimData */
420         ADS_FILTER_ONLYNLA                      = (1<<2),       /* for 'NLA' editor - only include NLA data from AnimData */
421         ADS_FILTER_SELEDIT                      = (1<<3),       /* for Graph Editor - used to indicate whether to include a filtering flag or not */
422         
423                 /* datatype-based filtering */
424         ADS_FILTER_NOSHAPEKEYS          = (1<<6),
425         ADS_FILTER_NOCAM                        = (1<<10),
426         ADS_FILTER_NOMAT                        = (1<<11),
427         ADS_FILTER_NOLAM                        = (1<<12),
428         ADS_FILTER_NOCUR                        = (1<<13),
429         ADS_FILTER_NOWOR                        = (1<<14),
430         ADS_FILTER_NOSCE                        = (1<<15),
431         ADS_FILTER_NOPART                       = (1<<16),
432         ADS_FILTER_NOMBA                        = (1<<17),
433         ADS_FILTER_NOARM                        = (1<<18),
434         
435                 /* NLA-specific filters */
436         ADS_FILTER_NLA_NOACT            = (1<<20),      /* if the AnimData block has no NLA data, don't include to just show Action-line */
437         
438                 /* combination filters (some only used at runtime) */
439         ADS_FILTER_NOOBDATA = (ADS_FILTER_NOCAM|ADS_FILTER_NOMAT|ADS_FILTER_NOLAM|ADS_FILTER_NOCUR|ADS_FILTER_NOPART|ADS_FILTER_NOARM),
440 } DOPESHEET_FILTERFLAG; 
441
442 /* DopeSheet general flags */
443 //typedef enum DOPESHEET_FLAG {
444         
445 //} DOPESHEET_FLAG;
446
447
448
449 /* Action Editor Space. This is defined here instead of in DNA_space_types.h */
450 typedef struct SpaceAction {
451         struct SpaceLink *next, *prev;
452         ListBase regionbase;            /* storage of regions for inactive spaces */
453         int spacetype;
454         float blockscale;
455
456         short blockhandler[8];
457
458         View2D v2d;                                     /* depricated, copied to region */
459         
460         bAction         *action;                /* the currently active action */
461         bDopeSheet      ads;                    /* the currently active context (when not showing action) */
462         
463         char  mode, autosnap;           /* mode: editing context; autosnap: automatic keyframe snapping mode   */
464         short flag, actnr;                      /* flag: bitmapped settings; */
465         short pin, lock;                        /* pin: keep showing current action; actnr: used for finding chosen action from menu; lock: lock time to other windows */
466         short actwidth;                         /* width of the left-hand side name panel (in pixels?) */  // XXX depreceated!
467         float timeslide;                        /* for Time-Slide transform mode drawing - current frame? */
468 } SpaceAction;
469
470 /* SpaceAction flag */
471 typedef enum eSAction_Flag {
472                 /* during transform (only set for TimeSlide) */
473         SACTION_MOVING  = (1<<0),       
474                 /* show sliders (if relevant) */
475         SACTION_SLIDERS = (1<<1),       
476                 /* draw time in seconds instead of time in frames */
477         SACTION_DRAWTIME = (1<<2),
478                 /* don't filter action channels according to visibility */
479         SACTION_NOHIDE = (1<<3),
480                 /* don't kill overlapping keyframes after transform */
481         SACTION_NOTRANSKEYCULL = (1<<4),
482                 /* don't include keyframes that are out of view */
483         SACTION_HORIZOPTIMISEON = (1<<5),
484                 /* hack for moving pose-markers (temp flag)  */
485         SACTION_POSEMARKERS_MOVE = (1<<6),
486                 /* don't draw action channels using group colours (where applicable) */
487         SACTION_NODRAWGCOLORS = (1<<7),
488                 /* don't draw current frame number beside frame indicator */
489         SACTION_NODRAWCFRANUM = (1<<8),
490 } eSAction_Flag;        
491
492 /* SpaceAction Mode Settings */
493 // XXX should this be used by other editors too?
494 typedef enum eAnimEdit_Context {
495                 /* action (default) */
496         SACTCONT_ACTION = 0,
497                 /* editing of shapekey's IPO block */
498         SACTCONT_SHAPEKEY,
499                 /* editing of gpencil data */
500         SACTCONT_GPENCIL,
501                 /* dopesheet */
502         SACTCONT_DOPESHEET,
503 } eAnimEdit_Context;
504
505 /* SpaceAction AutoSnap Settings (also used by other Animation Editors) */
506 typedef enum eAnimEdit_AutoSnap {
507                 /* no auto-snap */
508         SACTSNAP_OFF = 0,       
509                 /* snap to 1.0 frame/second intervals */
510         SACTSNAP_STEP,
511                 /* snap to actual frames/seconds (nla-action time) */
512         SACTSNAP_FRAME,
513                 /* snap to nearest marker */
514         SACTSNAP_MARKER,
515 } eAnimEdit_AutoSnap;
516
517
518 /* ************************************************ */
519 /* Legacy Data */
520
521 /* WARNING: Action Channels are now depreceated... they were part of the old animation system!
522  *                (ONLY USED FOR DO_VERSIONS...)
523  * 
524  * Action Channels belong to Actions. They are linked with an IPO block, and can also own 
525  * Constraint Channels in certain situations. 
526  *
527  * Action-Channels can only belong to one group at a time, but they still live the Action's
528  * list of achans (to preserve backwards compatability, and also minimise the code
529  * that would need to be recoded). Grouped achans are stored at the start of the list, according
530  * to the position of the group in the list, and their position within the group. 
531  */
532 typedef struct bActionChannel {
533         struct bActionChannel   *next, *prev;
534         bActionGroup                    *grp;                                   /* Action Group this Action Channel belongs to */
535         
536         struct Ipo                              *ipo;                                   /* IPO block this action channel references */
537         ListBase                                constraintChannels;             /* Constraint Channels (when Action Channel represents an Object or Bone) */
538         
539         int             flag;                   /* settings accessed via bitmapping */
540         char    name[32];               /* channel name */
541         int             temp;                   /* temporary setting - may be used to indicate group that channel belongs to during syncing  */
542 } bActionChannel;
543
544 /* Action Channel flags (ONLY USED FOR DO_VERSIONS...) */
545 typedef enum ACHAN_FLAG {
546         ACHAN_SELECTED  = (1<<0),
547         ACHAN_HILIGHTED = (1<<1),
548         ACHAN_HIDDEN    = (1<<2),
549         ACHAN_PROTECTED = (1<<3),
550         ACHAN_EXPANDED  = (1<<4),
551         ACHAN_SHOWIPO   = (1<<5),
552         ACHAN_SHOWCONS  = (1<<6),
553         ACHAN_MOVED     = (1<<31),
554 } ACHAN_FLAG; 
555
556
557 #endif