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 float 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