2.5: Blender "Animato" - New Animation System
[blender.git] / source / blender / blenkernel / BKE_ipo.h
1 /**
2  * blenlib/BKE_ipo.h (mar-2001 nzc)
3  *      
4  * $Id$ 
5  *
6  * ***** BEGIN GPL LICENSE BLOCK *****
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License
10  * as published by the Free Software Foundation; either version 2
11  * of the License, or (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software Foundation,
20  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
21  *
22  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
23  * All rights reserved.
24  *
25  * The Original Code is: all of this file.
26  *
27  * Contributor(s): 2008, Joshua Leung (Animation Cleanup)
28  *
29  * ***** END GPL LICENSE BLOCK *****
30  */
31 #ifndef BKE_IPO_H
32 #define BKE_IPO_H
33
34 #ifdef __cplusplus
35 extern "C" {
36 #endif
37
38 #if 0 // XXX old animation system
39
40 typedef struct CfraElem {
41         struct CfraElem *next, *prev;
42         float cfra;
43         int sel;
44 } CfraElem;
45
46 struct Ipo;
47 struct IpoCurve;
48 struct MTex;
49 struct Material;
50 struct Scene;
51 struct Object;
52 struct Sequence;
53 struct ListBase;
54 struct BezTriple;
55 struct ID;
56 struct bPoseChannel;
57 struct bActionChannel;
58 struct rctf;
59
60 /* ------------ Time Management ------------ */
61
62 float frame_to_float(struct Scene *scene, int cfra);
63
64 /* ------------ IPO Management ---------- */
65
66 void free_ipo_curve(struct IpoCurve *icu);
67 void free_ipo(struct Ipo *ipo);
68
69 void ipo_default_v2d_cur(struct Scene *scene, int blocktype, struct rctf *cur);
70
71 struct Ipo *add_ipo(struct Scene *scene, char *name, int idcode);
72 struct Ipo *copy_ipo(struct Ipo *ipo);
73
74 void ipo_idnew(struct Ipo *ipo);
75
76 struct IpoCurve *find_ipocurve(struct Ipo *ipo, int adrcode);
77 short has_ipo_code(struct Ipo *ipo, int code);
78
79 /* -------------- Make Local -------------- */
80
81 void make_local_obipo(struct Ipo *ipo);
82 void make_local_matipo(struct Ipo *ipo);
83 void make_local_keyipo(struct Ipo *ipo);
84 void make_local_ipo(struct Ipo *ipo);
85
86 /* ------------ IPO-Curve Sanity ---------------- */
87
88 void calchandles_ipocurve(struct IpoCurve *icu);
89 void testhandles_ipocurve(struct IpoCurve *icu);
90 void sort_time_ipocurve(struct IpoCurve *icu);
91 int test_time_ipocurve(struct IpoCurve *icu);
92
93 void set_interpolation_ipocurve(struct IpoCurve *icu, short ipo);
94
95 /* -------- IPO-Curve (Bezier) Calculations ---------- */
96
97 void correct_bezpart(float *v1, float *v2, float *v3, float *v4);
98 int findzero(float x, float q0, float q1, float q2, float q3, float *o);
99 void berekeny(float f1, float f2, float f3, float f4, float *o, int b);
100 void berekenx(float *f, float *o, int b);
101
102 /* -------- IPO Curve Calculation and Evaluation --------- */
103
104 float eval_icu(struct IpoCurve *icu, float ipotime);
105 void calc_icu(struct IpoCurve *icu, float ctime);
106 float calc_ipo_time(struct Ipo *ipo, float ctime);
107 void calc_ipo(struct Ipo *ipo, float ctime);
108
109 void calc_ipo_range(struct Ipo *ipo, float *start, float *end);
110
111 /* ------------ Keyframe Column Tools -------------- */
112
113 void add_to_cfra_elem(struct ListBase *lb, struct BezTriple *bezt);
114 void make_cfra_list(struct Ipo *ipo, struct ListBase *elems);
115
116 /* ---------------- IPO DataAPI ----------------- */
117
118 void write_ipo_poin(void *poin, int type, float val);
119 float read_ipo_poin(void *poin, int type);
120
121 void *give_mtex_poin(struct MTex *mtex, int adrcode );
122 void *get_pchan_ipo_poin(struct bPoseChannel *pchan, int adrcode);
123 void *get_ipo_poin(struct ID *id, struct IpoCurve *icu, int *type);
124
125 void set_icu_vars(struct IpoCurve *icu);
126
127 /* ---------------- IPO Execution --------------- */
128
129 void execute_ipo(struct ID *id, struct Ipo *ipo);
130 void execute_action_ipo(struct bActionChannel *achan, struct bPoseChannel *pchan);
131
132 void do_ipo_nocalc(struct Scene *scene, struct Ipo *ipo);
133 void do_ipo(struct Scene *scene, struct Ipo *ipo);
134 void do_mat_ipo(struct Scene *scene, struct Material *ma);
135 void do_ob_ipo(struct Scene *scene, struct Object *ob);
136 void do_seq_ipo(struct Scene *scene, struct Sequence *seq, int cfra);
137 void do_ob_ipodrivers(struct Object *ob, struct Ipo *ipo, float ctime);
138
139 void do_all_data_ipos(struct Scene *scene);
140 short calc_ipo_spec(struct Ipo *ipo, int adrcode, float *ctime);
141 void clear_delta_obipo(struct Ipo *ipo);
142
143 /* ----------- IPO <-> GameEngine API ---------------- */
144
145 /* the short is an IPO_Channel... */
146
147 short IPO_GetChannels(struct Ipo *ipo, short *channels);
148 float IPO_GetFloatValue(struct Ipo *ipo, short c, float ctime);
149
150 #endif // XXX old animation system
151
152 #ifdef __cplusplus
153 };
154 #endif
155
156 #endif
157