MovieTrackingTrack(bpy_struct)#

base class — bpy_struct

class bpy.types.MovieTrackingTrack(bpy_struct)#

Match-moving track data for tracking

average_error#

Average error of re-projection

Type:

float in [-inf, inf], default 0.0, (readonly)

bundle#

Position of bundle reconstructed from this track

Type:

mathutils.Vector of 3 items in [-inf, inf], default (0.0, 0.0, 0.0), (readonly)

color#

Color of the track in the Movie Clip Editor and the 3D viewport after a solve

Type:

mathutils.Color of 3 items in [0, 1], default (0.0, 0.0, 0.0)

correlation_min#

Minimal value of correlation between matched pattern and reference that is still treated as successful tracking

Type:

float in [0, 1], default 0.0

frames_limit#

Every tracking cycle, this number of frames are tracked

Type:

int in [0, 32767], default 0

grease_pencil#

Grease Pencil data for this track

Type:

GreasePencil

has_bundle#

True if track has a valid bundle

Type:

boolean, default False, (readonly)

hide#

Track is hidden

Type:

boolean, default False

lock#

Track is locked and all changes to it are disabled

Type:

boolean, default False

margin#

Distance from image boundary at which marker stops tracking

Type:

int in [0, 300], default 0

markers#

Collection of markers in track

Type:

MovieTrackingMarkers bpy_prop_collection of MovieTrackingMarker, (readonly)

motion_model#

Default motion model to use for tracking

  • 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:

enum in [‘Perspective’, ‘Affine’, ‘LocRotScale’, ‘LocScale’, ‘LocRot’, ‘Loc’], default ‘Loc’

name#

Unique name of track

Type:

string, default “”, (never None)

offset#

Offset of track from the parenting point

Type:

mathutils.Vector of 2 items in [-inf, inf], default (0.0, 0.0)

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’

select#

Track is selected

Type:

boolean, default False

select_anchor#

Track’s anchor point is selected

Type:

boolean, default False

select_pattern#

Track’s pattern area is selected

Type:

boolean, default False

Track’s search area is selected

Type:

boolean, default False

use_alpha_preview#

Apply track’s mask on displaying preview

Type:

boolean, default False

use_blue_channel#

Use blue channel from footage for tracking

Type:

boolean, default False

use_brute#

Use a brute-force translation only pre-track before refinement

Type:

boolean, default False

use_custom_color#

Use custom color instead of theme-defined

Type:

boolean, default False

use_grayscale_preview#

Display what the tracking algorithm sees in the preview

Type:

boolean, default False

use_green_channel#

Use green channel from footage for tracking

Type:

boolean, default False

use_mask#

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

Type:

boolean, default False

use_normalization#

Normalize light intensities while tracking (slower)

Type:

boolean, default False

use_red_channel#

Use red channel from footage for tracking

Type:

boolean, default False

weight#

Influence of this track on a final solution

Type:

float in [0, 1], default 0.0

weight_stab#

Influence of this track on 2D stabilization

Type:

float in [0, 1], default 0.0

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

id (str) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

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

id (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties#

Inherited Functions#

References#