Clarify docs that av_seek_frame() may possibly not seek by keyframe
|Reported by:||mbradshaw||Owned by:||stefano|
|Blocking:||Reproduced by developer:||no|
|Analyzed by developer:||no|
As a result of the discussion on the libav-user mailing list (particularly this reply), I learned that
av_seek_frame() may not actually seek by keyframe for some files. The way the current documentation is ("Seek to the keyframe at timestamp.") it sounds like it will always seek to a keyframe, which implies the next packet read and fed into
avcodec_decode_video2/audio4() will result in a complete frame, which of course is not the case if seeking by keyframe is not done.
This ticket is a request to simply expand on the existing documentation of
av_seek_frame() and clarify that seeking may possibly not be done by keyframe (and any other gotchas that people might know that aren't documented with
av_seek_frame()). I'd submit a patch myself but I seem to always get surprised with new gotchas when it comes to seeking, so I hope someone who is more familiar with
av_seek_frame()'s behavior can better expound than I can.