Dopesheet: Keyframe size can be adjusted as part of theme settings
[blender.git] / source / blender / editors / include / ED_keyframes_draw.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) (C) 2009 Blender Foundation, Joshua Leung
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): Joshua Leung (full recode)
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27
28 /** \file ED_keyframes_draw.h
29  *  \ingroup editors
30  */
31
32 #ifndef __ED_KEYFRAMES_DRAW_H__
33 #define __ED_KEYFRAMES_DRAW_H__
34
35 struct bAnimContext;
36 struct AnimData;
37 struct FCurve;
38 struct bDopeSheet;
39 struct bAction;
40 struct bActionGroup;
41 struct Object;
42 struct ListBase;
43 struct bGPDlayer;
44 struct MaskLayer;
45 struct Scene;
46 struct View2D;
47 struct DLRBT_Tree;
48
49 /* ****************************** Base Structs ****************************** */
50
51 /* Keyframe Column Struct */
52 typedef struct ActKeyColumn {
53         /* ListBase linkage */
54         struct ActKeyColumn *next, *prev;
55         
56         /* sorting-tree linkage */
57         struct ActKeyColumn *left, *right;  /* 'children' of this node, less than and greater than it (respectively) */
58         struct ActKeyColumn *parent;        /* parent of this node in the tree */
59         char tree_col;                      /* DLRB_BLACK or DLRB_RED */
60         
61         /* keyframe info */
62         char key_type;                      /* eBezTripe_KeyframeType */
63         short sel;
64         float cfra;
65         
66         /* only while drawing - used to determine if long-keyframe needs to be drawn */
67         short modified;
68         short totcurve;
69 } ActKeyColumn;
70
71 /* 'Long Keyframe' Struct */
72 typedef struct ActKeyBlock {
73         /* ListBase linkage */
74         struct ActKeyBlock *next, *prev;
75         
76         /* sorting-tree linkage */
77         struct ActKeyBlock *left, *right;   /* 'children' of this node, less than and greater than it (respectively) */
78         struct ActKeyBlock *parent;         /* parent of this node in the tree */
79         char tree_col;                      /* DLRB_BLACK or DLRB_RED */
80         
81         /* key-block info */
82         char sel;
83         short handle_type;
84         float val;
85         float start, end;
86         
87         /* only while drawing - used to determine if block needs to be drawn */
88         short modified;
89         short totcurve; 
90 } ActKeyBlock;
91
92 /* *********************** Keyframe Drawing ****************************** */
93
94 /* options for keyframe shape drawing */
95 typedef enum eKeyframeShapeDrawOpts {
96         /* only the border */
97         KEYFRAME_SHAPE_FRAME = 0,
98         /* only the inside filling */
99         KEYFRAME_SHAPE_INSIDE,
100         /* the whole thing */
101         KEYFRAME_SHAPE_BOTH
102 } eKeyframeShapeDrawOpts;
103
104 /* draw simple diamond-shape keyframe (with OpenGL) */
105 void draw_keyframe_shape(float x, float y, float xscale, float hsize, short sel, short key_type, short mode, float alpha);
106
107 /* ******************************* Methods ****************************** */
108
109 /* Channel Drawing ------------------ */
110 /* F-Curve */
111 void draw_fcurve_channel(struct View2D *v2d, struct AnimData *adt, struct FCurve *fcu, float ypos, float yscale_fac);
112 /* Action Group Summary */
113 void draw_agroup_channel(struct View2D *v2d, struct AnimData *adt, struct bActionGroup *agrp, float ypos, float yscale_fac);
114 /* Action Summary */
115 void draw_action_channel(struct View2D *v2d, struct AnimData *adt, struct bAction *act, float ypos, float yscale_fac);
116 /* Object Summary */
117 void draw_object_channel(struct View2D *v2d, struct bDopeSheet *ads, struct Object *ob, float ypos, float yscale_fac);
118 /* Scene Summary */
119 void draw_scene_channel(struct View2D *v2d, struct bDopeSheet *ads, struct Scene *sce, float ypos, float yscale_fac);
120 /* DopeSheet Summary */
121 void draw_summary_channel(struct View2D *v2d, struct bAnimContext *ac, float ypos, float yscale_fac);
122 /* Grease Pencil datablock summary */
123 void draw_gpencil_channel(struct View2D *v2d, struct bDopeSheet *ads, struct bGPdata *gpd, float ypos, float yscale_fac);
124 /* Grease Pencil Layer */
125 void draw_gpl_channel(struct View2D *v2d, struct bDopeSheet *ads, struct bGPDlayer *gpl, float ypos, float yscale_fac);
126 /* Mask Layer */
127 void draw_masklay_channel(struct View2D *v2d, struct bDopeSheet *ads, struct MaskLayer *masklay, float ypos, float yscale_fac);
128
129 /* Keydata Generation --------------- */
130 /* F-Curve */
131 void fcurve_to_keylist(struct AnimData *adt, struct FCurve *fcu, struct DLRBT_Tree *keys, struct DLRBT_Tree *blocks);
132 /* Action Group */
133 void agroup_to_keylist(struct AnimData *adt, struct bActionGroup *agrp, struct DLRBT_Tree *keys, struct DLRBT_Tree *blocks);
134 /* Action */
135 void action_to_keylist(struct AnimData *adt, struct bAction *act, struct DLRBT_Tree *keys, struct DLRBT_Tree *blocks);
136 /* Object */
137 void ob_to_keylist(struct bDopeSheet *ads, struct Object *ob, struct DLRBT_Tree *keys, struct DLRBT_Tree *blocks);
138 /* Scene */
139 void scene_to_keylist(struct bDopeSheet *ads, struct Scene *sce, struct DLRBT_Tree *keys, struct DLRBT_Tree *blocks);
140 /* DopeSheet Summary */
141 void summary_to_keylist(struct bAnimContext *ac, struct DLRBT_Tree *keys, struct DLRBT_Tree *blocks);
142 /* Grease Pencil datablock summary */
143 void gpencil_to_keylist(struct bDopeSheet *ads, struct bGPdata *gpd, struct DLRBT_Tree *keys);
144 /* Grease Pencil Layer */
145 void gpl_to_keylist(struct bDopeSheet *ads, struct bGPDlayer *gpl, struct DLRBT_Tree *keys);
146 /* Mask */
147 void mask_to_keylist(struct bDopeSheet *UNUSED(ads), struct MaskLayer *masklay, struct DLRBT_Tree *keys);
148
149 /* ActKeyColumn API ---------------- */
150 /* Comparator callback used for ActKeyColumns and cframe float-value pointer */
151 short compare_ak_cfraPtr(void *node, void *data);
152
153 /* Comparator callback used for ActKeyBlocks and cframe float-value pointer */
154 short compare_ab_cfraPtr(void *node, void *data);
155
156 /* Checks if ActKeyBlock can be used (i.e. drawn/used to detect "holds") */
157 bool actkeyblock_is_valid(ActKeyBlock *ab, struct DLRBT_Tree *keys);
158
159 #endif  /*  __ED_KEYFRAMES_DRAW_H__ */