2016-12-30 01:31:22 +01:00
|
|
|
README - 9 January 2017
|
2010-05-18 17:58:33 +02:00
|
|
|
|
2013-08-02 05:08:42 +02:00
|
|
|
Welcome to the WebM VP8/VP9 Codec SDK!
|
2010-05-18 17:58:33 +02:00
|
|
|
|
|
|
|
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
|
2010-06-18 18:39:21 +02:00
|
|
|
|
2010-05-18 17:58:33 +02:00
|
|
|
* All x86 targets require the Yasm[1] assembler be installed.
|
|
|
|
* All Windows builds require that Cygwin[2] be installed.
|
2014-05-10 20:15:11 +02:00
|
|
|
* Building the documentation requires Doxygen[3]. If you do not
|
|
|
|
have this package, the install-docs option will be disabled.
|
|
|
|
* Downloading the data for the unit tests requires curl[4] and sha1sum.
|
2012-06-20 23:45:22 +02:00
|
|
|
sha1sum is provided via the GNU coreutils, installed by default on
|
|
|
|
many *nix platforms, as well as MinGW and Cygwin. If coreutils is not
|
|
|
|
available, a compatible version of sha1sum can be built from
|
2014-05-10 20:15:11 +02:00
|
|
|
source[5]. These requirements are optional if not running the unit
|
2012-06-20 23:45:22 +02:00
|
|
|
tests.
|
2010-06-18 18:39:21 +02:00
|
|
|
|
2010-05-18 17:58:33 +02:00
|
|
|
[1]: http://www.tortall.net/projects/yasm
|
|
|
|
[2]: http://www.cygwin.com
|
2014-05-10 20:15:11 +02:00
|
|
|
[3]: http://www.doxygen.org
|
|
|
|
[4]: http://curl.haxx.se
|
|
|
|
[5]: http://www.microbrew.org/tools/md5sha1sum/
|
2010-06-18 18:39:21 +02:00
|
|
|
|
2010-05-18 17:58:33 +02:00
|
|
|
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:
|
|
|
|
|
2016-12-30 01:31:22 +01:00
|
|
|
arm64-android-gcc
|
2016-07-28 07:10:09 +02:00
|
|
|
arm64-darwin-gcc
|
|
|
|
arm64-linux-gcc
|
2012-01-06 20:50:05 +01:00
|
|
|
armv7-android-gcc
|
2013-08-02 05:08:42 +02:00
|
|
|
armv7-darwin-gcc
|
2010-05-18 17:58:33 +02:00
|
|
|
armv7-linux-rvct
|
|
|
|
armv7-linux-gcc
|
2013-08-02 05:08:42 +02:00
|
|
|
armv7-none-rvct
|
|
|
|
armv7-win32-vs11
|
2013-11-13 20:36:32 +01:00
|
|
|
armv7-win32-vs12
|
2015-07-28 16:37:09 +02:00
|
|
|
armv7-win32-vs14
|
2014-06-11 03:52:58 +02:00
|
|
|
armv7s-darwin-gcc
|
2016-07-28 07:10:09 +02:00
|
|
|
armv8-linux-gcc
|
2010-05-18 17:58:33 +02:00
|
|
|
mips32-linux-gcc
|
2014-08-07 19:09:47 +02:00
|
|
|
mips64-linux-gcc
|
2013-08-02 05:08:42 +02:00
|
|
|
sparc-solaris-gcc
|
|
|
|
x86-android-gcc
|
2010-05-18 17:58:33 +02:00
|
|
|
x86-darwin8-gcc
|
|
|
|
x86-darwin8-icc
|
|
|
|
x86-darwin9-gcc
|
|
|
|
x86-darwin9-icc
|
2013-08-02 05:08:42 +02:00
|
|
|
x86-darwin10-gcc
|
|
|
|
x86-darwin11-gcc
|
|
|
|
x86-darwin12-gcc
|
|
|
|
x86-darwin13-gcc
|
2015-03-23 23:33:17 +01:00
|
|
|
x86-darwin14-gcc
|
2016-07-28 07:10:09 +02:00
|
|
|
x86-darwin15-gcc
|
2014-06-11 03:52:58 +02:00
|
|
|
x86-iphonesimulator-gcc
|
2010-05-18 17:58:33 +02:00
|
|
|
x86-linux-gcc
|
|
|
|
x86-linux-icc
|
2013-08-02 05:08:42 +02:00
|
|
|
x86-os2-gcc
|
2010-05-18 17:58:33 +02:00
|
|
|
x86-solaris-gcc
|
2013-08-02 05:08:42 +02:00
|
|
|
x86-win32-gcc
|
|
|
|
x86-win32-vs10
|
|
|
|
x86-win32-vs11
|
2013-11-13 20:36:32 +01:00
|
|
|
x86-win32-vs12
|
2015-07-28 16:37:09 +02:00
|
|
|
x86-win32-vs14
|
2015-07-24 23:24:20 +02:00
|
|
|
x86_64-android-gcc
|
2010-05-18 17:58:33 +02:00
|
|
|
x86_64-darwin9-gcc
|
2013-08-02 05:08:42 +02:00
|
|
|
x86_64-darwin10-gcc
|
|
|
|
x86_64-darwin11-gcc
|
|
|
|
x86_64-darwin12-gcc
|
|
|
|
x86_64-darwin13-gcc
|
2015-03-23 23:33:17 +01:00
|
|
|
x86_64-darwin14-gcc
|
2016-07-28 07:10:09 +02:00
|
|
|
x86_64-darwin15-gcc
|
2014-06-11 03:52:58 +02:00
|
|
|
x86_64-iphonesimulator-gcc
|
2010-05-18 17:58:33 +02:00
|
|
|
x86_64-linux-gcc
|
2013-08-02 05:08:42 +02:00
|
|
|
x86_64-linux-icc
|
2010-05-18 17:58:33 +02:00
|
|
|
x86_64-solaris-gcc
|
2013-08-02 05:08:42 +02:00
|
|
|
x86_64-win64-gcc
|
|
|
|
x86_64-win64-vs10
|
|
|
|
x86_64-win64-vs11
|
2013-11-13 20:36:32 +01:00
|
|
|
x86_64-win64-vs12
|
2015-07-28 16:37:09 +02:00
|
|
|
x86_64-win64-vs14
|
2010-05-18 17:58:33 +02:00
|
|
|
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):
|
|
|
|
|
2010-10-07 20:13:36 +02:00
|
|
|
$ CROSS=mipsel-linux-uclibc- ../libvpx/configure
|
2010-05-18 17:58:33 +02:00
|
|
|
|
|
|
|
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.
|
2013-07-18 23:17:00 +02:00
|
|
|
This defaults to config.log. This should give a good indication of what went
|
2010-05-18 17:58:33 +02:00
|
|
|
wrong. If not, contact us for support.
|
|
|
|
|
2014-05-31 01:37:39 +02:00
|
|
|
VP8/VP9 TEST VECTORS:
|
|
|
|
The test vectors can be downloaded and verified using the build system after
|
|
|
|
running configure. To specify an alternate directory the
|
|
|
|
LIBVPX_TEST_DATA_PATH environment variable can be used.
|
|
|
|
|
|
|
|
$ ./configure --enable-unit-tests
|
|
|
|
$ LIBVPX_TEST_DATA_PATH=../libvpx-test-data make testdata
|
|
|
|
|
2016-07-28 07:16:51 +02:00
|
|
|
CODE STYLE:
|
|
|
|
The coding style used by this project is enforced with clang-format using the
|
|
|
|
configuration contained in the .clang-format file in the root of the
|
|
|
|
repository.
|
|
|
|
|
|
|
|
Before pushing changes for review you can format your code with:
|
|
|
|
# Apply clang-format to modified .c, .h and .cc files
|
|
|
|
$ clang-format -i --style=file \
|
|
|
|
$(git diff --name-only --diff-filter=ACMR '*.[hc]' '*.cc')
|
|
|
|
|
|
|
|
Check the .clang-format file for the version used to generate it if there is
|
|
|
|
any difference between your local formatting and the review system.
|
|
|
|
|
|
|
|
See also: http://clang.llvm.org/docs/ClangFormat.html
|
|
|
|
|
2010-05-18 17:58:33 +02:00
|
|
|
SUPPORT
|
|
|
|
This library is an open source project supported by its community. Please
|
2016-07-28 07:10:02 +02:00
|
|
|
email webm-discuss@webmproject.org for help.
|
2010-05-18 17:58:33 +02:00
|
|
|
|