Go to file
Stefan Holmer 7296b3f922 New ways of passing encoded data between encoder and decoder.
With this commit frames can be received partition-by-partition
from the encoder and passed partition-by-partition to the
decoder.

At the encoder-side this makes it easier to split encoded
frames at partition boundaries, useful when packetizing
frames. When VPX_CODEC_USE_OUTPUT_PARTITION is enabled,
several VPX_CODEC_CX_FRAME_PKT packets will be returned
from vpx_codec_get_cx_data(), containing one partition
each. The partition_id (starting at 0) specifies the decoding
order of the partitions. All partitions but the last has
the VPX_FRAME_IS_FRAGMENT flag set.

At the decoder this opens up the possibility of decoding partition
N even though partition N-1 was lost (given that independent
partitioning has been enabled in the encoder) if more info
about the missing parts of the stream is available through
external signaling.

Each partition is passed to the decoder through the
vpx_codec_decode() function, with the data pointer pointing
to the start of the partition, and with data_sz equal to the
size of the partition. Missing partitions can be signaled to
the decoder by setting data != NULL and data_sz = 0. When
all partitions have been given to the decoder "end of data"
should be signaled by calling vpx_codec_decode() with
data = NULL and data_sz = 0.

The first partition is the first partition according to the
VP8 bitstream + the uncompressed data chunk + DCT address
offsets if multiple residual partitions are used.

Change-Id: I5bc0682b9e4112e0db77904755c694c3c7ac6e74
2011-06-28 11:10:17 -04:00
build configuration, support disabling any subset of ARM arch 2011-06-21 10:39:01 +03:00
examples Adding support for error concealment in multi-threaded decoding 2011-06-27 09:03:06 -04:00
libmkv clean up unused variable warnings 2011-05-09 12:56:20 -04:00
nestegg ivfdec: webm reader support 2010-10-25 22:01:40 -04:00
tools Generate AUTHORS file with a script 2010-06-16 15:43:09 -04:00
vp8 New ways of passing encoded data between encoder and decoder. 2011-06-28 11:10:17 -04:00
vpx New ways of passing encoded data between encoder and decoder. 2011-06-28 11:10:17 -04:00
vpx_mem clean up unused files 2011-02-18 09:09:49 -05:00
vpx_ports use GCC inline magic 2011-06-08 16:19:37 -04:00
vpx_scale Do not copy data between encoder reference buffers. 2011-04-20 15:26:55 +03:00
.gitattributes Initial WebM release 2010-05-18 11:58:33 -04:00
.gitignore update gitignore 2010-09-28 10:09:01 -04:00
.mailmap Update .mailmap 2011-03-04 11:11:15 -05:00
args.c Add psnr/ssim tuning option 2010-12-17 10:01:05 -05:00
args.h Add psnr/ssim tuning option 2010-12-17 10:01:05 -05:00
AUTHORS Update AUTHORS 2011-03-04 11:12:06 -05:00
CHANGELOG Update CHANGELOG for v0.9.6 (Bali) release 2011-03-04 14:32:24 -05:00
configure Merge "changed configure option name to reduce confusion" 2011-05-19 11:17:08 -07:00
docs.mk Remove examples.doxy dep w/--disable-examples 2011-02-24 15:11:05 -08:00
example_xma.c Use WebM in copyright notice for consistency 2010-09-09 10:01:21 -04:00
examples.mk Adding error-concealment to the decoder. 2011-05-19 13:46:33 -04:00
keywords.dox Initial WebM release 2010-05-18 11:58:33 -04:00
libs.doxy_template Use WebM in copyright notice for consistency 2010-09-09 10:01:21 -04:00
libs.mk Fix parallel install 2011-06-22 12:53:07 -04:00
LICENSE LICENSE: update with latest text 2010-06-04 16:19:40 -04:00
mainpage.dox documentation: minor cosmetics 2011-02-16 17:59:33 -08:00
md5_utils.c Adds "armvX-none-rvct" targets 2011-01-28 12:47:39 +02:00
md5_utils.h Use public domain implementation for MD5 algorithm 2010-06-14 08:48:22 -04:00
PATENTS LICENSE: update with latest text 2010-06-04 16:19:40 -04:00
README purge wince configuration 2011-02-22 14:42:00 -05:00
solution.mk obj_int_extract for Visual Studio 2011-03-10 18:49:54 -05:00
tools_common.c fix pipe support on windows 2010-11-02 09:14:24 -04:00
tools_common.h fix pipe support on windows 2010-11-02 09:14:24 -04:00
usage_cx.dox Initial WebM release 2010-05-18 11:58:33 -04:00
usage_dx.dox Initial WebM release 2010-05-18 11:58:33 -04:00
usage.dox documentation: minor cosmetics 2011-02-16 17:59:33 -08:00
vp8_api1_migration.txt Initial WebM release 2010-05-18 11:58:33 -04:00
vpxdec.c Adding error-concealment to the decoder. 2011-05-19 13:46:33 -04:00
vpxenc.c vpxenc: add rate histogram display 2011-06-23 10:22:44 -04:00
y4minput.c clean up unused variable warnings 2011-05-09 12:56:20 -04:00
y4minput.h Use WebM in copyright notice for consistency 2010-09-09 10:01:21 -04:00

vpx Multi-Format Codec SDK
README - 19 May 2010

Welcome to the WebM VP8 Codec SDK!

COMPILING THE APPLICATIONS/LIBRARIES:
  The build system used is similar to autotools. Building generally consists of
  "configuring" with your desired build options, then using GNU make to build
  the application.

  1. Prerequisites

    * All x86 targets require the Yasm[1] assembler be installed.
    * All Windows builds require that Cygwin[2] be installed.
    * Building the documentation requires PHP[3] and Doxygen[4]. If you do not
      have these packages, you must pass --disable-install-docs to the
      configure script.

    [1]: http://www.tortall.net/projects/yasm
    [2]: http://www.cygwin.com
    [3]: http://php.net
    [4]: http://www.doxygen.org

  2. Out-of-tree builds
  Out of tree builds are a supported method of building the application. For
  an out of tree build, the source tree is kept separate from the object
  files produced during compilation. For instance:

    $ mkdir build
    $ cd build
    $ ../libvpx/configure <options>
    $ make

  3. Configuration options
  The 'configure' script supports a number of options. The --help option can be
  used to get a list of supported options:
    $ ../libvpx/configure --help

  4. Cross development
  For cross development, the most notable option is the --target option. The
  most up-to-date list of supported targets can be found at the bottom of the
  --help output of the configure script. As of this writing, the list of
  available targets is:

    armv5te-linux-rvct
    armv5te-linux-gcc
    armv5te-symbian-gcc
    armv6-darwin-gcc
    armv6-linux-rvct
    armv6-linux-gcc
    armv6-symbian-gcc
    iwmmxt-linux-rvct
    iwmmxt-linux-gcc
    iwmmxt2-linux-rvct
    iwmmxt2-linux-gcc
    armv7-linux-rvct
    armv7-linux-gcc
    mips32-linux-gcc
    ppc32-darwin8-gcc
    ppc32-darwin9-gcc
    ppc64-darwin8-gcc
    ppc64-darwin9-gcc
    ppc64-linux-gcc
    x86-darwin8-gcc
    x86-darwin8-icc
    x86-darwin9-gcc
    x86-darwin9-icc
    x86-linux-gcc
    x86-linux-icc
    x86-solaris-gcc
    x86-win32-vs7
    x86-win32-vs8
    x86_64-darwin9-gcc
    x86_64-linux-gcc
    x86_64-solaris-gcc
    x86_64-win64-vs8
    universal-darwin8-gcc
    universal-darwin9-gcc
    generic-gnu

  The generic-gnu target, in conjunction with the CROSS environment variable,
  can be used to cross compile architectures that aren't explicitly listed, if
  the toolchain is a cross GNU (gcc/binutils) toolchain. Other POSIX toolchains
  will likely work as well. For instance, to build using the mipsel-linux-uclibc
  toolchain, the following command could be used (note, POSIX SH syntax, adapt
  to your shell as necessary):

    $ CROSS=mipsel-linux-uclibc- ../libvpx/configure

  In addition, the executables to be invoked can be overridden by specifying the
  environment variables: CC, AR, LD, AS, STRIP, NM. Additional flags can be
  passed to these executables with CFLAGS, LDFLAGS, and ASFLAGS.

  5. Configuration errors
  If the configuration step fails, the first step is to look in the error log.
  This defaults to config.err. This should give a good indication of what went
  wrong. If not, contact us for support.

SUPPORT
  This library is an open source project supported by its community. Please
  please email webm-users@webmproject.org for help.