Merge branch 'blender2.7'
[blender.git] / source / blender / blenkernel / BKE_movieclip.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) 2011 Blender Foundation.
19  * All rights reserved.
20  *
21  * Contributor(s): Blender Foundation,
22  *                 Sergey Sharybin
23  *
24  * ***** END GPL LICENSE BLOCK *****
25  */
26
27 #ifndef __BKE_MOVIECLIP_H__
28 #define __BKE_MOVIECLIP_H__
29
30 /** \file BKE_movieclip.h
31  *  \ingroup bke
32  *  \author Sergey Sharybin
33  */
34
35 struct Depsgraph;
36 struct ImBuf;
37 struct Main;
38 struct MovieClip;
39 struct MovieClipScopes;
40 struct MovieClipUser;
41 struct MovieDistortion;
42
43 void BKE_movieclip_free(struct MovieClip *clip);
44
45 void BKE_movieclip_copy_data(struct Main *bmain, struct MovieClip *clip_dst, const struct MovieClip *clip_src, const int flag);
46 struct MovieClip *BKE_movieclip_copy(struct Main *bmain, const struct MovieClip *clip);
47 void BKE_movieclip_make_local(struct Main *bmain, struct MovieClip *clip, const bool lib_local);
48
49 struct MovieClip *BKE_movieclip_file_add(struct Main *bmain, const char *name);
50 struct MovieClip *BKE_movieclip_file_add_exists_ex(struct Main *bmain, const char *name, bool *r_exists);
51 struct MovieClip *BKE_movieclip_file_add_exists(struct Main *bmain, const char *name);
52 void BKE_movieclip_reload(struct Main *bmain, struct MovieClip *clip);
53 void BKE_movieclip_clear_cache(struct MovieClip *clip);
54 void BKE_movieclip_clear_proxy_cache(struct MovieClip *clip);
55
56 struct ImBuf *BKE_movieclip_get_ibuf(struct MovieClip *clip, struct MovieClipUser *user);
57 struct ImBuf *BKE_movieclip_get_postprocessed_ibuf(struct MovieClip *clip, struct MovieClipUser *user, int postprocess_flag);
58 struct ImBuf *BKE_movieclip_get_stable_ibuf(struct MovieClip *clip, struct MovieClipUser *user, float loc[2], float *scale, float *angle, int postprocess_flag);
59 struct ImBuf *BKE_movieclip_get_ibuf_flag(struct MovieClip *clip, struct MovieClipUser *user, int flag, int cache_flag);
60 void BKE_movieclip_get_size(struct MovieClip *clip, struct MovieClipUser *user, int *width, int *height);
61 void BKE_movieclip_get_size_fl(struct MovieClip *clip, struct MovieClipUser *user, float size[2]);
62 int  BKE_movieclip_get_duration(struct MovieClip *clip);
63 float BKE_movieclip_get_fps(struct MovieClip *clip);
64 void BKE_movieclip_get_aspect(struct MovieClip *clip, float *aspx, float *aspy);
65 bool BKE_movieclip_has_frame(struct MovieClip *clip, struct MovieClipUser *user);
66 void BKE_movieclip_user_set_frame(struct MovieClipUser *user, int framenr);
67
68 void BKE_movieclip_update_scopes(struct MovieClip *clip, struct MovieClipUser *user, struct MovieClipScopes *scopes);
69
70 void BKE_movieclip_get_cache_segments(struct MovieClip *clip, struct MovieClipUser *user, int *r_totseg, int **r_points);
71
72 void BKE_movieclip_build_proxy_frame(struct MovieClip *clip, int clip_flag, struct MovieDistortion *distortion,
73                                      int cfra, int *build_sizes, int build_count, bool undistorted);
74
75 void BKE_movieclip_build_proxy_frame_for_ibuf(struct MovieClip *clip, struct ImBuf *ibuf, struct MovieDistortion *distortion,
76                                               int cfra, int *build_sizes, int build_count, bool undistorted);
77
78 float BKE_movieclip_remap_scene_to_clip_frame(const struct MovieClip *clip, float framenr);
79 float BKE_movieclip_remap_clip_to_scene_frame(const struct MovieClip *clip, float framenr);
80
81 void BKE_movieclip_filename_for_frame(struct MovieClip *clip, struct MovieClipUser *user, char *name);
82 struct ImBuf *BKE_movieclip_anim_ibuf_for_frame(struct MovieClip *clip, struct MovieClipUser *user);
83
84 bool BKE_movieclip_has_cached_frame(struct MovieClip *clip, struct MovieClipUser *user);
85 bool BKE_movieclip_put_frame_if_possible(struct MovieClip *clip, struct MovieClipUser *user, struct ImBuf *ibuf);
86
87 /* Evaluation. */
88 void BKE_movieclip_eval_update(struct Depsgraph *depsgraph, struct MovieClip *clip);
89 void BKE_movieclip_eval_selection_update(struct Depsgraph *depsgraph, struct MovieClip *clip);
90
91 /* caching flags */
92 #define MOVIECLIP_CACHE_SKIP        (1 << 0)
93
94 /* postprocessing flags */
95 #define MOVIECLIP_DISABLE_RED       (1 << 0)
96 #define MOVIECLIP_DISABLE_GREEN     (1 << 1)
97 #define MOVIECLIP_DISABLE_BLUE      (1 << 2)
98 #define MOVIECLIP_PREVIEW_GRAYSCALE (1 << 3)
99
100 #endif