#include <climits>
#include "DNA_movieclip_types.h"
#include "DNA_scene_types.h"
#include "RNA_prototypes.hh"
#include "BLI_ghash.h"
#include "BLI_listbase.h"
#include "BLI_math_geom.h"
#include "BLI_math_rotation.h"
#include "BLI_math_vector.h"
#include "BLI_sort_utils.h"
#include "BLI_task.h"
#include "BLI_utildefines.h"
#include "BKE_fcurve.hh"
#include "BKE_movieclip.h"
#include "BKE_tracking.h"
#include "IMB_colormanagement.hh"
#include "IMB_imbuf.hh"
#include "IMB_imbuf_types.hh"
#include "IMB_interp.hh"
#include "MEM_guardedalloc.h"

Classes
struct	TrackStabilizationBase

struct	TrackInitOrder

struct	StabContext

struct	TrackingStabilizeFrameInterpolationData

Functions
static TrackStabilizationBase *	access_stabilization_baseline_data (StabContext ctx, MovieTrackingTrack track)

static void	attach_stabilization_baseline_data (StabContext ctx, MovieTrackingTrack track, TrackStabilizationBase *private_data)

static void	discard_stabilization_baseline_data (void *val)

static FCurve *	retrieve_stab_animation (MovieClip clip, const char data_path, int idx)

static FCurve *	retrieve_track_weight_animation (MovieClip clip, MovieTrackingTrack track)

static float	fetch_from_fcurve (const FCurve animationCurve, int framenr, StabContext ctx, float default_value)

static float	get_animated_locinf (StabContext *ctx, int framenr)

static float	get_animated_rotinf (StabContext *ctx, int framenr)

static float	get_animated_scaleinf (StabContext *ctx, int framenr)

static void	get_animated_target_pos (StabContext *ctx, int framenr, float target_pos[2])

static float	get_animated_target_rot (StabContext *ctx, int framenr)

static float	get_animated_target_scale (StabContext *ctx, int framenr)

static float	get_animated_weight (StabContext ctx, MovieTrackingTrack track, int framenr)

static void	use_values_from_fcurves (StabContext *ctx, bool toggle)

static StabContext *	init_stabilization_working_context (MovieClip *clip)

static void	discard_stabilization_working_context (StabContext *ctx)

static bool	is_init_for_stabilization (StabContext ctx, MovieTrackingTrack track)

static bool	is_usable_for_stabilization (StabContext ctx, MovieTrackingTrack track)

static bool	is_effectively_disabled (StabContext ctx, MovieTrackingTrack track, MovieTrackingMarker *marker)

static int	search_closest_marker_index (MovieTrackingTrack *track, int ref_frame)

static void	retrieve_next_higher_usable_frame (StabContext ctx, MovieTrackingTrack track, int i, int ref_frame, int *next_higher)

static void	retrieve_next_lower_usable_frame (StabContext ctx, MovieTrackingTrack track, int i, int ref_frame, int *next_lower)

static void	find_next_working_frames (StabContext ctx, int framenr, int next_lower, int *next_higher)

static MovieTrackingMarker *	get_closest_marker (StabContext ctx, MovieTrackingTrack track, int ref_frame)

static MovieTrackingMarker *	get_tracking_data_point (StabContext ctx, MovieTrackingTrack track, int framenr, float *r_weight)

static void	setup_pivot (const float ref_pos[2], float r_pivot[2])

static void	translation_contribution (TrackStabilizationBase track_ref, MovieTrackingMarker marker, float result_offset[2])

static float	rotation_contribution (TrackStabilizationBase track_ref, MovieTrackingMarker marker, const float aspect, const float pivot[2], float result_angle, float result_scale)

static void	compensate_rotation_center (const int size, float aspect, const float angle, const float scale, const float pivot[2], float result_translation[2])

static bool	average_track_contributions (StabContext ctx, int framenr, float aspect, float r_translation[2], float r_pivot[2], float r_angle, float *r_scale_step)

static void	average_marker_positions (StabContext *ctx, int framenr, float r_ref_pos[2])

static bool	interpolate_averaged_track_contributions (StabContext ctx, int framenr, int frame_a, int frame_b, const float aspect, float r_translation[2], float r_pivot[2], float r_angle, float *r_scale_step)

static int	establish_track_initialization_order (StabContext ctx, TrackInitOrder order)

static void	init_track_for_stabilization (StabContext ctx, MovieTrackingTrack track, int reference_frame, float aspect, const float average_translation[2], const float pivot[2], const float average_angle, const float average_scale_step)

static void	init_all_tracks (StabContext *ctx, float aspect)

static bool	stabilization_determine_offset_for_frame (StabContext ctx, int framenr, float aspect, float r_translation[2], float r_pivot[2], float r_angle, float *r_scale_step)

static void	stabilization_calculate_data (StabContext ctx, int framenr, int size, float aspect, bool do_compensate, float scale_step, float r_translation[2], float r_pivot[2], float r_scale, float *r_angle)

static void	stabilization_data_to_mat4 (float pixel_aspect, const float pivot[2], const float translation[2], float scale, float angle, float r_mat[4][4])

static float	calculate_autoscale_factor (StabContext *ctx, int size, float aspect)

static StabContext *	init_stabilizer (MovieClip *clip, int size, float aspect)

void	BKE_tracking_stabilization_data_get (MovieClip clip, int framenr, int width, int height, float translation[2], float scale, float *angle)

static void	tracking_stabilize_frame_interpolation_cb (void __restrict userdata, const int y, const TaskParallelTLS __restrict)

ImBuf *	BKE_tracking_stabilize_frame (MovieClip clip, int framenr, ImBuf ibuf, float translation[2], float scale, float angle)

void	BKE_tracking_stabilization_data_to_mat4 (int buffer_width, int buffer_height, float pixel_aspect, float translation[2], float scale, float angle, float r_mat[4][4])

Variables
static float	SCALE_ERROR_LIMIT_BIAS = 0.01f

static float	EPSILON_WEIGHT = 0.005f

Detailed Description

This file contains implementation of 2D image stabilization.

Definition in file tracking_stabilize.cc.

Function Documentation

◆ access_stabilization_baseline_data()

static TrackStabilizationBase * access_stabilization_baseline_data	(	StabContext *	ctx,
		MovieTrackingTrack *	track )

static

Definition at line 103 of file tracking_stabilize.cc.

References BLI_ghash_lookup(), and StabContext::private_track_data.

Referenced by average_track_contributions(), get_animated_weight(), init_all_tracks(), init_track_for_stabilization(), and is_init_for_stabilization().

◆ attach_stabilization_baseline_data()

static void attach_stabilization_baseline_data	(	StabContext *	ctx,
		MovieTrackingTrack *	track,
		TrackStabilizationBase *	private_data )

static

Definition at line 109 of file tracking_stabilize.cc.

References BLI_ghash_insert(), and StabContext::private_track_data.

Referenced by init_all_tracks().

◆ average_marker_positions()

static void average_marker_positions	(	StabContext *	ctx,
		int	framenr,
		float	r_ref_pos[2] )

static

◆ average_track_contributions()

static bool average_track_contributions	(	StabContext *	ctx,
		int	framenr,
		float	aspect,
		float	r_translation[2],
		float	r_pivot[2],
		float *	r_angle,
		float *	r_scale_step )

static

◆ BKE_tracking_stabilization_data_get()

void BKE_tracking_stabilization_data_get	(	struct MovieClip *	clip,
		int	framenr,
		int	width,
		int	height,
		float	translation[2],
		float *	scale,
		float *	angle )

Get stabilization data (translation, scaling and angle) for a given frame. Returned data describes how to compensate the detected movement, but with any chosen scale factor already applied and any target frame position already compensated. In case stabilization fails or is disabled, neutral values are returned.

Parameters

framenr	is a frame number, relative to the clip (not relative to the scene timeline).
width	is an effective width of the canvas (square pixels), used to scale the determined translation.

Outputs:

Parameters

translation	of the lateral shift, absolute canvas coordinates (square pixels).
scale	of the scaling to apply.
angle	of the rotation angle, relative to the frame center.

TODO(sergey): Use r_ prefix for output parameters here.

Definition at line 1250 of file tracking_stabilize.cc.

References MovieTracking::camera, compensate_rotation_center(), discard_stabilization_working_context(), float, init_stabilizer(), MovieTrackingCamera::pixel_aspect, stabilization_calculate_data(), stabilization_determine_offset_for_frame(), TRACKING_2D_STABILIZATION, and zero_v2().

Referenced by BKE_tracking_stabilize_frame(), blender::nodes::node_composite_movieclip_cc::MovieClipOperation::compute_stabilization_data(), blender::compositor::MovieClipNode::convert_to_operations(), blender::nodes::node_composite_stabilize2d_cc::Stabilize2DOperation::execute(), and get_stable_cached_frame().

◆ BKE_tracking_stabilization_data_to_mat4()

void BKE_tracking_stabilization_data_to_mat4	(	int	width,
		int	height,
		float	aspect,
		float	translation[2],
		float	scale,
		float	angle,
		float	mat[4][4] )

Build a 4x4 transformation matrix based on the given 2D stabilization data. mat is a 4x4 matrix in homogeneous coordinates, adapted to the final image buffer size and compensated for pixel aspect ratio, ready for direct OpenGL drawing.

TODO(sergey): The signature of this function should be changed. we actually don't need the dimensions of the image buffer. Instead we should consider to provide the pivot point of the rotation as a further stabilization data parameter.

Definition at line 1454 of file tracking_stabilize.cc.

References stabilization_data_to_mat4().

Referenced by BKE_tracking_stabilize_frame(), and clip_draw_main().

◆ BKE_tracking_stabilize_frame()

ImBuf * BKE_tracking_stabilize_frame	(	struct MovieClip *	clip,
		int	framenr,
		struct ImBuf *	ibuf,
		float	translation[2],
		float *	scale,
		float *	angle )

Stabilize given image buffer using stabilization data for a specified frame number.

Note: frame number should be in clip space, not scene space.

TODO(sergey): Use r_ prefix for output parameters here.

Definition at line 1364 of file tracking_stabilize.cc.

References BKE_tracking_stabilization_data_get(), BKE_tracking_stabilization_data_to_mat4(), BLI_parallel_range_settings_defaults(), BLI_task_parallel_range(), ImBuf::byte_buffer, copy_v2_v2(), ImBufByteBuffer::data, ImBufFloatBuffer::data, MovieTrackingStabilization::flag, ImBuf::float_buffer, IB_rect, IB_RECT_INVALID, IB_rectfloat, TrackingStabilizeFrameInterpolationData::ibuf, IMB_allocImBuf(), IMB_colormanagegent_copy_settings(), invert_m4(), ImBuf::planes, TRACKING_2D_STABILIZATION, tracking_stabilize_frame_interpolation_cb(), ImBuf::userflags, ImBuf::x, ImBuf::y, and zero_v2().

Referenced by put_stabilized_frame_to_cache().

◆ calculate_autoscale_factor()

static float calculate_autoscale_factor	(	StabContext *	ctx,
		int	size,
		float	aspect )

static

◆ compensate_rotation_center()

static void compensate_rotation_center	(	const int	size,
		float	aspect,
		const float	angle,
		const float	scale,
		const float	pivot[2],
		float	result_translation[2] )

static

Definition at line 476 of file tracking_stabilize.cc.

References add_v2_v2(), angle_to_mat2(), copy_v2_v2(), mul_m2_v2(), mul_v2_fl(), size(), and sub_v2_v2().

Referenced by BKE_tracking_stabilization_data_get().

◆ discard_stabilization_baseline_data()

static void discard_stabilization_baseline_data ( void * val )

static

Definition at line 116 of file tracking_stabilize.cc.

References MEM_freeN().

Referenced by discard_stabilization_working_context().

◆ discard_stabilization_working_context()

static void discard_stabilization_working_context ( StabContext * ctx )

static

Discard all private working data attached to this call context.

Note: We allocate the record for the per track baseline contribution locally for each call context (i.e. call to BKE_tracking_stabilization_data_get) Thus it is correct to discard all allocations found within the corresponding local GHash.

Definition at line 230 of file tracking_stabilize.cc.

References BLI_ghash_free(), discard_stabilization_baseline_data(), MEM_freeN(), and StabContext::private_track_data.

Referenced by BKE_tracking_stabilization_data_get().

◆ establish_track_initialization_order()

static int establish_track_initialization_order	(	StabContext *	ctx,
		TrackInitOrder *	order )

static

Definition at line 742 of file tracking_stabilize.cc.

References abs(), BKE_tracking_object_get_camera(), BLI_sortutil_cmp_int(), MovieTrackingMarker::framenr, get_closest_marker(), LISTBASE_FOREACH, TRACK_USE_2D_STAB, TRACK_USE_2D_STAB_ROT, StabContext::tracking, and MovieTrackingObject::tracks.

Referenced by init_all_tracks().

◆ fetch_from_fcurve()

static float fetch_from_fcurve	(	const FCurve *	animationCurve,
		int	framenr,
		StabContext *	ctx,
		float	default_value )

static

Definition at line 140 of file tracking_stabilize.cc.

References BKE_movieclip_remap_clip_to_scene_frame(), StabContext::clip, evaluate_fcurve(), and StabContext::use_animation.

Referenced by get_animated_locinf(), get_animated_rotinf(), get_animated_scaleinf(), get_animated_target_pos(), get_animated_target_rot(), and get_animated_target_scale().

◆ find_next_working_frames()

static void find_next_working_frames	(	StabContext *	ctx,
		int	framenr,
		int *	next_lower,
		int *	next_higher )

static

Definition at line 303 of file tracking_stabilize.cc.

References BKE_tracking_object_get_camera(), is_usable_for_stabilization(), LISTBASE_FOREACH, retrieve_next_higher_usable_frame(), retrieve_next_lower_usable_frame(), search_closest_marker_index(), StabContext::tracking, and MovieTrackingObject::tracks.

Referenced by stabilization_determine_offset_for_frame().

◆ get_animated_locinf()

static float get_animated_locinf	(	StabContext *	ctx,
		int	framenr )

static

Definition at line 152 of file tracking_stabilize.cc.

References fetch_from_fcurve(), MovieTrackingStabilization::locinf, StabContext::locinf, and StabContext::stab.

Referenced by stabilization_calculate_data().

◆ get_animated_rotinf()

static float get_animated_rotinf	(	StabContext *	ctx,
		int	framenr )

static

Definition at line 157 of file tracking_stabilize.cc.

References fetch_from_fcurve(), MovieTrackingStabilization::rotinf, StabContext::rotinf, and StabContext::stab.

Referenced by stabilization_calculate_data().

◆ get_animated_scaleinf()

static float get_animated_scaleinf	(	StabContext *	ctx,
		int	framenr )

static

Definition at line 162 of file tracking_stabilize.cc.

References fetch_from_fcurve(), MovieTrackingStabilization::scaleinf, StabContext::scaleinf, and StabContext::stab.

Referenced by stabilization_calculate_data().

◆ get_animated_target_pos()

static void get_animated_target_pos	(	StabContext *	ctx,
		int	framenr,
		float	target_pos[2] )

static

Definition at line 167 of file tracking_stabilize.cc.

References fetch_from_fcurve(), StabContext::stab, MovieTrackingStabilization::target_pos, and StabContext::target_pos.

Referenced by stabilization_calculate_data().

◆ get_animated_target_rot()

static float get_animated_target_rot	(	StabContext *	ctx,
		int	framenr )

static

Definition at line 173 of file tracking_stabilize.cc.

References fetch_from_fcurve(), StabContext::stab, MovieTrackingStabilization::target_rot, and StabContext::target_rot.

Referenced by stabilization_calculate_data().

◆ get_animated_target_scale()

static float get_animated_target_scale	(	StabContext *	ctx,
		int	framenr )

static

Definition at line 178 of file tracking_stabilize.cc.

References fetch_from_fcurve(), MovieTrackingStabilization::scale, StabContext::stab, and StabContext::target_scale.

Referenced by stabilization_calculate_data().

◆ get_animated_weight()

static float get_animated_weight	(	StabContext *	ctx,
		MovieTrackingTrack *	track,
		int	framenr )

static

Definition at line 183 of file tracking_stabilize.cc.

References access_stabilization_baseline_data(), BKE_movieclip_remap_clip_to_scene_frame(), StabContext::clip, evaluate_fcurve(), TrackStabilizationBase::track_weight_curve, and MovieTrackingTrack::weight_stab.

Referenced by get_tracking_data_point(), and is_effectively_disabled().

◆ get_closest_marker()

static MovieTrackingMarker * get_closest_marker	(	StabContext *	ctx,
		MovieTrackingTrack *	track,
		int	ref_frame )

static

Definition at line 320 of file tracking_stabilize.cc.

References BKE_tracking_marker_get_exact(), MAXFRAME, MINAFRAME, retrieve_next_higher_usable_frame(), retrieve_next_lower_usable_frame(), and search_closest_marker_index().

Referenced by establish_track_initialization_order().

◆ get_tracking_data_point()

static MovieTrackingMarker * get_tracking_data_point	(	StabContext *	ctx,
		MovieTrackingTrack *	track,
		int	framenr,
		float *	r_weight )

static

Definition at line 342 of file tracking_stabilize.cc.

References BKE_tracking_marker_get_exact(), MovieTrackingMarker::flag, get_animated_weight(), and MARKER_DISABLED.

Referenced by average_marker_positions(), and average_track_contributions().

◆ init_all_tracks()

static void init_all_tracks	(	StabContext *	ctx,
		float	aspect )

static

◆ init_stabilization_working_context()

static StabContext * init_stabilization_working_context ( MovieClip * clip )

static

Definition at line 204 of file tracking_stabilize.cc.

References BLI_ghash_ptr_new(), StabContext::clip, StabContext::locinf, StabContext::private_track_data, retrieve_stab_animation(), StabContext::rotinf, StabContext::scaleinf, StabContext::stab, StabContext::target_pos, StabContext::target_rot, StabContext::target_scale, StabContext::tracking, and StabContext::use_animation.

Referenced by init_stabilizer().

◆ init_stabilizer()

static StabContext * init_stabilizer	(	MovieClip *	clip,
		int	size,
		float	aspect )

static

Definition at line 1234 of file tracking_stabilize.cc.

References BLI_assert, calculate_autoscale_factor(), MovieTrackingStabilization::flag, init_all_tracks(), init_stabilization_working_context(), MovieTrackingStabilization::scale, StabContext::stab, TRACKING_AUTOSCALE, and use_values_from_fcurves().

Referenced by BKE_tracking_stabilization_data_get().

◆ init_track_for_stabilization()

static void init_track_for_stabilization	(	StabContext *	ctx,
		MovieTrackingTrack *	track,
		int	reference_frame,
		float	aspect,
		const float	average_translation[2],
		const float	pivot[2],
		const float	average_angle,
		const float	average_scale_step )

static

◆ interpolate_averaged_track_contributions()

static bool interpolate_averaged_track_contributions	(	StabContext *	ctx,
		int	framenr,
		int	frame_a,
		int	frame_b,
		const float	aspect,
		float	r_translation[2],
		float	r_pivot[2],
		float *	r_angle,
		float *	r_scale_step )

static

Definition at line 685 of file tracking_stabilize.cc.

References average_track_contributions(), BLI_assert, float, and interp_v2_v2v2().

Referenced by stabilization_determine_offset_for_frame().

◆ is_effectively_disabled()

static bool is_effectively_disabled	(	StabContext *	ctx,
		MovieTrackingTrack *	track,
		MovieTrackingMarker *	marker )

static

Definition at line 249 of file tracking_stabilize.cc.

References EPSILON_WEIGHT, MovieTrackingMarker::flag, MovieTrackingMarker::framenr, get_animated_weight(), and MARKER_DISABLED.

Referenced by retrieve_next_higher_usable_frame(), and retrieve_next_lower_usable_frame().

◆ is_init_for_stabilization()

static bool is_init_for_stabilization	(	StabContext *	ctx,
		MovieTrackingTrack *	track )

static

Definition at line 238 of file tracking_stabilize.cc.

References access_stabilization_baseline_data(), and TrackStabilizationBase::is_init_for_stabilization.

Referenced by average_track_contributions(), and is_usable_for_stabilization().

◆ is_usable_for_stabilization()

static bool is_usable_for_stabilization	(	StabContext *	ctx,
		MovieTrackingTrack *	track )

static

Definition at line 244 of file tracking_stabilize.cc.

References MovieTrackingTrack::flag, is_init_for_stabilization(), and TRACK_USE_2D_STAB.

Referenced by find_next_working_frames().

◆ retrieve_next_higher_usable_frame()

static void retrieve_next_higher_usable_frame	(	StabContext *	ctx,
		MovieTrackingTrack *	track,
		int	i,
		int	ref_frame,
		int *	next_higher )

static

Definition at line 263 of file tracking_stabilize.cc.

References BLI_assert, is_effectively_disabled(), markers, MovieTrackingTrack::markers, and MovieTrackingTrack::markersnr.

Referenced by average_marker_positions(), find_next_working_frames(), and get_closest_marker().

◆ retrieve_next_lower_usable_frame()

static void retrieve_next_lower_usable_frame	(	StabContext *	ctx,
		MovieTrackingTrack *	track,
		int	i,
		int	ref_frame,
		int *	next_lower )

static

Definition at line 281 of file tracking_stabilize.cc.

References BLI_assert, is_effectively_disabled(), markers, and MovieTrackingTrack::markers.

Referenced by average_marker_positions(), find_next_working_frames(), and get_closest_marker().

◆ retrieve_stab_animation()

static FCurve * retrieve_stab_animation	(	MovieClip *	clip,
		const char *	data_path,
		int	idx )

static

Definition at line 125 of file tracking_stabilize.cc.

References id_data_find_fcurve().

Referenced by init_stabilization_working_context().

◆ retrieve_track_weight_animation()

static FCurve * retrieve_track_weight_animation	(	MovieClip *	clip,
		MovieTrackingTrack *	track )

static

Definition at line 135 of file tracking_stabilize.cc.

References id_data_find_fcurve().

Referenced by init_all_tracks().

◆ rotation_contribution()

static float rotation_contribution	(	TrackStabilizationBase *	track_ref,
		MovieTrackingMarker *	marker,
		const float	aspect,
		const float	pivot[2],
		float *	result_angle,
		float *	result_scale )

static

Definition at line 439 of file tracking_stabilize.cc.

References atan2f, BLI_assert, expf, len, len_v2(), mul_m2_v2(), MovieTrackingMarker::pos, pos, SCALE_ERROR_LIMIT_BIAS, TrackStabilizationBase::stabilization_rotation_base, TrackStabilizationBase::stabilization_scale_base, and sub_v2_v2v2().

Referenced by average_track_contributions().

◆ search_closest_marker_index()

static int search_closest_marker_index	(	MovieTrackingTrack *	track,
		int	ref_frame )

static

Definition at line 257 of file tracking_stabilize.cc.

References BKE_tracking_marker_get(), and MovieTrackingTrack::markers.

Referenced by average_marker_positions(), find_next_working_frames(), and get_closest_marker().

◆ setup_pivot()

static void setup_pivot	(	const float	ref_pos[2],
		float	r_pivot[2] )

static

Definition at line 373 of file tracking_stabilize.cc.

References add_v2_v2(), and zero_v2().

Referenced by average_track_contributions(), and init_all_tracks().

◆ stabilization_calculate_data()

static void stabilization_calculate_data	(	StabContext *	ctx,
		int	framenr,
		int	size,
		float	aspect,
		bool	do_compensate,
		float	scale_step,
		float	r_translation[2],
		float	r_pivot[2],
		float *	r_scale,
		float *	r_angle )

static

Definition at line 1006 of file tracking_stabilize.cc.

References expf, MovieTrackingStabilization::flag, float, get_animated_locinf(), get_animated_rotinf(), get_animated_scaleinf(), get_animated_target_pos(), get_animated_target_rot(), get_animated_target_scale(), mul_v2_fl(), StabContext::stab, sub_v2_v2(), and TRACKING_STABILIZE_SCALE.

Referenced by BKE_tracking_stabilization_data_get(), and calculate_autoscale_factor().

◆ stabilization_data_to_mat4()

static void stabilization_data_to_mat4	(	float	pixel_aspect,
		const float	pivot[2],
		const float	translation[2],
		float	scale,
		float	angle,
		float	r_mat[4][4] )

static

Definition at line 1061 of file tracking_stabilize.cc.

References add_v2_v2(), invert_m4_m4(), mul_m4_series, rotate_m4(), size_to_mat4(), sub_v2_v2(), and unit_m4().

Referenced by BKE_tracking_stabilization_data_to_mat4(), and calculate_autoscale_factor().

◆ stabilization_determine_offset_for_frame()

static bool stabilization_determine_offset_for_frame	(	StabContext *	ctx,
		int	framenr,
		float	aspect,
		float	r_translation[2],
		float	r_pivot[2],
		float *	r_angle,
		float *	r_scale_step )

static

Definition at line 938 of file tracking_stabilize.cc.

References average_track_contributions(), find_next_working_frames(), MovieTrackingStabilization::flag, interpolate_averaged_track_contributions(), MAXFRAME, MINAFRAME, MINFRAME, StabContext::stab, TRACKING_2D_STABILIZATION, use_values_from_fcurves(), and zero_v2().

Referenced by BKE_tracking_stabilization_data_get(), and calculate_autoscale_factor().

◆ tracking_stabilize_frame_interpolation_cb()

static void tracking_stabilize_frame_interpolation_cb	(	void *__restrict	userdata,
		const int	y,
		const TaskParallelTLS *	__restrict )

static

Definition at line 1295 of file tracking_stabilize.cc.

References ImBuf::byte_buffer, ImBufByteBuffer::data, ImBufFloatBuffer::data, float, ImBuf::float_buffer, mul_v3_m4v3(), TRACKING_FILTER_BICUBIC, TRACKING_FILTER_BILINEAR, and ImBuf::x.

Referenced by BKE_tracking_stabilize_frame().

◆ translation_contribution()

static void translation_contribution	(	TrackStabilizationBase *	track_ref,
		MovieTrackingMarker *	marker,
		float	result_offset[2] )

static

Definition at line 395 of file tracking_stabilize.cc.

References add_v2_v2v2(), MovieTrackingMarker::pos, and TrackStabilizationBase::stabilization_offset_base.

Referenced by average_track_contributions().

◆ use_values_from_fcurves()

static void use_values_from_fcurves	(	StabContext *	ctx,
		bool	toggle )

static

Definition at line 194 of file tracking_stabilize.cc.

References StabContext::use_animation.

Referenced by average_marker_positions(), calculate_autoscale_factor(), init_stabilizer(), and stabilization_determine_offset_for_frame().

Variable Documentation

◆ EPSILON_WEIGHT

float EPSILON_WEIGHT = 0.005f

static

Definition at line 53 of file tracking_stabilize.cc.

Referenced by average_marker_positions(), average_track_contributions(), and is_effectively_disabled().

◆ SCALE_ERROR_LIMIT_BIAS

float SCALE_ERROR_LIMIT_BIAS = 0.01f

static

Definition at line 47 of file tracking_stabilize.cc.

Referenced by init_track_for_stabilization(), and rotation_contribution().

Classes

Functions

Variables

Detailed Description

Function Documentation

◆ access_stabilization_baseline_data()

◆ attach_stabilization_baseline_data()

◆ average_marker_positions()

◆ average_track_contributions()

◆ BKE_tracking_stabilization_data_get()

◆ BKE_tracking_stabilization_data_to_mat4()

◆ BKE_tracking_stabilize_frame()

◆ calculate_autoscale_factor()

◆ compensate_rotation_center()

◆ discard_stabilization_baseline_data()

◆ discard_stabilization_working_context()

◆ establish_track_initialization_order()

◆ fetch_from_fcurve()

◆ find_next_working_frames()

◆ get_animated_locinf()

◆ get_animated_rotinf()

◆ get_animated_scaleinf()

◆ get_animated_target_pos()

◆ get_animated_target_rot()

◆ get_animated_target_scale()

◆ get_animated_weight()

◆ get_closest_marker()

◆ get_tracking_data_point()

◆ init_all_tracks()

◆ init_stabilization_working_context()

◆ init_stabilizer()

◆ init_track_for_stabilization()

◆ interpolate_averaged_track_contributions()

◆ is_effectively_disabled()

◆ is_init_for_stabilization()

◆ is_usable_for_stabilization()

◆ retrieve_next_higher_usable_frame()

◆ retrieve_next_lower_usable_frame()

◆ retrieve_stab_animation()

◆ retrieve_track_weight_animation()

◆ rotation_contribution()

◆ search_closest_marker_index()

◆ setup_pivot()

◆ stabilization_calculate_data()

◆ stabilization_data_to_mat4()

◆ stabilization_determine_offset_for_frame()

◆ tracking_stabilize_frame_interpolation_cb()

◆ translation_contribution()

◆ use_values_from_fcurves()

Variable Documentation

◆ EPSILON_WEIGHT

◆ SCALE_ERROR_LIMIT_BIAS