k4a_playback_seek_timestamp()

k4a_result_t k4a_playback_seek_timestamp ( k4a_playback_t  playback_handle, int64_t  offset_usec, k4a_playback_seek_origin_t  origin  )

related

Seek to a specific timestamp within a recording.

Parameters

playback_handle	Handle obtained by k4a_playback_open().
offset_usec	The timestamp offset to seek to relative to origin
origin	Specifies if the seek operation should be done relative to the beginning or end of the recording.

Returns

K4A_RESULT_SUCCEEDED if the seek operation was successful, or K4A_RESULT_FAILED if an error occured. The current seek position is left unchanged if a failure is returned.

Remarks

The first call to k4a_playback_get_next_capture() after k4a_playback_seek_timestamp() will return the first capture containing an image timestamp greater than or equal to the seek time.

The first call to k4a_playback_get_previous_capture() after k4a_playback_seek_timestamp() will return the first capture with all image timestamps less than the seek time.

The first call to k4a_playback_get_next_imu_sample() after k4a_playback_seek_timestamp() will return the first imu sample with a timestamp greter than or equal to the seek time.

The first call to k4a_playback_get_previous_imu_sample() after k4a_playback_seek_timestamp() will return the first imu sample with a timestamp less than the seek time.