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 Track 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 which is still treated as successful tracking

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

Every tracking cycle, this number of frames are tracked

Type :int in [0, 32767], default 0
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 boudary at which marker stops tracking

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

Collection of markers in track

Type :bpy_prop_collection of MovieTrackingMarker, (readonly)
name

Unique name of track

Type :string, 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’
pattern_max

Right-bottom corner of pattern area in normalized coordinates relative to marker position

Type :float array of 2 items in [-inf, inf], default (0.0, 0.0)
pattern_min

Left-bottom corner of pattern area in normalized coordinates relative to marker position

Type :float array of 2 items in [-inf, inf], default (0.0, 0.0)
pyramid_levels

Number of pyramid levels (increase on blurry footage)

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

Right-bottom corner of search area in normalized coordinates relative to marker position

Type :float array of 2 items in [-inf, inf], default (0.0, 0.0)
search_min

Left-bottom corner of search area in normalized coordinates relative to marker position

Type :float array of 2 items in [-inf, inf], default (0.0, 0.0)
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
tracker

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’
use_blue_channel

Use blue channel from footage for tracking

Type :boolean, default False
use_custom_color

Use custom color instead of theme-defined

Type :boolean, default False
use_green_channel

Use green channel from footage for tracking

Type :boolean, default False
use_red_channel

Use red channel from footage for tracking

Type :boolean, default False
marker_find_frame(frame)

Get marker for specified frame

Parameters:frame (int in [0, 300000]) – Frame, type for the new spline
Returns:Marker for specified frame
Return type:MovieTrackingMarker

Inherited Properties

Inherited Functions

References

Previous topic

MovieTrackingStabilization(bpy_struct)

Next topic

MovieTrackingTracks(bpy_struct)