7b37702ecfcb6a3c01c67278df6a0edb0729ce4a
[blender.git] / source / blender / blenkernel / BKE_tracking.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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19  *
20  * The Original Code is Copyright (C) 2011 Blender Foundation.
21  * All rights reserved.
22  *
23  * Contributor(s): Blender Foundation,
24  *                 Sergey Sharybin
25  *
26  * ***** END GPL LICENSE BLOCK *****
27  */
28
29 #ifndef BKE_TRACKING_H
30 #define BKE_TRACKING_H
31
32 /** \file BKE_trackingp.h
33  *  \ingroup bke
34  *  \author Sergey Sharybin
35  */
36
37 struct ImBuf;
38 struct MovieTrackingTrack;
39 struct MovieTrackingMarker;
40 struct MovieTracking;
41 struct MovieTrackingContext;
42 struct MovieClipUser;
43 struct Scene;
44
45 void BKE_tracking_clamp_track(struct MovieTrackingTrack *track, int event);
46 void BKE_tracking_track_flag(struct MovieTrackingTrack *track, int area, int flag, int clear);
47 struct MovieTrackingTrack *BKE_tracking_add_track(struct MovieTracking *tracking, float x, float y,
48                         int framenr, int width, int height);
49 void BKE_tracking_insert_marker(struct MovieTrackingTrack *track, struct MovieTrackingMarker *marker);
50 void BKE_tracking_delete_marker(struct MovieTrackingTrack *track, int framenr);
51 struct MovieTrackingMarker *BKE_tracking_get_marker(struct MovieTrackingTrack *track, int framenr);
52 struct MovieTrackingMarker *BKE_tracking_ensure_marker(struct MovieTrackingTrack *track, int framenr);
53 struct MovieTrackingMarker *BKE_tracking_exact_marker(struct MovieTrackingTrack *track, int framenr);
54 int BKE_tracking_has_marker(struct MovieTrackingTrack *track, int framenr);
55
56 void BKE_tracking_free_track(struct MovieTrackingTrack *track);
57 struct MovieTrackingTrack *BKE_tracking_copy_track(struct MovieTrackingTrack *track);
58 void BKE_tracking_clear_path(struct MovieTrackingTrack *track, int ref_frame, int action);
59 int BKE_tracking_test_join_tracks(struct MovieTrackingTrack *dst_track, struct MovieTrackingTrack *src_track);
60 void BKE_tracking_join_tracks(struct MovieTrackingTrack *dst_track, struct MovieTrackingTrack *src_track);
61 void BKE_tracking_free(struct MovieTracking *tracking);
62
63 struct ImBuf *BKE_tracking_acquire_pattern_imbuf(struct ImBuf *ibuf, struct MovieTrackingTrack *track,
64                         struct MovieTrackingMarker *marker, int margin, float pos[2], int origin[2]);
65 struct ImBuf *BKE_tracking_acquire_search_imbuf(struct ImBuf *ibuf, struct MovieTrackingTrack *track,
66                         struct MovieTrackingMarker *marker, int margin, float pos[2], int origin[2]);
67
68 struct MovieTrackingContext *BKE_tracking_context_new(struct MovieClip *clip, struct MovieClipUser *user, int backwards);
69 void BKE_tracking_context_free(struct MovieTrackingContext *context);
70 void BKE_tracking_sync(struct MovieTrackingContext *context);
71 void BKE_tracking_sync_user(struct MovieClipUser *user, struct MovieTrackingContext *context);
72 int BKE_tracking_next(struct MovieTrackingContext *context);
73
74 void BKE_tracking_solve_reconstruction(struct MovieClip *clip);
75
76 void BKE_track_unique_name(struct MovieTracking *tracking, struct MovieTrackingTrack *track);
77 struct MovieTrackingTrack *BKE_find_track_by_name(struct MovieTracking *tracking, const char *name);
78
79 struct MovieReconstructedCamera *BKE_tracking_get_reconstructed_camera(struct MovieTracking *tracking, int framenr);
80
81 void BKE_get_tracking_mat(struct Scene *scene, float mat[4][4]);
82 void BKE_tracking_projection_matrix(struct MovieTracking *tracking, int framenr, int winx, int winy, float mat[4][4]);
83 void BKE_tracking_apply_intrinsics(struct MovieTracking *tracking, float co[2], float width, float height, float nco[2]);
84 void BKE_tracking_invert_intrinsics(struct MovieTracking *tracking, float co[2], float width, float height, float nco[2]);
85
86 void BKE_tracking_detect(struct MovieTracking *tracking, struct ImBuf *imbuf, int framenr);
87
88 struct MovieTrackingTrack *BKE_tracking_indexed_bundle(struct MovieTracking *tracking, int bundlenr);
89
90 void BKE_tracking_stabilization_matrix(struct MovieTracking *tracking, int framenr, int width, int height, float mat[4][4]);
91 struct ImBuf *BKE_tracking_stabilize_shot(struct MovieTracking *tracking, int framenr, struct ImBuf *ibuf, float mat[4][4]);
92
93 #define TRACK_SELECTED(track)                           (((track->flag&TRACK_HIDDEN)==0) && ((track)->flag&SELECT || (track)->pat_flag&SELECT || (track)->search_flag&SELECT))
94 #define TRACK_AREA_SELECTED(track, area)        (((track->flag&TRACK_HIDDEN)==0) && ((area)==TRACK_AREA_POINT?(track)->flag&SELECT : ((area)==TRACK_AREA_PAT?(track)->pat_flag&SELECT:(track)->search_flag&SELECT)))
95
96 #define MARKER_VISIBLE(sc, marker)                      (((marker)->flag&MARKER_DISABLED)==0 || ((sc)->flag&SC_HIDE_DISABLED)==0)
97
98 #define CLAMP_PAT_DIM           1
99 #define CLAMP_PAT_POS           2
100 #define CLAMP_SEARCH_DIM        3
101 #define CLAMP_SEARCH_POS        4
102
103 #define TRACK_AREA_NONE         -1
104 #define TRACK_AREA_POINT        1
105 #define TRACK_AREA_PAT          2
106 #define TRACK_AREA_SEARCH       4
107
108 #define TRACK_AREA_ALL          (TRACK_AREA_POINT|TRACK_AREA_PAT|TRACK_AREA_SEARCH)
109
110 #endif