XiphWiki - User contributions [en]

Daala Quickstart

2015-06-09T01:16:12Z

Muricula: /* Mac OS X */

This is a guide to getting a copy of the latest code and encoding a video.

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)
* libsdl (1.2, not 2!) (can by skipped if you pass --disable-player 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.

==== 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 also a bitstream analyzer. 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.

== 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}}

[[Category:Daala]]

Daala Quickstart

2015-06-09T01:15:50Z

Muricula: /* Mac OS X */

This is a guide to getting a copy of the latest code and encoding a video.

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)
* libsdl (1.2, not 2!) (can by skipped if you pass --disable-player 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.

==== 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 also a bitstream analyzer. 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.

== 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}}

[[Category:Daala]]

Daala Quickstart

2015-06-09T01:15:11Z

Muricula: /* Mac OS X */