# 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

  `select_search`

    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

Inherited Properties

`bpy_struct.id_data` |

Inherited Functions

`bpy_struct.as_pointer` `bpy_struct.driver_add` `bpy_struct.driver_remove` `bpy_struct.get` `bpy_struct.is_property_hidden` `bpy_struct.is_property_readonly` `bpy_struct.is_property_set` `bpy_struct.items` | `bpy_struct.keyframe_delete` `bpy_struct.keyframe_insert` `bpy_struct.keys` `bpy_struct.path_from_id` `bpy_struct.path_resolve` `bpy_struct.property_unset` `bpy_struct.type_recast` `bpy_struct.values`

References

`MovieTracking.tracks` `MovieTrackingObject.tracks` `MovieTrackingObjectPlaneTracks.active` `MovieTrackingObjectTracks.active` `MovieTrackingObjectTracks.new` | `MovieTrackingStabilization.rotation_track` `MovieTrackingStabilization.tracks` `MovieTrackingTracks.active` `MovieTrackingTracks.new` `UILayout.template_marker`