|
@@ -6,12 +6,11 @@
|
|
* IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. *
|
|
* IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. *
|
|
* *
|
|
* *
|
|
* THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 *
|
|
* THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 *
|
|
- * by the Xiph.Org Foundation http://www.xiph.org/ *
|
|
|
|
|
|
+ * by the Xiph.Org Foundation https://www.xiph.org/ *
|
|
* *
|
|
* *
|
|
********************************************************************
|
|
********************************************************************
|
|
|
|
|
|
function:
|
|
function:
|
|
- last mod: $Id: theora.h,v 1.8 2004/03/15 22:17:32 derf Exp $
|
|
|
|
|
|
|
|
********************************************************************/
|
|
********************************************************************/
|
|
|
|
|
|
@@ -22,13 +21,13 @@
|
|
* This is the documentation for the <tt>libtheora</tt> C API.
|
|
* This is the documentation for the <tt>libtheora</tt> C API.
|
|
*
|
|
*
|
|
* The \c libtheora package is the current reference
|
|
* The \c libtheora package is the current reference
|
|
- * implementation for <a href="http://www.theora.org/">Theora</a>, a free,
|
|
|
|
|
|
+ * implementation for <a href="https://www.theora.org/">Theora</a>, a free,
|
|
* patent-unencumbered video codec.
|
|
* patent-unencumbered video codec.
|
|
* Theora is derived from On2's VP3 codec with additional features and
|
|
* Theora is derived from On2's VP3 codec with additional features and
|
|
* integration with Ogg multimedia formats by
|
|
* integration with Ogg multimedia formats by
|
|
- * <a href="http://www.xiph.org/">the Xiph.Org Foundation</a>.
|
|
|
|
|
|
+ * <a href="https://www.xiph.org/">the Xiph.Org Foundation</a>.
|
|
* Complete documentation of the format itself is available in
|
|
* Complete documentation of the format itself is available in
|
|
- * <a href="http://www.theora.org/doc/Theora.pdf">the Theora
|
|
|
|
|
|
+ * <a href="https://www.theora.org/doc/Theora.pdf">the Theora
|
|
* specification</a>.
|
|
* specification</a>.
|
|
*
|
|
*
|
|
* \section Organization
|
|
* \section Organization
|
|
@@ -47,7 +46,7 @@
|
|
* During initial development, prior to the 1.0 release,
|
|
* During initial development, prior to the 1.0 release,
|
|
* \c libtheora exported a different \ref oldfuncs which
|
|
* \c libtheora exported a different \ref oldfuncs which
|
|
* combined both encode and decode functions.
|
|
* combined both encode and decode functions.
|
|
- * In general, legacy API symbols can be indentified
|
|
|
|
|
|
+ * In general, legacy API symbols can be identified
|
|
* by their \c theora_ or \c OC_ namespace prefixes.
|
|
* by their \c theora_ or \c OC_ namespace prefixes.
|
|
* The current API uses \c th_ or \c TH_ instead.
|
|
* The current API uses \c th_ or \c TH_ instead.
|
|
*
|
|
*
|
|
@@ -62,8 +61,8 @@
|
|
* The shared <tt>libtheoradec</tt> and <tt>libtheoraenc</tt> C API.
|
|
* The shared <tt>libtheoradec</tt> and <tt>libtheoraenc</tt> C API.
|
|
* You don't need to include this directly.*/
|
|
* You don't need to include this directly.*/
|
|
|
|
|
|
-#if !defined(_O_THEORA_CODEC_H_)
|
|
|
|
-# define _O_THEORA_CODEC_H_ (1)
|
|
|
|
|
|
+#if !defined(OGG_THEORA_CODEC_HEADER)
|
|
|
|
+# define OGG_THEORA_CODEC_HEADER (1)
|
|
# include <ogg/ogg.h>
|
|
# include <ogg/ogg.h>
|
|
|
|
|
|
#if defined(__cplusplus)
|
|
#if defined(__cplusplus)
|
|
@@ -95,7 +94,7 @@ extern "C" {
|
|
/*@}*/
|
|
/*@}*/
|
|
|
|
|
|
/**The currently defined color space tags.
|
|
/**The currently defined color space tags.
|
|
- * See <a href="http://www.theora.org/doc/Theora.pdf">the Theora
|
|
|
|
|
|
+ * See <a href="https://www.theora.org/doc/Theora.pdf">the Theora
|
|
* specification</a>, Chapter 4, for exact details on the meaning
|
|
* specification</a>, Chapter 4, for exact details on the meaning
|
|
* of each of these color spaces.*/
|
|
* of each of these color spaces.*/
|
|
typedef enum{
|
|
typedef enum{
|
|
@@ -111,7 +110,7 @@ typedef enum{
|
|
}th_colorspace;
|
|
}th_colorspace;
|
|
|
|
|
|
/**The currently defined pixel format tags.
|
|
/**The currently defined pixel format tags.
|
|
- * See <a href="http://www.theora.org/doc/Theora.pdf">the Theora
|
|
|
|
|
|
+ * See <a href="https://www.theora.org/doc/Theora.pdf">the Theora
|
|
* specification</a>, Section 4.4, for details on the precise sample
|
|
* specification</a>, Section 4.4, for details on the precise sample
|
|
* locations.*/
|
|
* locations.*/
|
|
typedef enum{
|
|
typedef enum{
|
|
@@ -195,7 +194,7 @@ typedef th_img_plane th_ycbcr_buffer[3];
|
|
*
|
|
*
|
|
* It is also generally recommended that the offsets and sizes should still be
|
|
* It is also generally recommended that the offsets and sizes should still be
|
|
* multiples of 2 to avoid chroma sampling shifts when chroma is sub-sampled.
|
|
* multiples of 2 to avoid chroma sampling shifts when chroma is sub-sampled.
|
|
- * See <a href="http://www.theora.org/doc/Theora.pdf">the Theora
|
|
|
|
|
|
+ * See <a href="https://www.theora.org/doc/Theora.pdf">the Theora
|
|
* specification</a>, Section 4.4, for more details.
|
|
* specification</a>, Section 4.4, for more details.
|
|
*
|
|
*
|
|
* Frame rate, in frames per second, is stored as a rational fraction, as is
|
|
* Frame rate, in frames per second, is stored as a rational fraction, as is
|
|
@@ -314,7 +313,7 @@ typedef struct{
|
|
* A particular tag may occur more than once, and order is significant.
|
|
* A particular tag may occur more than once, and order is significant.
|
|
* The character set encoding for the strings is always UTF-8, but the tag
|
|
* The character set encoding for the strings is always UTF-8, but the tag
|
|
* names are limited to ASCII, and treated as case-insensitive.
|
|
* names are limited to ASCII, and treated as case-insensitive.
|
|
- * See <a href="http://www.theora.org/doc/Theora.pdf">the Theora
|
|
|
|
|
|
+ * See <a href="https://www.theora.org/doc/Theora.pdf">the Theora
|
|
* specification</a>, Section 6.3.3 for details.
|
|
* specification</a>, Section 6.3.3 for details.
|
|
*
|
|
*
|
|
* In filling in this structure, th_decode_headerin() will null-terminate
|
|
* In filling in this structure, th_decode_headerin() will null-terminate
|
|
@@ -603,4 +602,4 @@ extern void th_comment_clear(th_comment *_tc);
|
|
}
|
|
}
|
|
#endif
|
|
#endif
|
|
|
|
|
|
-#endif
|
|
|
|
|
|
+#endif /* OGG_THEORA_CODEC_HEADER */
|