Daala Quickstart

2016-01-19T22:49:06Z

Ltrudeau: /* Ubuntu */

This is a guide to getting a copy of the latest Daala source code and encoding a video with it.

There is also a '''[[Daala Quickstart Windows]]''' page.

== Installation ==
=== Obtaining dependencies ===
==== Linux ====
You'll need:

* Standard build tools (autoconf, automake v1.11 or later, libtool, pkg-config, and a C compiler)
* git
* libogg (v1.3 or later)
* libpng
* libjpeg
* libcheck (v0.9.8 or later, can be skipped if you pass --disable-unit-tests to ./configure)
* libsdl2 (can by skipped if you pass --disable-player to ./configure)
* libwxgtk2.8 (optional: only needed if --enable-analyzer is passed to ./configure)

Do not use linuxbrew.

Instructions for installing these packages are OS-specific (feel free to contribute some here, especially if you tried installing these somewhere and ran into difficulties; you will likely save other people some pain). If you have a package manager that has separate -dev versions with the public headers, make sure you install those in addition to the actual libraries.

===== Ubuntu =====

Run the following command to install dependencies:
sudo apt-get install autoconf git g++ libtool libsdl2-gfx-dev libogg-dev libjpeg-dev libpng-dev check

==== Mac OS X ====
Install Apple's command line developer tools. E.g. install [https://developer.apple.com/xcode/ Xcode] from the App Store and select 'Command Line Tools' from the Preferences::Downloads panel, or download and install the pkg directly from [https://developer.apple.com/downloads/ developer.apple.com].

Install [http://brew.sh/ Homebrew]

Run the following command to install dependencies:
brew install autoconf automake libtool libogg libpng libjpeg check sdl2

=== Installation Procedure ===

Just run these commands:

<syntaxhighlight lang="bash">
git clone https://git.xiph.org/daala.git
cd daala
./autogen.sh
./configure
make
</syntaxhighlight>

Note that the git clone can take several minutes to complete.

And optionally

<syntaxhighlight lang="bash">
make tools
</syntaxhighlight>

Make sure you run the git clone operation on the same machine where you intend to use the code. Checking out a copy on Windows and then trying to use it on Linux will not work, as executable permissions and line-endings will not be set properly.

{{Encoding with Daala}}

{{Decoding with Daala}}

== The Stream Analyzer ==
There is a bitstream analyzer, with a GUI based on wxWidgets available.

To run it:

./examples/analyzer video.ogv

where video.ogv is the file you want to open. If you omit it, you can open it via the analyzer's GUI.

The analyser may only work correctly with videos encoded using the same Daala version as itself, as the bitstream is still being changed regularly by the ongoing code development.

== Using PNG Images ==

To encode a series of images:

make tools
./tools/png2y4m video%05d.png -o video.y4m

where %05d means your input images are named video00000.png, video00001.png, etc. You can leave out the %05d tag if you only want to convert a single image (which does not need to be numbered).

To convert a y4m back to PNGs:

./tools/y4m2png video.y4m -o video%05d.png

If you are converting a .y4m file that only contains a single frame (e.g., from one of the still-image subsets linked above), you can leave out the %05d tag. Conversion from PNG to Y4M uses the Rec 709 matrix with video levels, a box filter for chroma subsampling, and a triangular dither. Conversion back from Y4M to PNG uses the same matrix, levels, and box filter, but does not dither.

{{Converting to y4m}}

{{Merging two y4m videos side-by-side}}

== Showing frame differences in a y4m file ==
To show the difference between two consecutive frames in a y4m file, do:

<pre>
ffmpeg -i file.y4m -ss 0.03 -i file.y4m -filter_complex 'blend=all_mode=difference' -y diff.y4m
</pre>

This actually compares the video with itself, but offset by 1 frame or 0.03 seconds.

[[Category:Daala]]

XiphWiki - User contributions [en]

Daala Quickstart