Playback Control

Playback control functions let add-ons read and control the current telemetry playback state.

Use them when your add-on needs to react to what the user is currently seeing, move the timeline, create playback shortcuts, or build custom controls such as play, pause, rewind, and speed buttons.

Playback time

Telemetry playback time represents the current point on the timeline.

Use GetTelemetryPlaybackTime() to read the time currently displayed by Tacview. Use SetTelemetryPlaybackTime() to move playback to another time.

Playback time is expressed as a high-resolution Unix timestamp.

Playback state

Playback can be paused, playing forward, or playing backward.

Use GetTelemetryPlaybackState() to know the current state. Use StartTelemetryPlayback(), PauseTelemetryPlayback(), and RewindTelemetryPlayback() to control playback direction.

Playback automatically stops when it reaches the beginning or end of the available telemetry. If telemetry is still being loaded or received, Tacview may continue when more data becomes available.

Playback speed

Playback speed is a factor applied when telemetry is playing forward or backward.

A speed factor of 1.0 means real time. A value of 0.5 means half speed. A value of 2.0 means twice the normal speed.

Use GetTelemetryPlaybackSpeed() to read the current playback speed. Use SetTelemetryPlaybackSpeed() to change it.

Playback speed is independent from the playback state. Changing the speed does not start or stop playback.

Typical uses

Playback control is useful for add-ons that need to:

• display the current playback time

• save and restore timeline shortcuts

• move to nearby events

• synchronize custom analysis with the visible telemetry state

• provide custom playback controls

• inspect or compare telemetry at specific moments

These functions are usually used together. For example, an add-on may read the current time, move it by a small amount, then update its own display on the next frame.