KeyFrames

Motion-tracking overlay — trackers hunt and follow features in the content, dropping keyframe diamonds behind them along their motion paths, like a compositor mid-track

Props

  • trackers

    Number of simultaneous trackers.

    Type
    number
    Default
    12

  • detect

    What the trackers hunt for.

    Type
    "bright" | "dark" | "alpha" | "red" | "green" | "blue"
    Default
    bright

  • threshold

    Feature floor — content scoring below this doesn't count as trackable at all.

    Type
    number
    Default
    0.15

  • variance

    Spread of tracker preferences — 0 hunts only the strongest features, 1 distributes trackers across the whole brightness range.

    Type
    number
    Default
    0.8

  • agility

    How fast trackers travel and how wide they search.

    Type
    number
    Default
    0.5

  • lifespan

    Seconds a tracker follows its target before retiring and reacquiring elsewhere. 0 = track forever.

    Type
    number
    Default
    6

  • trail

    Visibility of the keyframe trail each tracker leaves behind.

    Type
    number
    Default
    1

  • markerSize

    Tracker gizmo size in pixels.

    Type
    number
    Default
    28

  • lineWidth

    Stroke width in pixels.

    Type
    number
    Default
    1.5

  • markerColor

    Tracker gizmo color.

    Type
    string
    Default
    #54d66b

  • keyframeColor

    Keyframe diamond color.

    Type
    string
    Default
    #ffcf33

  • pathColor

    Motion path color.

    Type
    string
    Default
    #ffffffb8

Usage

<Shader>
  <KeyFrames>
    <Circle />
  </KeyFrames>
</Shader>