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:float array 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:float array 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 LocRotScale, Search for markers that are translated, rotated, and scaled between frames.
  • LocScale LocScale, Search for markers that are translated and scaled between frames.
  • LocRot LocRot, Search for markers that are translated and rotated between frames.
  • Loc Loc, 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:float array 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 datablock 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

Inherited Properties

Inherited Functions

References