MovieTrackingSettings(bpy_struct)

base class — bpy_struct

class bpy.types.MovieTrackingSettings(bpy_struct)

Match moving settings

clean_action

Cleanup action to execute

• SELECT Select, Select unclean tracks.
• DELETE_TRACK Delete Track, Delete unclean tracks.
• DELETE_SEGMENTS Delete Segments, Delete unclean segments of tracks.

Type :enum in [‘SELECT’, ‘DELETE_TRACK’, ‘DELETE_SEGMENTS’], default ‘SELECT’

clean_error

Effect on tracks which have a larger reprojection error

Type :float in [0, inf], default 0.0

clean_frames

Effect on tracks which are tracked less than the specified amount of frames

Type :int in [0, inf], default 0

default_correlation_min

Default minimal value of correlation between matched pattern and reference which is still treated as successful tracking

Type :float in [-1, 1], default 0.0

default_frames_limit

Every tracking cycle, this number of frames are tracked

Type :int in [0, 32767], default 0

default_margin

Default distance from image boudary at which marker stops tracking

Type :int in [0, 300], default 0

default_pattern_match

Track pattern from given frame when tracking marker to next frame

• KEYFRAME Keyframe, Track pattern from keyframe to next frame.
• PREV_FRAME Previous frame, Track pattern from current frame to next frame.

Type :enum in [‘KEYFRAME’, ‘PREV_FRAME’], default ‘KEYFRAME’

default_pattern_size

Size of pattern area for newly created tracks

Type :int in [5, 1000], default 0

default_pyramid_levels

Default number of pyramid levels (increase on blurry footage)

Type :int in [1, 16], default 0

default_search_size

Size of search area for newly created tracks

Type :int in [5, 1000], default 0

default_tracker

Default tracking algorithm to use

• KLT KLT, Kanade–Lucas–Tomasi tracker which works with most of video clips, a bit slower than SAD.
• SAD SAD, Sum of Absolute Differences tracker which can be used when KLT tracker fails.
• Hybrid Hybrid, A hybrid tracker that uses SAD for rough tracking, KLT for refinement..

Type :enum in [‘KLT’, ‘SAD’, ‘Hybrid’], default ‘KLT’

distance

Distance between two bundles used for scene scaling

Type :float in [-inf, inf], default 1.0

keyframe_a

First keyframe used for reconstruction initialization

Type :int in [-inf, inf], default 0

keyframe_b

Second keyframe used for reconstruction initialization

Type :int in [-inf, inf], default 0

object_distance

Distance between two bundles used for object scaling

Type :float in [0.001, 10000], default 1.0

refine_intrinsics

Refine intrinsics during camera solving

• NONE Nothing, Do not refine camera intrinsics.
• FOCAL_LENGTH Focal Length, Refine focal length.
• FOCAL_LENGTH_RADIAL_K1 Focal length, K1, Refine focal length and radial distortion K1.
• FOCAL_LENGTH_RADIAL_K1_K2 Focal length, K1, K2, Refine focal length and radial distortion K1 and K2.
• FOCAL_LENGTH_PRINCIPAL_POINT_RADIAL_K1_K2 Focal Length, Optical Center, K1, K2, Refine focal length, optical center and radial distortion K1 and K2.
• FOCAL_LENGTH_PRINCIPAL_POINT Focal Length, Optical Center, Refine focal length and optical center.

Type :enum in [‘NONE’, ‘FOCAL_LENGTH’, ‘FOCAL_LENGTH_RADIAL_K1’, ‘FOCAL_LENGTH_RADIAL_K1_K2’, ‘FOCAL_LENGTH_PRINCIPAL_POINT_RADIAL_K1_K2’, ‘FOCAL_LENGTH_PRINCIPAL_POINT’], default ‘NONE’

show_default_expanded

Show the expanded in the user interface

Type :boolean, default False

speed

Limit speed of tracking to make visual feedback easier (this does not affect the tracking quality)

• FASTEST Fastest, Track as fast as it’s possible.
• DOUBLE Double, Track with double speed.
• REALTIME Realtime, Track with realtime speed.
• HALF Half, Track with half of realtime speed.
• QUARTER Quarter, Track with quarter of realtime speed.

Type :enum in [‘FASTEST’, ‘DOUBLE’, ‘REALTIME’, ‘HALF’, ‘QUARTER’], default ‘FASTEST’

use_default_blue_channel

Use blue channel from footage for tracking

Type :boolean, default False

use_default_green_channel

Use green channel from footage for tracking

Type :boolean, default False

use_default_red_channel

Use red channel from footage for tracking

Type :boolean, default False

Inherited Properties

bpy_struct.id_data

Inherited Functions

bpy_struct.as_pointer bpy_struct.callback_add bpy_struct.callback_remove bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_set

bpy_struct.items bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.type_recast bpy_struct.values

References

MovieTracking.settings