#include <cstddef>
#include "MEM_guardedalloc.h"
#include "DNA_movieclip_types.h"
#include "BLI_ghash.h"
#include "BLI_listbase.h"
#include "BLI_math_color.h"
#include "BLI_math_vector.h"
#include "BLI_string.h"
#include "BLI_string_utils.hh"
#include "BLI_threads.h"
#include "BLI_utildefines.h"
#include "BLT_translation.hh"
#include "BKE_movieclip.h"
#include "BKE_tracking.h"
#include "IMB_imbuf.hh"
#include "IMB_imbuf_types.hh"
#include "tracking_private.h"
#include "libmv-capi.h"

Macros
#define	CACHE_PRINTF(...)

Functions
Tracks Map
TracksMap *	tracks_map_new (const char *object_name, int num_tracks)

int	tracks_map_get_size (TracksMap *map)

void	tracks_map_insert (TracksMap map, MovieTrackingTrack track)

void	tracks_map_merge (TracksMap map, MovieTracking tracking)

void	tracks_map_free (TracksMap *map)

Space Transformation Functions
static void	unified_to_pixel (int frame_width, int frame_height, const float unified_coords[2], float pixel_coords[2])

static void	marker_to_frame_unified (const MovieTrackingMarker *marker, const float marker_unified_coords[2], float frame_unified_coords[2])

static void	marker_unified_to_frame_pixel_coordinates (int frame_width, int frame_height, const MovieTrackingMarker *marker, const float marker_unified_coords[2], float frame_pixel_coords[2])

void	tracking_get_search_origin_frame_pixel (int frame_width, int frame_height, const MovieTrackingMarker *marker, float frame_pixel[2])

static void	pixel_to_unified (int frame_width, int frame_height, const float pixel_coords[2], float unified_coords[2])

static void	marker_unified_to_search_pixel (int frame_width, int frame_height, const MovieTrackingMarker *marker, const float marker_unified[2], float search_pixel[2])

static void	search_pixel_to_marker_unified (int frame_width, int frame_height, const MovieTrackingMarker *marker, const float search_pixel[2], float marker_unified[2])

void	tracking_get_marker_coords_for_tracking (int frame_width, int frame_height, const MovieTrackingMarker *marker, double search_pixel_x[5], double search_pixel_y[5])

void	tracking_set_marker_coords_from_tracking (int frame_width, int frame_height, MovieTrackingMarker *marker, const double search_pixel_x[5], const double search_pixel_y[5])

void	tracking_principal_point_normalized_to_pixel (const float principal_point_normalized[2], const int frame_width, const int frame_height, float r_principal_point_pixel[2])

void	tracking_principal_point_pixel_to_normalized (const float principal_point_pixel[2], const int frame_width, const int frame_height, float r_principal_point_normalized[2])

General Purpose Utility Functions
void	tracking_marker_insert_disabled (MovieTrackingTrack track, const MovieTrackingMarker ref_marker, bool before, bool overwrite)

static void	distortion_model_parameters_from_tracking (const MovieTrackingCamera camera, libmv_CameraIntrinsicsOptions camera_intrinsics_options)

static void	distortion_model_parameters_from_options (const libmv_CameraIntrinsicsOptions camera_intrinsics_options, MovieTrackingCamera camera)

void	tracking_cameraIntrinscisOptionsFromTracking (MovieTracking tracking, const int calibration_width, const int calibration_height, libmv_CameraIntrinsicsOptions camera_intrinsics_options)

void	tracking_trackingCameraFromIntrinscisOptions (MovieTracking tracking, const libmv_CameraIntrinsicsOptions camera_intrinsics_options)

MovieTrackingMarker *	tracking_get_keyframed_marker (MovieTrackingTrack *track, int current_frame, bool backwards)

Frame Accessor
static ImBuf *	accessor_get_preprocessed_ibuf (TrackingImageAccessor *accessor, int clip_index, int frame)

static ImBuf *	make_grayscale_ibuf_copy (ImBuf *ibuf)

static void	ibuf_to_float_image (const ImBuf ibuf, libmv_FloatImage float_image)

static ImBuf *	float_image_to_ibuf (libmv_FloatImage *float_image)

static ImBuf *	accessor_get_ibuf (TrackingImageAccessor accessor, int clip_index, int frame, libmv_InputMode input_mode, int downscale, const libmv_Region region, const libmv_FrameTransform *transform)

static libmv_CacheKey	accessor_get_image_callback (libmv_FrameAccessorUserData user_data, int clip_index, int frame, libmv_InputMode input_mode, int downscale, const libmv_Region region, const libmv_FrameTransform transform, float destination, int width, int height, int channels)

static void	accessor_release_image_callback (libmv_CacheKey cache_key)

static libmv_CacheKey	accessor_get_mask_for_track_callback (libmv_FrameAccessorUserData user_data, int clip_index, int frame, int track_index, const libmv_Region region, float *r_destination, int r_width, int *r_height)

static void	accessor_release_mask_callback (libmv_CacheKey cache_key)

TrackingImageAccessor *	tracking_image_accessor_new (MovieClip clips[MAX_ACCESSOR_CLIP], int num_clips, MovieTrackingTrack *tracks, int num_tracks)

void	tracking_image_accessor_destroy (TrackingImageAccessor *accessor)

Detailed Description

This file contains implementation of function which are used by multiple tracking files but which should not be public.

Definition in file tracking_util.cc.

Macro Definition Documentation

◆ CACHE_PRINTF

#define CACHE_PRINTF ( ... )

Definition at line 45 of file tracking_util.cc.

Referenced by accessor_get_ibuf().

Function Documentation

◆ accessor_get_ibuf()

static ImBuf * accessor_get_ibuf	(	TrackingImageAccessor *	accessor,
		int	clip_index,
		int	frame,
		libmv_InputMode	input_mode,
		int	downscale,
		const libmv_Region *	region,
		const libmv_FrameTransform *	transform )

static

◆ accessor_get_image_callback()

static libmv_CacheKey accessor_get_image_callback	(	libmv_FrameAccessorUserData *	user_data,
		int	clip_index,
		int	frame,
		libmv_InputMode	input_mode,
		int	downscale,
		const libmv_Region *	region,
		const libmv_FrameTransform *	transform,
		float **	destination,
		int *	width,
		int *	height,
		int *	channels )

static

Definition at line 788 of file tracking_util.cc.

References accessor_get_ibuf(), BLI_assert, ImBuf::channels, ImBufFloatBuffer::data, ImBuf::float_buffer, ImBuf::x, and ImBuf::y.

Referenced by tracking_image_accessor_new().

◆ accessor_get_mask_for_track_callback()

static libmv_CacheKey accessor_get_mask_for_track_callback	(	libmv_FrameAccessorUserData *	user_data,
		int	clip_index,
		int	frame,
		int	track_index,
		const libmv_Region *	region,
		float **	r_destination,
		int *	r_width,
		int *	r_height )

static

Definition at line 829 of file tracking_util.cc.

References MovieTrackingTrack::algorithm_flag, BKE_movieclip_get_size(), BKE_movieclip_remap_clip_to_scene_frame(), BKE_movieclip_user_set_frame(), BKE_tracking_marker_get_exact(), BLI_assert, TrackingImageAccessor::clips, MCLIP_PROXY_RENDER_SIZE_FULL, MovieTrackingMarker::pos, MovieClipUser::render_flag, MovieClipUser::render_size, TRACK_ALGORITHM_FLAG_USE_MASK, tracking_track_get_mask_for_region(), and TrackingImageAccessor::tracks.

Referenced by tracking_image_accessor_new().

◆ accessor_get_preprocessed_ibuf()

static ImBuf * accessor_get_preprocessed_ibuf	(	TrackingImageAccessor *	accessor,
		int	clip_index,
		int	frame )

static

Definition at line 595 of file tracking_util.cc.

References BKE_movieclip_get_ibuf(), BKE_movieclip_remap_clip_to_scene_frame(), BKE_movieclip_user_set_frame(), BLI_assert, TrackingImageAccessor::clips, MCLIP_PROXY_RENDER_SIZE_FULL, MovieClipUser::render_flag, and MovieClipUser::render_size.

Referenced by accessor_get_ibuf().

◆ accessor_release_image_callback()

static void accessor_release_image_callback ( libmv_CacheKey cache_key )

static

Definition at line 823 of file tracking_util.cc.

References IMB_freeImBuf().

Referenced by tracking_image_accessor_new().

◆ accessor_release_mask_callback()

static void accessor_release_mask_callback ( libmv_CacheKey cache_key )

static

Definition at line 876 of file tracking_util.cc.

References MEM_freeN().

Referenced by tracking_image_accessor_new().

◆ distortion_model_parameters_from_options()

static void distortion_model_parameters_from_options	(	const libmv_CameraIntrinsicsOptions *	camera_intrinsics_options,
		MovieTrackingCamera *	camera )

static

Definition at line 446 of file tracking_util.cc.

Referenced by tracking_trackingCameraFromIntrinscisOptions().

◆ distortion_model_parameters_from_tracking()

static void distortion_model_parameters_from_tracking	(	const MovieTrackingCamera *	camera,
		libmv_CameraIntrinsicsOptions *	camera_intrinsics_options )

static

Definition at line 401 of file tracking_util.cc.

Referenced by tracking_cameraIntrinscisOptionsFromTracking().

◆ float_image_to_ibuf()

static ImBuf * float_image_to_ibuf ( libmv_FloatImage * float_image )

static

Definition at line 652 of file tracking_util.cc.

References libmv_FloatImage::buffer, ImBuf::channels, libmv_FloatImage::channels, libmv_FloatImage::height, IB_TAKE_OWNERSHIP, IMB_allocImBuf(), IMB_assign_float_buffer(), libmv_FloatImage::width, ImBuf::x, and ImBuf::y.

Referenced by accessor_get_ibuf().

◆ ibuf_to_float_image()

static void ibuf_to_float_image	(	const ImBuf *	ibuf,
		libmv_FloatImage *	float_image )

static

Definition at line 643 of file tracking_util.cc.

References BLI_assert, libmv_FloatImage::buffer, ImBuf::channels, libmv_FloatImage::channels, ImBufFloatBuffer::data, ImBuf::float_buffer, libmv_FloatImage::height, libmv_FloatImage::width, ImBuf::x, and ImBuf::y.

Referenced by accessor_get_ibuf().

◆ make_grayscale_ibuf_copy()

static ImBuf * make_grayscale_ibuf_copy ( ImBuf * ibuf )

static

Definition at line 616 of file tracking_util.cc.

References BLI_assert, ImBuf::channels, ImBufFloatBuffer::data, ELEM, ImBuf::float_buffer, IB_TAKE_OWNERSHIP, IMB_allocImBuf(), IMB_assign_float_buffer(), ImBuf::x, and ImBuf::y.

Referenced by accessor_get_ibuf().

◆ marker_to_frame_unified()

static void marker_to_frame_unified	(	const MovieTrackingMarker *	marker,
		const float	marker_unified_coords[2],
		float	frame_unified_coords[2] )

static

Definition at line 214 of file tracking_util.cc.

References MovieTrackingMarker::pos.

Referenced by marker_unified_to_frame_pixel_coordinates().

◆ marker_unified_to_frame_pixel_coordinates()

static void marker_unified_to_frame_pixel_coordinates	(	int	frame_width,
		int	frame_height,
		const MovieTrackingMarker *	marker,
		const float	marker_unified_coords[2],
		float	frame_pixel_coords[2] )

static

Definition at line 222 of file tracking_util.cc.

References marker_to_frame_unified(), and unified_to_pixel().

Referenced by marker_unified_to_search_pixel(), and tracking_get_search_origin_frame_pixel().

◆ marker_unified_to_search_pixel()

static void marker_unified_to_search_pixel	(	int	frame_width,
		int	frame_height,
		const MovieTrackingMarker *	marker,
		const float	marker_unified[2],
		float	search_pixel[2] )

static

Definition at line 253 of file tracking_util.cc.

References marker_unified_to_frame_pixel_coordinates(), sub_v2_v2v2(), and tracking_get_search_origin_frame_pixel().

Referenced by tracking_get_marker_coords_for_tracking().

◆ pixel_to_unified()

static void pixel_to_unified	(	int	frame_width,
		int	frame_height,
		const float	pixel_coords[2],
		float	unified_coords[2] )

static

Definition at line 244 of file tracking_util.cc.

Referenced by search_pixel_to_marker_unified().

◆ search_pixel_to_marker_unified()

static void search_pixel_to_marker_unified	(	int	frame_width,
		int	frame_height,
		const MovieTrackingMarker *	marker,
		const float	search_pixel[2],
		float	marker_unified[2] )

static

Definition at line 269 of file tracking_util.cc.

References add_v2_v2v2(), pixel_to_unified(), MovieTrackingMarker::pos, sub_v2_v2v2(), and tracking_get_search_origin_frame_pixel().

Referenced by tracking_set_marker_coords_from_tracking().

◆ tracking_cameraIntrinscisOptionsFromTracking()

void tracking_cameraIntrinscisOptionsFromTracking	(	struct MovieTracking *	tracking,
		int	calibration_width,
		int	calibration_height,
		struct libmv_CameraIntrinsicsOptions *	camera_intrinsics_options )

Fill in Libmv C-API camera intrinsics options from tracking structure.

Definition at line 484 of file tracking_util.cc.

References BLI_system_thread_count(), distortion_model_parameters_from_tracking(), libmv_CameraIntrinsicsOptions::focal_length, libmv_CameraIntrinsicsOptions::image_height, libmv_CameraIntrinsicsOptions::image_width, int, libmv_CameraIntrinsicsOptions::num_threads, MovieTrackingCamera::pixel_aspect, libmv_CameraIntrinsicsOptions::principal_point_x, libmv_CameraIntrinsicsOptions::principal_point_y, and tracking_principal_point_normalized_to_pixel().

Referenced by BKE_tracking_distort_v2(), BKE_tracking_distortion_new(), BKE_tracking_distortion_update(), BKE_tracking_reconstruction_context_new(), and BKE_tracking_undistort_v2().

◆ tracking_get_keyframed_marker()

MovieTrackingMarker * tracking_get_keyframed_marker	(	struct MovieTrackingTrack *	track,
		int	current_frame,
		bool	backwards )

Get previous keyframed marker.

Definition at line 530 of file tracking_util.cc.

References BKE_tracking_marker_get(), MovieTrackingMarker::flag, MARKER_DISABLED, MARKER_TRACKED, MovieTrackingTrack::markers, and next.

Referenced by dna_marker_to_libmv_marker(), and tracking_context_get_keyframed_ibuf().

◆ tracking_get_marker_coords_for_tracking()

void tracking_get_marker_coords_for_tracking	(	int	frame_width,
		int	frame_height,
		const MovieTrackingMarker *	marker,
		double	search_pixel_x[5],
		double	search_pixel_y[5] )

Definition at line 287 of file tracking_util.cc.

References marker_unified_to_search_pixel(), and MovieTrackingMarker::pattern_corners.

Referenced by BKE_tracking_sample_pattern(), and configure_and_run_tracker().

◆ tracking_get_search_origin_frame_pixel()

void tracking_get_search_origin_frame_pixel	(	int	frame_width,
		int	frame_height,
		const MovieTrackingMarker *	marker,
		float	frame_pixel[2] )

Definition at line 232 of file tracking_util.cc.

References int, marker_unified_to_frame_pixel_coordinates(), and MovieTrackingMarker::search_min.

Referenced by BKE_tracking_get_search_imbuf(), marker_unified_to_search_pixel(), and search_pixel_to_marker_unified().

◆ tracking_image_accessor_destroy()

void tracking_image_accessor_destroy ( TrackingImageAccessor * accessor )

Definition at line 911 of file tracking_util.cc.

References BLI_spin_end(), TrackingImageAccessor::cache_lock, TrackingImageAccessor::libmv_accessor, libmv_FrameAccessorDestroy(), MEM_freeN(), and TrackingImageAccessor::tracks.

Referenced by BKE_autotrack_context_free().

◆ tracking_image_accessor_new()

TrackingImageAccessor * tracking_image_accessor_new	(	MovieClip *	clips[MAX_ACCESSOR_CLIP],
		int	num_clips,
		MovieTrackingTrack **	tracks,
		int	num_tracks )

Clips are used to access images of an actual footage. Tracks are used to access masks associated with the tracks.

Note: Both clips and tracks arrays are copied into the image accessor. It means that the caller is allowed to pass temporary arrays which are only valid during initialization.

Definition at line 884 of file tracking_util.cc.

References accessor_get_image_callback(), accessor_get_mask_for_track_callback(), accessor_release_image_callback(), accessor_release_mask_callback(), BLI_assert, BLI_spin_init(), TrackingImageAccessor::cache_lock, TrackingImageAccessor::clips, TrackingImageAccessor::libmv_accessor, libmv_FrameAccessorNew(), MAX_ACCESSOR_CLIP, TrackingImageAccessor::num_clips, TrackingImageAccessor::num_tracks, and TrackingImageAccessor::tracks.

Referenced by autotrack_context_init_image_accessor().

◆ tracking_marker_insert_disabled()

void tracking_marker_insert_disabled	(	MovieTrackingTrack *	track,
		const MovieTrackingMarker *	ref_marker,
		bool	before,
		bool	overwrite )

Definition at line 378 of file tracking_util.cc.

References BKE_tracking_marker_insert(), BKE_tracking_track_has_marker_at_frame(), MovieTrackingMarker::flag, MovieTrackingMarker::framenr, and MARKER_DISABLED.

Referenced by BKE_autotrack_context_sync(), path_clear_all(), path_clear_remained(), and path_clear_up_to().

◆ tracking_principal_point_normalized_to_pixel()

void tracking_principal_point_normalized_to_pixel	(	const float	principal_point_normalized[2],
		int	frame_width,
		int	frame_height,
		float	r_principal_point_pixel[2] )

Convert the lens principal point (optical center) between normalized and pixel spaces.

The normalized space stores principal point relative to the frame center which has normalized principal coordinate of (0, 0). The right top corner of the frame corresponds to a normalized principal coordinate of (1, 1), and the left bottom corner corresponds to coordinate of (-1, -1).

The pixel space is measured in pixels, with the reference being the left bottom corner of the frame.

Definition at line 348 of file tracking_util.cc.

References float.

Referenced by BKE_tracking_camera_principal_point_pixel_get(), BKE_tracking_camera_shift_get(), BKE_tracking_distort_v2(), BKE_tracking_distortion_new(), BKE_tracking_distortion_update(), BKE_tracking_undistort_v2(), and tracking_cameraIntrinscisOptionsFromTracking().

◆ tracking_principal_point_pixel_to_normalized()

void tracking_principal_point_pixel_to_normalized	(	const float	principal_point_pixel[2],
		const int	frame_width,
		const int	frame_height,
		float	r_principal_point_normalized[2] )

Definition at line 360 of file tracking_util.cc.

References float.

Referenced by BKE_tracking_camera_principal_point_pixel_set(), and tracking_trackingCameraFromIntrinscisOptions().

◆ tracking_set_marker_coords_from_tracking()

void tracking_set_marker_coords_from_tracking	(	int	frame_width,
		int	frame_height,
		struct MovieTrackingMarker *	marker,
		const double	search_pixel_x[5],
		const double	search_pixel_y[5] )