Skip to content

cf_video_seek

Category: video
GitHub: cute_video.h

Jumps so the given frame becomes the picture currently shown.

bool cf_video_seek(CF_Video* video, int frame);
Parameters Description
video The video.
frame The frame to land on, from 0 to cf_video_frame_count minus one.

Return Value

Returns true once the frame is decoded and current. On a frame out of range, or a stream that fails mid-seek, returns false and playback stays exactly where it was.

Remarks

Decoding starts at the nearest keyframe at or before the target and rolls forward, so the cost is proportional to the distance past that keyframe -- files from cf_video_encoder_save carry one every two seconds. The playback clock resets, so the frame landed on shows for its full step before cf_video_update moves on.

CF_Video
cf_video_frame_count
cf_video_frame_index
cf_video_restart
cf_video_update