MovieTrackingSettings(bpy_struct)

base class — bpy_struct

class bpy.types.MovieTrackingSettings(bpy_struct)

Match moving settings

clean_action

Cleanup action to execute (default 'SELECT')

  • SELECT Select – Select unclean tracks.

  • DELETE_TRACK Delete Track – Delete unclean tracks.

  • DELETE_SEGMENTS Delete Segments – Delete unclean segments of tracks.

Type:

Literal[‘SELECT’, ‘DELETE_TRACK’, ‘DELETE_SEGMENTS’]

clean_error

Effect on tracks which have a larger re-projection error (in [0, inf], default 0.0)

Type:

float

clean_frames

Effect on tracks which are tracked less than the specified amount of frames (in [0, inf], default 0)

Type:

int

default_correlation_min

Default minimum value of correlation between matched pattern and reference that is still treated as successful tracking (in [0, 1], default 0.0)

Type:

float

default_frames_limit

Every tracking cycle, this number of frames are tracked (in [0, 32767], default 0)

Type:

int

default_margin

Default distance from image boundary at which marker stops tracking (in [0, 300], default 0)

Type:

int

default_motion_model

Default motion model to use for tracking (default 'Loc')

  • Perspective Perspective – Search for markers that are perspectively deformed (homography) between frames.

  • Affine Affine – Search for markers that are affine-deformed (t, r, k, and skew) between frames.

  • LocRotScale Location, Rotation & Scale – Search for markers that are translated, rotated, and scaled between frames.

  • LocScale Location & Scale – Search for markers that are translated and scaled between frames.

  • LocRot Location & Rotation – Search for markers that are translated and rotated between frames.

  • Loc Location – Search for markers that are translated between frames.

Type:

Literal[‘Perspective’, ‘Affine’, ‘LocRotScale’, ‘LocScale’, ‘LocRot’, ‘Loc’]

default_pattern_match

Track pattern from given frame when tracking marker to next frame (default 'KEYFRAME')

  • KEYFRAME Keyframe – Track pattern from keyframe to next frame.

  • PREV_FRAME Previous frame – Track pattern from current frame to next frame.

Type:

Literal[‘KEYFRAME’, ‘PREV_FRAME’]

default_pattern_size

Size of pattern area for newly created tracks (in [5, 1000], default 0)

Type:

int

default_search_size

Size of search area for newly created tracks (in [5, 1000], default 0)

Type:

int

default_weight

Influence of newly created track on a final solution (in [0, 1], default 0.0)

Type:

float

distance

Distance between two bundles used for scene scaling (in [-inf, inf], default 1.0)

Type:

float

object_distance

Distance between two bundles used for object scaling (in [0.001, 10000], default 1.0)

Type:

float

refine_intrinsics_focal_length

Refine focal length during camera solving (default False)

Type:

bool

refine_intrinsics_principal_point

Refine principal point during camera solving (default False)

Type:

bool

refine_intrinsics_radial_distortion

Refine radial coefficients of distortion model during camera solving (default False)

Type:

bool

refine_intrinsics_tangential_distortion

Refine tangential coefficients of distortion model during camera solving (default False)

Type:

bool

speed

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

  • FASTEST Fastest – Track as fast as 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:

Literal[‘FASTEST’, ‘DOUBLE’, ‘REALTIME’, ‘HALF’, ‘QUARTER’]

use_default_blue_channel

Use blue channel from footage for tracking (default True)

Type:

bool

use_default_brute

Use a brute-force translation-only initialization when tracking (default False)

Type:

bool

use_default_green_channel

Use green channel from footage for tracking (default True)

Type:

bool

use_default_mask

Use a Grease Pencil data-block as a mask to use only specified areas of pattern when tracking (default False)

Type:

bool

use_default_normalization

Normalize light intensities while tracking (slower) (default False)

Type:

bool

use_default_red_channel

Use red channel from footage for tracking (default True)

Type:

bool

use_keyframe_selection

Automatically select keyframes when solving camera/object motion (default False)

Type:

bool

use_tripod_solver

Use special solver to track a stable camera position, such as a tripod (default False)

Type:

bool

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References