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.
The functions documented here are actually subdivided into three separate libraries:
libtheoraenccontains the encoder interface, described in Functions for Encoding.
libtheoradeccontains 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.
libtheoracontains 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_ namespace prefix. The older, legacy API uses
OC_ prefixes instead.