kdu_compressed_video_source::time_to_frame

If the video source provides no time indexing capabilities, this function may return -1. Otherwise, it should return the index of the frame whose period includes the supplied time_instant, measured in the time scale (ticks per second) identified by the get_timescale function.

If time indexing is available, but time_instant exceeds the duration of the video track, the function returns the index of the last available frame. Similarly, if time_instant refers to a time prior to the start of the video sequence, the function should return 0 (the index of the first frame).

time_instant [kdu_long]