DOCS/tech/snow.txt

   1  HOW TO TEST SNOW
   2  ----------------
   3
   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.
  11
  12
  13 OPTIONS RECOGNIZED BY SNOW
  14
  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.
  20
  21  * vpass=<1-3>
  22    Activates internal two (or more) pass mode.
  23
  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.
  27
  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).
  32
  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.
  47
  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.
  55
  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.
  60
  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.)
  67
  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.
  75
  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.
  81
  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
  86
  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
  90