Usage notes
Use this primitive for a small number of DOM affordances that should move with timeline time without causing React renders on every scroll, scrub, or playback tick. The engine converts time to viewport X coordinates; the hook writes the transform directly to the referenced element.
Signature
Interface UseTimelineTimePositionOptionsProperties
| Name | Signature | Description |
|---|---|---|
engine | engine: TimelineEngine | Timeline engine that converts time to viewport-space pixels. |
getTime? | (): RationalTime | Optional resolver for imperative event-driven updates. |
positionEvents? | positionEvents?: TimelineTimePositionEvent[] | Event names that should re-sync DOM position without a React render. |
time | time: RationalTime | Current time represented by the positioned element. |