Interface

UseTimelineKeyframesOptions

Options accepted by `useTimelineKeyframes`.

Usage notes

Use these options to scope keyframe reads to one clip, one property, selected clips, or visible viewport geometry. Geometry options should match the renderer and interaction layer so DOM overlays line up with canvas keyframe diamonds.

Signature

Type Definition
Interface UseTimelineKeyframesOptions

Properties

NameSignatureDescription
clipId?clipId?: stringOptional clip id used to scope keyframe lists and commands.
collapsedTrackHeight?collapsedTrackHeight?: numberCollapsed track height in pixels.
edgeThreshold?edgeThreshold?: numberMouse/pen edge hit threshold in pixels.
keyframeSize?keyframeSize?: numberKeyframe affordance square size in CSS pixels.
keyframeValuePadding?keyframeValuePadding?: numberVertical padding used when mapping keyframe values into a clip row.
overscanPixels?overscanPixels?: numberExtra pixels around the viewport included in visibility tests.
property?property?: stringOnly include keyframes for this property. Defaults to all supported properties.
rulerHeight?rulerHeight?: numberHeight of the top ruler region in pixels.
selectedClipOnly?selectedClipOnly?: booleanOnly include keyframes belonging to selected clips.
touchEdgeThreshold?touchEdgeThreshold?: numberTouch edge hit threshold in pixels.
trackHeight?trackHeight?: numberDefault expanded track height in pixels.
viewportHeight?viewportHeight?: numberOptional viewport height in CSS pixels for vertical filtering.
viewportWidth?viewportWidth?: numberViewport width in CSS pixels. Defaults to the engine viewport width.