• Shotcut QML Scripting API
  • org.shotcut.qml
  • MotionTrackerModel
  • MotionTrackerModel QML Type

    A list model of motion tracker entries attached to the current producer. More...

    Import Statement: import org.shotcut.qml

    Properties

    Methods

    Detailed Description

    MotionTrackerModel is available as the motionTrackerModel context property in the Filters panel. Each row represents one stored motion tracker (a named bounding-box trajectory recorded against the clip).

    Property Documentation

    nameProperty : string

    The MLT property name used to store the tracker's display name on a filter (value: "shotcut:motionTracker.name"). CONSTANT.


    operationProperty : string

    The MLT property name used to store the tracker's link operation on a filter (value: "shotcut:motionTracker.operation"). CONSTANT.


    Method Documentation

    int keyframeIntervalFrames(int row)

    Returns the keyframe interval in frames for the tracker at row.


    string nextName()

    Returns an auto-generated unique name for a new tracker (e.g. "Tracker 2").


    void reset(Filter filter, string property, int row)

    Clears the keyframes for property on filter that were written by the tracker at model row row.


    void setName(Filter filter, string name)

    Sets the display name for the tracker linked to filter.


    list<rect> trackingData(int row)

    Returns the list of bounding-box rectangles recorded by the tracker at row, one entry per keyframe interval frame.


    void undo(Filter filter, string propertyName)

    Static helper that removes motion-tracker–written keyframes for propertyName on filter, typically called before re-applying a tracker.