From 373dc625f82b47096893add42c4472e4a57ab7eb Mon Sep 17 00:00:00 2001 From: Aki Date: Wed, 9 Feb 2022 22:23:03 +0100 Subject: Moved third-party libraries to a separate subdirectory --- contrib/ogg/doc/libogg/decoding.html | 104 +++++++++++++++++++++++++++++++++++ 1 file changed, 104 insertions(+) create mode 100644 contrib/ogg/doc/libogg/decoding.html (limited to 'contrib/ogg/doc/libogg/decoding.html') diff --git a/contrib/ogg/doc/libogg/decoding.html b/contrib/ogg/doc/libogg/decoding.html new file mode 100644 index 0000000..f393a07 --- /dev/null +++ b/contrib/ogg/doc/libogg/decoding.html @@ -0,0 +1,104 @@ + + + +libogg - Decoding + + + + + + + + + +

libogg documentation

libogg release 1.3.2 - 20140527

+ +

Decoding

Libogg contains a set of functions used in the decoding process. +

+All the libogg specific functions are declared in "ogg/ogg.h". +

Decoding is based around the ogg synchronization layer. The ogg_sync_state struct coordinates between incoming data and the decoder. We read data into the synchronization layer, submit the data to the stream, and output raw packets to the decoder. +

Decoding through the Ogg layer follows a specific logical sequence. A read loop follows these logical steps: +

Expose a buffer using ogg_sync_buffer(). +
Read data into the buffer, using fread() or a similar function. +
Call ogg_sync_wrote() to tell the synchronization layer how many bytes you wrote into the buffer. +
Write out the data using ogg_sync_pageout. +
Submit the completed page to the streaming layer with ogg_stream_pagein. +
Output a packet of data to the codec-specific decoding layer using ogg_stream_packetout. +

In practice, streams are more complex, and Ogg also must handle headers, incomplete or dropped pages, and other errors in input. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
function purpose
ogg_sync_init Initializes an Ogg bitstream.
ogg_sync_clear Clears the status information from the synchronization struct. +
ogg_sync_reset Resets the synchronization status to initial values.
ogg_sync_destroy Frees the synchronization struct.
ogg_sync_check Check for asynchronous errors.
ogg_sync_buffer Exposes a buffer from the synchronization layer in order to read data.
ogg_sync_wrote Tells the synchronization layer how many bytes were written into the buffer.
ogg_sync_pageseek Finds the borders of pages and resynchronizes the stream.
ogg_sync_pageout Outputs a page from the synchronization layer.
ogg_stream_pagein Submits a complete page to the stream layer.
ogg_stream_packetout Outputs a packet to the codec-specific decoding engine.
ogg_stream_packetpeek Provides access to the next packet in the bitstream without +advancing decoding.
+ +

+

+ + + + + + + + +

copyright © 2000-2014 Xiph.Org	Ogg Container Format
libogg documentation	libogg release 1.3.2 - 20140527

+ + + + -- cgit v1.1

function	purpose
ogg_sync_init	Initializes an Ogg bitstream.
ogg_sync_clear	Clears the status information from the synchronization struct.	+
ogg_sync_reset	Resets the synchronization status to initial values.
ogg_sync_destroy	Frees the synchronization struct.
ogg_sync_check	Check for asynchronous errors.
ogg_sync_buffer	Exposes a buffer from the synchronization layer in order to read data.
ogg_sync_wrote	Tells the synchronization layer how many bytes were written into the buffer.
ogg_sync_pageseek	Finds the borders of pages and resynchronizes the stream.
ogg_sync_pageout	Outputs a page from the synchronization layer.
ogg_stream_pagein	Submits a complete page to the stream layer.
ogg_stream_packetout	Outputs a packet to the codec-specific decoding engine.
ogg_stream_packetpeek	Provides access to the next packet in the bitstream without +advancing decoding.