MovieTrackingTrack(bpy_struct)

base class — bpy_struct

class bpy.types.MovieTrackingTrack(bpy_struct)

Match-moving track data for tracking

annotation

Annotation data for this track

Type

Annotation

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

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