id,summary,reporter,owner,description,type,status,priority,component,version,resolution,keywords,cc,blockedby,blocking,reproduced,analyzed
1575,Clarify docs that av_seek_frame() may possibly not seek by keyframe,mbradshaw,stefano,"As a result of the [http://ffmpeg.org/pipermail/libav-user/2012-July/002468.html discussion on the libav-user mailing list] ([http://ffmpeg.org/pipermail/libav-user/2012-July/002510.html 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.",enhancement,closed,normal,documentation,git-master,invalid,,,,,0,0