demux: take chapter/attachment name strings without 0-termination
[mplayer/glamo.git] / DOCS / tech / snow.txt
blobbe531fcb5c9154293f37c067afe87af82822df16
1  HOW TO TEST SNOW
2  ----------------
4 Snow is an experimental wavelet-based codec made by the FFmpeg developers,
5 and while it is still in heavy development, it is already giving very good
6 results.
7 Be very careful though, as the format of the bitstream produced might
8 change, do not rely on it to store videos that you value.
9 For this reason, MEncoder will not encode without 'vstrict=-2' on the
10 command line.
13 OPTIONS RECOGNIZED BY SNOW
15  * vqscale=<0.0-255.0>
16    Encoding quality, sane range 1-10. 0 is lossless.
17    May be fractional.
18    A given quality in snow needs a somewhat lower qscale than the same
19    quality in MPEG-4.
21  * vpass=<1-3>
22    Activates internal two (or more) pass mode.
24  * vbitrate=<value>
25    Specify bitrate of 1pass CBR or 2pass ABR. default: 800 kbit/s.
26    This is not very accurate for short videos.
28  * lmin, lmax, vqcomp, vratetol, vrc_eq, vrc_override
29    Generic multipass ratecontrol options, subject to the same suggestions
30    as in other codecs.
31    lmin=1 can be useful for medium to high bitrates (see vqscale).
33  * cmp, subcmp, mbcmp
34    Set the comparison function, default: 0 (SAD).
35    useful values = 0 (SAD), 1 (SSD), 2 (SATD),
36                    11 (5/3 wavelet), 12 (9/7 wavelet).
37    SAD is fastest and lowest quality.
38    SSD is the only function that makes correct decisions about intra vs
39    inter (mbcmp) when using fast motion estimation, but is not the best for
40    the actual search (cmp, subcmp).
41    The wavelet functions (use the one that matches pred) are best quality,
42    especially with vme=8, but are very slow.
43    SATD is a good balance.
44    You can add 256 to any of the options to enable chroma motion
45    estimation for that comparison (e.g. mbcmp=257 for SSD with chroma),
46    but it doesn't seem to help much for the moment.
48  * pred=<0-2>
49    Wavelet type.
50    0 = 9/7 wavelet, default.
51    1 = 5/3 wavelet.
52    2 = 13/7 wavelet.
53    9/7 is probably better for for lossy coding, and 5/3 for lossless.
54    NOTE: 9/7 wavelet doesn't work with lossless mode.
56  * qpel
57    Refines motion estimation, default: off.
58    This setting always helps compressibility, but costs some CPU time
59    both while encoding and decoding.
61  * v4mv
62    Allows smaller motion partitions, default: off.
63    v4mv is theoretically good, but in practice isn't really working yet.
64    The current MB decision algorithm doesn't make very good use of this:
65    It improves quality, but also increases bitrate. (You could get
66    more quality per bitrate by reducing quantizer instead.)
68  * vme=<4|8>
69    The default EPZS (4) is the same as in other formats.
70    Snow also supports iterative motion estimation (8), which jointly
71    optimizes adjacent blocks to make the most of OBMC. This significantly
72    improves compression, but is very slow.
73    Iterative ME currently does not perform scenecut detection, so should
74    be used only in the second pass of a two pass encode.
76  * refs=<1-8>
77    Allows each block to choose which of several reference frames to
78    motion compensate from. Default: 1. Larger values always improve
79    compression, but cost lots of CPU-time when encoding and extra
80    memory when decoding.
82 In short:
83 The best options in almost all cases are
84 vcodec=snow:vstrict=-2:vpass=1:vbitrate=$B:pred=0:cmp=2:subcmp=2:mbcmp=1:qpel
85 vcodec=snow:vstrict=-2:vpass=2:vbitrate=$B:pred=0:cmp=12:subcmp=12:mbcmp=1:qpel:vme=8:refs=8
87 Decent, fast options are
88 vcodec=snow:vstrict=-2:vpass=1:vbitrate=$B:pred=0:cmp=1:subcmp=1:mbcmp=1
89 vcodec=snow:vstrict=-2:vpass=2:vbitrate=$B:pred=0:cmp=2:subcmp=2:mbcmp=1:refs=2