FFmpegSource Documentation

Changes

• 1.2
  • Compiled against ffmpeg rev9451
  • Somewhat cleaner source code
  • Linear access in addition to a few other modes of seeking can now be forced
  • Can now save the index information to a file which makes subsequent file opening fast
  • No longer skips indexing for any format
• 1.1
  • Skip indexing for avi
  • Prefix all error messages with the plugin name
  • Can write v2 timecodes to a file
  • Fixed reported framerate

Usage

FFmpegSource(string source, int track = -1, int seekmode = 1, string timecodes, bool cache = true, string CacheFile)

source: source file

track: track number as seen by the relevant demuxer, starts from 0, -1 means will pick the first video track

seekmode: force how seeking is handled, has no effect on matroska files which always use the equivalent of seekmode=1
0: linear access, the definition of slow but should make some formats "usable"
1: safe normal, bases seeking decisions on the reported keyframe positions
2: unsafe normal, same as 1 but no error will be thrown if the exact destination has to be guessed
3: aggressive, seek in the forward direction even if no closer keyframe is known to exist, only useful for containers where avformat doesn't report keyframes properly and testing

timecodes: file to output timecodes to, if the file exists it will always be overwritten

cache: write indexing information to a file for later use

cachefile: if specified the file to store the index information in, if nothing is specified .ffcache is used

Compatibility

• AVI, MKV, MP4, FLV: Frame accurate
• OGM: Messed up first frame and seeking produces smearing with seekmode=3, incredibly slow seeking without
• WMV: No seeking
• VOB: No rff flags applied, frame accurate?
• MPG: Seeking seems to be off by one or two frames now and then
• TS: Anything except seekmode=0 is a complete waste of time

Compiling

zlib from http://www.zlib.net/

FFmpeg svn from http://ffmpeg.mplayerhq.hu/

Required Configuration: ./configure --enable-shared --disable-static --enable-memalign-hack --enable-swscaler --enable-gpl

Suggested Additional Options: --disable-encoders --disable-muxers