libtheora Documentation

# Introduction

This is the documentation for `libtheora` C API. The current reference implementation for Theora, a free, patent-unencumbered video codec. Theora is derived from On2's VP3 codec with additional features and integration with Ogg multimedia formats by the Xiph.Org Foundation. Complete documentation of the format itself is available in the Theora specification.

## Organization

The functions documented here are actually subdivided into three separate libraries:

- `libtheoraenc` contains the encoder interface, described in Functions for Encoding.
- `libtheoradec` contains the decoder interface and routines shared with the encoder. You must also link to this if you link to `libtheoraenc`. The routines in this library are described in Functions for Decoding and Functions Shared by Encode and Decode.
- `libtheora` contains the Legacy pre-1.0 C API.

New code should link to `libtheoradec` and, if using encoder features, `libtheoraenc`. Together these two export both the standard and the legacy API, so this is all that is needed by any code. The older `libtheora` library is provided just for compatibility with older build configurations.

In general the recommended 1.x API symbols can be distinguished by their `th_` or `TH_` namespace prefix. The older, legacy API uses `theora_` or `OC_` prefixes instead.