gstreamer 1.2.1-x86-mingw32 → 1.2.2-x86-mingw32

data/vendor/local/share/doc/libtheora-1.1.1/latex/index.tex

@@ -1,12 +1,12 @@
 \section{Introduction}\label{index_intro}
-This is the documentation for {\ttfamily libtheora} C A\-P\-I. The current reference implementation for {\tt Theora}, a free, patent-\/unencumbered video codec. Theora is derived from On2's V\-P3 codec with additional features and integration with Ogg multimedia formats by {\tt the Xiph.\-Org Foundation}. Complete documentation of the format itself is available in {\tt the Theora specification}.\subsection{Organization}\label{index_Organization}
-The functions documented here are actually subdivided into three separate libraries\-:
+This is the documentation for {\ttfamily libtheora} C API. The current reference implementation for {\tt 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 {\tt the Xiph.Org Foundation}. Complete documentation of the format itself is available in {\tt the Theora specification}.\subsection{Organization}\label{index_Organization}
+The functions documented here are actually subdivided into three separate libraries:
 \begin{DoxyItemize}
 \item {\ttfamily libtheoraenc} contains the encoder interface, described in \doxyref{Functions for Encoding}{p.}{group__encfuncs}.
 \item {\ttfamily libtheoradec} contains the decoder interface and routines shared with the encoder. You must also link to this if you link to {\ttfamily libtheoraenc}. The routines in this library are described in \doxyref{Functions for Decoding}{p.}{group__decfuncs} and \doxyref{Functions Shared by Encode and Decode}{p.}{group__basefuncs}.
-\item {\ttfamily libtheora} contains the \doxyref{Legacy pre-\/1.\-0 C A\-P\-I}{p.}{group__oldfuncs}.
+\item {\ttfamily libtheora} contains the \doxyref{Legacy pre-\/1.0 C API}{p.}{group__oldfuncs}.
 \end{DoxyItemize}
 
-New code should link to {\ttfamily libtheoradec} and, if using encoder features, {\ttfamily libtheoraenc}. Together these two export both the standard and the legacy A\-P\-I, so this is all that is needed by any code. The older {\ttfamily libtheora} library is provided just for compatibility with older build configurations.
+New code should link to {\ttfamily libtheoradec} and, if using encoder features, {\ttfamily libtheoraenc}. Together these two export both the standard and the legacy API, so this is all that is needed by any code. The older {\ttfamily libtheora} library is provided just for compatibility with older build configurations.
 
-In general the recommended 1.\-x A\-P\-I symbols can be distinguished by their {\ttfamily th\-\_\-} or {\ttfamily T\-H\-\_\-} namespace prefix. The older, legacy A\-P\-I uses {\ttfamily theora\-\_\-} or {\ttfamily O\-C\-\_\-} prefixes instead. 
+In general the recommended 1.x API symbols can be distinguished by their {\ttfamily th\_\-} or {\ttfamily TH\_\-} namespace prefix. The older, legacy API uses {\ttfamily theora\_\-} or {\ttfamily OC\_\-} prefixes instead. 

data/vendor/local/share/doc/libtheora-1.1.1/latex/modules.tex

@@ -1,7 +1,7 @@
 \section{Modules}
-Here is a list of all modules\-:\begin{DoxyCompactList}
+Here is a list of all modules:\begin{DoxyCompactList}
 \item \contentsline{section}{Functions Shared by Encode and Decode}{\pageref{group__basefuncs}}{}
-\item \contentsline{section}{Legacy pre-\/1.0 C A\-P\-I}{\pageref{group__oldfuncs}}{}
+\item \contentsline{section}{Legacy pre-\/1.0 C API}{\pageref{group__oldfuncs}}{}
 \item \contentsline{section}{Functions for Decoding}{\pageref{group__decfuncs}}{}
 \item \contentsline{section}{Functions for Encoding}{\pageref{group__encfuncs}}{}
 \end{DoxyCompactList}

data/vendor/local/share/doc/libtheora-1.1.1/latex/refman.tex

@@ -1,42 +1,28 @@
-\documentclass{book}
-\usepackage[a4paper,top=2.5cm,bottom=2.5cm,left=2.5cm,right=2.5cm]{geometry}
+\documentclass[a4paper]{book}
+\usepackage{a4wide}
 \usepackage{makeidx}
-\usepackage{natbib}
 \usepackage{graphicx}
 \usepackage{multicol}
 \usepackage{float}
 \usepackage{listings}
 \usepackage{color}
-\usepackage{ifthen}
-\usepackage[table]{xcolor}
 \usepackage{textcomp}
 \usepackage{alltt}
 \usepackage[utf8]{inputenc}
-\usepackage{mathptmx}
-\usepackage[scaled=.90]{helvet}
-\usepackage{courier}
-\usepackage{sectsty}
-\usepackage{amssymb}
-\usepackage[titles]{tocloft}
 \usepackage{doxygen}
 \lstset{language=C++,inputencoding=utf8,basicstyle=\footnotesize,breaklines=true,breakatwhitespace=true,tabsize=8,numbers=left }
 \makeindex
 \setcounter{tocdepth}{3}
 \renewcommand{\footrulewidth}{0.4pt}
-\renewcommand{\familydefault}{\sfdefault}
-\hfuzz=15pt
-\setlength{\emergencystretch}{15pt}
-\hbadness=750
-\tolerance=750
 \begin{document}
 \begin{titlepage}
 \vspace*{7cm}
 \begin{center}
-{\Large libtheora \\[1ex]\large 1.\-1.\-1 }\\
+{\Large libtheora \\[1ex]\large 1.1.0+svn }\\
 \vspace*{1cm}
-{\large Generated by Doxygen 1.8.1.2}\\
+{\large Generated by Doxygen 1.6.1}\\
 \vspace*{0.5cm}
-{\small Wed Jan 30 2013 23:47:35}\\
+{\small Mon Sep 28 11:02:24 2009}\\
 \end{center}
 \end{titlepage}
 \clearemptydoublepage
@@ -59,20 +45,20 @@
 \include{group__encfuncs}
 \chapter{Data Structure Documentation}
 \input{structth__comment}
-\input{structth__huff__code}
-\input{structth__img__plane}
-\input{structth__info}
-\input{structth__quant__info}
-\input{structth__quant__ranges}
-\input{structth__stripe__callback}
-\input{structtheora__comment}
-\input{structtheora__info}
-\input{structtheora__state}
-\input{structyuv__buffer}
+\include{structth__huff__code}
+\include{structth__img__plane}
+\include{structth__info}
+\include{structth__quant__info}
+\include{structth__quant__ranges}
+\include{structth__stripe__callback}
+\include{structtheora__comment}
+\include{structtheora__info}
+\include{structtheora__state}
+\include{structyuv__buffer}
 \chapter{File Documentation}
 \input{codec_8h}
-\input{theora_8h}
-\input{theoradec_8h}
-\input{theoraenc_8h}
+\include{theora_8h}
+\include{theoradec_8h}
+\include{theoraenc_8h}
 \printindex
 \end{document}

data/vendor/local/share/doc/libtheora-1.1.1/latex/structth__comment.tex

@@ -1,67 +1,53 @@
-\section{th\-\_\-comment Struct Reference}
-\label{structth__comment}\index{th\-\_\-comment@{th\-\_\-comment}}
+\section{th\_\-comment Struct Reference}
+\label{structth__comment}\index{th\_\-comment@{th\_\-comment}}
 
 
 The comment information.  
 
 
-
-
-{\ttfamily \#include $<$codec.\-h$>$}
-
-\subsection*{Data Fields}
+{\ttfamily \#include $<$codec.h$>$}\subsection*{Data Fields}
 \begin{DoxyCompactItemize}
 \item 
-char $\ast$$\ast$ {\bf user\-\_\-comments}
-\begin{DoxyCompactList}\small\item\em The array of comment string vectors. \end{DoxyCompactList}\item 
-int $\ast$ {\bf comment\-\_\-lengths}
-\begin{DoxyCompactList}\small\item\em An array of the corresponding length of each vector, in bytes. \end{DoxyCompactList}\item 
+char $\ast$$\ast$ {\bf user\_\-comments}
+\begin{DoxyCompactList}\small\item\em The array of comment string vectors. \item\end{DoxyCompactList}\item 
+int $\ast$ {\bf comment\_\-lengths}
+\begin{DoxyCompactList}\small\item\em An array of the corresponding length of each vector, in bytes. \item\end{DoxyCompactList}\item 
 int {\bf comments}
-\begin{DoxyCompactList}\small\item\em The total number of comment strings. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em The total number of comment strings. \item\end{DoxyCompactList}\item 
 char $\ast$ {\bf vendor}
-\begin{DoxyCompactList}\small\item\em The null-\/terminated vendor string. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\begin{DoxyCompactList}\small\item\em The null-\/terminated vendor string. \item\end{DoxyCompactList}\end{DoxyCompactItemize}
 
 
 \subsection{Detailed Description}
-The comment information. 
-
-This structure holds the in-\/stream metadata corresponding to the 'comment' header packet. The comment header is meant to be used much like someone jotting a quick note on the label of a video. It should be a short, to the point text note that can be more than a couple words, but not more than a short paragraph.
+The comment information. This structure holds the in-\/stream metadata corresponding to the 'comment' header packet. The comment header is meant to be used much like someone jotting a quick note on the label of a video. It should be a short, to the point text note that can be more than a couple words, but not more than a short paragraph.
 
-The metadata is stored as a series of (tag, value) pairs, in length-\/encoded string vectors. The first occurrence of the '=' character delimits the tag and value. A particular tag may occur more than once, and order is significant. The character set encoding for the strings is always U\-T\-F-\/8, but the tag names are limited to A\-S\-C\-I\-I, and treated as case-\/insensitive. See {\tt the Theora specification}, Section 6.\-3.\-3 for details.
+The metadata is stored as a series of (tag, value) pairs, in length-\/encoded string vectors. The first occurrence of the '=' character delimits the tag and value. 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 names are limited to ASCII, and treated as case-\/insensitive. See {\tt the Theora specification}, Section 6.3.3 for details.
 
-In filling in this structure, \doxyref{th\-\_\-decode\-\_\-headerin()}{p.}{group__decfuncs_ga006d01d36fbe64768c571e6a12b7fc50} will null-\/terminate the user\-\_\-comment strings for safety. However, the bitstream format itself treats them as 8-\/bit clean vectors, possibly containing null characters, and so the length array should be treated as their authoritative length. 
+In filling in this structure, \doxyref{th\_\-decode\_\-headerin()}{p.}{group__decfuncs_ga006d01d36fbe64768c571e6a12b7fc50} will null-\/terminate the user\_\-comment strings for safety. However, the bitstream format itself treats them as 8-\/bit clean vectors, possibly containing null characters, and so the length array should be treated as their authoritative length. 
 
 \subsection{Field Documentation}
-\index{th\-\_\-comment@{th\-\_\-comment}!comment\-\_\-lengths@{comment\-\_\-lengths}}
-\index{comment\-\_\-lengths@{comment\-\_\-lengths}!th_comment@{th\-\_\-comment}}
-\subsubsection[{comment\-\_\-lengths}]{\setlength{\rightskip}{0pt plus 5cm}int$\ast$ th\-\_\-comment\-::comment\-\_\-lengths}\label{structth__comment_a723dc6fdf75757e70e28eea864b10898}
-
-
-An array of the corresponding length of each vector, in bytes. 
-
-\index{th\-\_\-comment@{th\-\_\-comment}!comments@{comments}}
-\index{comments@{comments}!th_comment@{th\-\_\-comment}}
-\subsubsection[{comments}]{\setlength{\rightskip}{0pt plus 5cm}int th\-\_\-comment\-::comments}\label{structth__comment_a5990c34932376f070ad0fc314daaeb78}
-
+\index{th\_\-comment@{th\_\-comment}!comment\_\-lengths@{comment\_\-lengths}}
+\index{comment\_\-lengths@{comment\_\-lengths}!th_comment@{th\_\-comment}}
+\subsubsection[{comment\_\-lengths}]{\setlength{\rightskip}{0pt plus 5cm}int$\ast$ {\bf th\_\-comment::comment\_\-lengths}}\label{structth__comment_a723dc6fdf75757e70e28eea864b10898}
 
-The total number of comment strings. 
 
-\index{th\-\_\-comment@{th\-\_\-comment}!user\-\_\-comments@{user\-\_\-comments}}
-\index{user\-\_\-comments@{user\-\_\-comments}!th_comment@{th\-\_\-comment}}
-\subsubsection[{user\-\_\-comments}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$$\ast$ th\-\_\-comment\-::user\-\_\-comments}\label{structth__comment_ad72830e183e707bb0df423eb73b00de4}
+An array of the corresponding length of each vector, in bytes. \index{th\_\-comment@{th\_\-comment}!comments@{comments}}
+\index{comments@{comments}!th_comment@{th\_\-comment}}
+\subsubsection[{comments}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf th\_\-comment::comments}}\label{structth__comment_a5990c34932376f070ad0fc314daaeb78}
 
 
-The array of comment string vectors. 
+The total number of comment strings. \index{th\_\-comment@{th\_\-comment}!user\_\-comments@{user\_\-comments}}
+\index{user\_\-comments@{user\_\-comments}!th_comment@{th\_\-comment}}
+\subsubsection[{user\_\-comments}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$$\ast$ {\bf th\_\-comment::user\_\-comments}}\label{structth__comment_ad72830e183e707bb0df423eb73b00de4}
 
-\index{th\-\_\-comment@{th\-\_\-comment}!vendor@{vendor}}
-\index{vendor@{vendor}!th_comment@{th\-\_\-comment}}
-\subsubsection[{vendor}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ th\-\_\-comment\-::vendor}\label{structth__comment_a93fbe894d23603f56843be15b0cbdba0}
 
+The array of comment string vectors. \index{th\_\-comment@{th\_\-comment}!vendor@{vendor}}
+\index{vendor@{vendor}!th_comment@{th\_\-comment}}
+\subsubsection[{vendor}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ {\bf th\_\-comment::vendor}}\label{structth__comment_a93fbe894d23603f56843be15b0cbdba0}
 
-The null-\/terminated vendor string. 
 
-This identifies the software used to encode the stream. 
+The null-\/terminated vendor string. This identifies the software used to encode the stream. 
 
-The documentation for this struct was generated from the following file\-:\begin{DoxyCompactItemize}
+The documentation for this struct was generated from the following file:\begin{DoxyCompactItemize}
 \item 
-{\bf codec.\-h}\end{DoxyCompactItemize}
+{\bf codec.h}\end{DoxyCompactItemize}

data/vendor/local/share/doc/libtheora-1.1.1/latex/structth__huff__code.tex

@@ -1,45 +1,35 @@
-\section{th\-\_\-huff\-\_\-code Struct Reference}
-\label{structth__huff__code}\index{th\-\_\-huff\-\_\-code@{th\-\_\-huff\-\_\-code}}
+\section{th\_\-huff\_\-code Struct Reference}
+\label{structth__huff__code}\index{th\_\-huff\_\-code@{th\_\-huff\_\-code}}
 
 
-A Huffman code for a Theora D\-C\-T token.  
+A Huffman code for a Theora DCT token.  
 
 
-
-
-{\ttfamily \#include $<$codec.\-h$>$}
-
-\subsection*{Data Fields}
+{\ttfamily \#include $<$codec.h$>$}\subsection*{Data Fields}
 \begin{DoxyCompactItemize}
 \item 
-ogg\-\_\-uint32\-\_\-t {\bf pattern}
-\begin{DoxyCompactList}\small\item\em The bit pattern for the code, with the L\-Sbit of the pattern aligned in the L\-Sbit of the word. \end{DoxyCompactList}\item 
+ogg\_\-uint32\_\-t {\bf pattern}
+\begin{DoxyCompactList}\small\item\em The bit pattern for the code, with the LSbit of the pattern aligned in the LSbit of the word. \item\end{DoxyCompactList}\item 
 int {\bf nbits}
-\begin{DoxyCompactList}\small\item\em The number of bits in the code. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\begin{DoxyCompactList}\small\item\em The number of bits in the code. \item\end{DoxyCompactList}\end{DoxyCompactItemize}
 
 
 \subsection{Detailed Description}
-A Huffman code for a Theora D\-C\-T token. 
-
-Each set of Huffman codes in a given table must form a complete, prefix-\/free code. There is no requirement that all the tokens in a table have a valid code, but the current encoder is not optimized to take advantage of this. If each of the five grouops of 16 tables does not contain at least one table with a code for every token, then the encoder may fail to encode certain frames. The complete table in the first group of 16 does not have to be in the same place as the complete table in the other groups, but the complete tables in the remaining four groups must all be in the same place. 
+A Huffman code for a Theora DCT token. Each set of Huffman codes in a given table must form a complete, prefix-\/free code. There is no requirement that all the tokens in a table have a valid code, but the current encoder is not optimized to take advantage of this. If each of the five grouops of 16 tables does not contain at least one table with a code for every token, then the encoder may fail to encode certain frames. The complete table in the first group of 16 does not have to be in the same place as the complete table in the other groups, but the complete tables in the remaining four groups must all be in the same place. 
 
 \subsection{Field Documentation}
-\index{th\-\_\-huff\-\_\-code@{th\-\_\-huff\-\_\-code}!nbits@{nbits}}
-\index{nbits@{nbits}!th_huff_code@{th\-\_\-huff\-\_\-code}}
-\subsubsection[{nbits}]{\setlength{\rightskip}{0pt plus 5cm}int th\-\_\-huff\-\_\-code\-::nbits}\label{structth__huff__code_aaf97b8f2f90042f7bc136a7b2bc35e35}
-
-
-The number of bits in the code. 
-
-This must be between 0 and 32, inclusive. \index{th\-\_\-huff\-\_\-code@{th\-\_\-huff\-\_\-code}!pattern@{pattern}}
-\index{pattern@{pattern}!th_huff_code@{th\-\_\-huff\-\_\-code}}
-\subsubsection[{pattern}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-huff\-\_\-code\-::pattern}\label{structth__huff__code_a6dd29e3aa5a0c5a2dd5ce1f45b1162b4}
+\index{th\_\-huff\_\-code@{th\_\-huff\_\-code}!nbits@{nbits}}
+\index{nbits@{nbits}!th_huff_code@{th\_\-huff\_\-code}}
+\subsubsection[{nbits}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf th\_\-huff\_\-code::nbits}}\label{structth__huff__code_aaf97b8f2f90042f7bc136a7b2bc35e35}
 
 
-The bit pattern for the code, with the L\-Sbit of the pattern aligned in the L\-Sbit of the word. 
+The number of bits in the code. This must be between 0 and 32, inclusive. \index{th\_\-huff\_\-code@{th\_\-huff\_\-code}!pattern@{pattern}}
+\index{pattern@{pattern}!th_huff_code@{th\_\-huff\_\-code}}
+\subsubsection[{pattern}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-huff\_\-code::pattern}}\label{structth__huff__code_a6dd29e3aa5a0c5a2dd5ce1f45b1162b4}
 
 
+The bit pattern for the code, with the LSbit of the pattern aligned in the LSbit of the word. 
 
-The documentation for this struct was generated from the following file\-:\begin{DoxyCompactItemize}
+The documentation for this struct was generated from the following file:\begin{DoxyCompactItemize}
 \item 
-{\bf codec.\-h}\end{DoxyCompactItemize}
+{\bf codec.h}\end{DoxyCompactItemize}

data/vendor/local/share/doc/libtheora-1.1.1/latex/structth__img__plane.tex

@@ -1,63 +1,49 @@
-\section{th\-\_\-img\-\_\-plane Struct Reference}
-\label{structth__img__plane}\index{th\-\_\-img\-\_\-plane@{th\-\_\-img\-\_\-plane}}
+\section{th\_\-img\_\-plane Struct Reference}
+\label{structth__img__plane}\index{th\_\-img\_\-plane@{th\_\-img\_\-plane}}
 
 
 A buffer for a single color plane in an uncompressed image.  
 
 
-
-
-{\ttfamily \#include $<$codec.\-h$>$}
-
-\subsection*{Data Fields}
+{\ttfamily \#include $<$codec.h$>$}\subsection*{Data Fields}
 \begin{DoxyCompactItemize}
 \item 
 int {\bf width}
-\begin{DoxyCompactList}\small\item\em The width of this plane. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em The width of this plane. \item\end{DoxyCompactList}\item 
 int {\bf height}
-\begin{DoxyCompactList}\small\item\em The height of this plane. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em The height of this plane. \item\end{DoxyCompactList}\item 
 int {\bf stride}
-\begin{DoxyCompactList}\small\item\em The offset in bytes between successive rows. \end{DoxyCompactList}\item 
+\begin{DoxyCompactList}\small\item\em The offset in bytes between successive rows. \item\end{DoxyCompactList}\item 
 unsigned char $\ast$ {\bf data}
-\begin{DoxyCompactList}\small\item\em A pointer to the beginning of the first row. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\begin{DoxyCompactList}\small\item\em A pointer to the beginning of the first row. \item\end{DoxyCompactList}\end{DoxyCompactItemize}
 
 
 \subsection{Detailed Description}
-A buffer for a single color plane in an uncompressed image. 
-
-This contains the image data in a left-\/to-\/right, top-\/down format. Each row of pixels is stored contiguously in memory, but successive rows need not be. Use {\itshape stride} to compute the offset of the next row. The encoder accepts both positive {\itshape stride} values (top-\/down in memory) and negative (bottom-\/up in memory). The decoder currently always generates images with positive strides. 
+A buffer for a single color plane in an uncompressed image. This contains the image data in a left-\/to-\/right, top-\/down format. Each row of pixels is stored contiguously in memory, but successive rows need not be. Use {\itshape stride\/} to compute the offset of the next row. The encoder accepts both positive {\itshape stride\/} values (top-\/down in memory) and negative (bottom-\/up in memory). The decoder currently always generates images with positive strides. 
 
 \subsection{Field Documentation}
-\index{th\-\_\-img\-\_\-plane@{th\-\_\-img\-\_\-plane}!data@{data}}
-\index{data@{data}!th_img_plane@{th\-\_\-img\-\_\-plane}}
-\subsubsection[{data}]{\setlength{\rightskip}{0pt plus 5cm}unsigned char$\ast$ th\-\_\-img\-\_\-plane\-::data}\label{structth__img__plane_af8133681516ce88b5a201c1b4b7e6ba2}
-
+\index{th\_\-img\_\-plane@{th\_\-img\_\-plane}!data@{data}}
+\index{data@{data}!th_img_plane@{th\_\-img\_\-plane}}
+\subsubsection[{data}]{\setlength{\rightskip}{0pt plus 5cm}unsigned char$\ast$ {\bf th\_\-img\_\-plane::data}}\label{structth__img__plane_af8133681516ce88b5a201c1b4b7e6ba2}
 
-A pointer to the beginning of the first row. 
 
-\index{th\-\_\-img\-\_\-plane@{th\-\_\-img\-\_\-plane}!height@{height}}
-\index{height@{height}!th_img_plane@{th\-\_\-img\-\_\-plane}}
-\subsubsection[{height}]{\setlength{\rightskip}{0pt plus 5cm}int th\-\_\-img\-\_\-plane\-::height}\label{structth__img__plane_a21aea1367894468de489d529d7eaf44d}
+A pointer to the beginning of the first row. \index{th\_\-img\_\-plane@{th\_\-img\_\-plane}!height@{height}}
+\index{height@{height}!th_img_plane@{th\_\-img\_\-plane}}
+\subsubsection[{height}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf th\_\-img\_\-plane::height}}\label{structth__img__plane_a21aea1367894468de489d529d7eaf44d}
 
 
-The height of this plane. 
+The height of this plane. \index{th\_\-img\_\-plane@{th\_\-img\_\-plane}!stride@{stride}}
+\index{stride@{stride}!th_img_plane@{th\_\-img\_\-plane}}
+\subsubsection[{stride}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf th\_\-img\_\-plane::stride}}\label{structth__img__plane_ab1100f071ffee3b37e07e3222f819bad}
 
-\index{th\-\_\-img\-\_\-plane@{th\-\_\-img\-\_\-plane}!stride@{stride}}
-\index{stride@{stride}!th_img_plane@{th\-\_\-img\-\_\-plane}}
-\subsubsection[{stride}]{\setlength{\rightskip}{0pt plus 5cm}int th\-\_\-img\-\_\-plane\-::stride}\label{structth__img__plane_ab1100f071ffee3b37e07e3222f819bad}
 
-
-The offset in bytes between successive rows. 
-
-\index{th\-\_\-img\-\_\-plane@{th\-\_\-img\-\_\-plane}!width@{width}}
-\index{width@{width}!th_img_plane@{th\-\_\-img\-\_\-plane}}
-\subsubsection[{width}]{\setlength{\rightskip}{0pt plus 5cm}int th\-\_\-img\-\_\-plane\-::width}\label{structth__img__plane_a58cc297a99cd4594c3d30e56f2ed6b74}
+The offset in bytes between successive rows. \index{th\_\-img\_\-plane@{th\_\-img\_\-plane}!width@{width}}
+\index{width@{width}!th_img_plane@{th\_\-img\_\-plane}}
+\subsubsection[{width}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf th\_\-img\_\-plane::width}}\label{structth__img__plane_a58cc297a99cd4594c3d30e56f2ed6b74}
 
 
 The width of this plane. 
 
-
-
-The documentation for this struct was generated from the following file\-:\begin{DoxyCompactItemize}
+The documentation for this struct was generated from the following file:\begin{DoxyCompactItemize}
 \item 
-{\bf codec.\-h}\end{DoxyCompactItemize}
+{\bf codec.h}\end{DoxyCompactItemize}

data/vendor/local/share/doc/libtheora-1.1.1/latex/structth__info.tex

@@ -1,189 +1,164 @@
-\section{th\-\_\-info Struct Reference}
-\label{structth__info}\index{th\-\_\-info@{th\-\_\-info}}
+\section{th\_\-info Struct Reference}
+\label{structth__info}\index{th\_\-info@{th\_\-info}}
 
 
 Theora bitstream information.  
 
 
-
-
-{\ttfamily \#include $<$codec.\-h$>$}
-
-\subsection*{Data Fields}
+{\ttfamily \#include $<$codec.h$>$}\subsection*{Data Fields}
 \begin{DoxyCompactItemize}
 \item 
-ogg\-\_\-uint32\-\_\-t {\bf frame\-\_\-width}
-\begin{DoxyCompactList}\small\item\em The encoded frame width. \end{DoxyCompactList}\item 
-ogg\-\_\-uint32\-\_\-t {\bf frame\-\_\-height}
-\begin{DoxyCompactList}\small\item\em The encoded frame height. \end{DoxyCompactList}\item 
-ogg\-\_\-uint32\-\_\-t {\bf pic\-\_\-width}
-\begin{DoxyCompactList}\small\item\em The displayed picture width. \end{DoxyCompactList}\item 
-ogg\-\_\-uint32\-\_\-t {\bf pic\-\_\-height}
-\begin{DoxyCompactList}\small\item\em The displayed picture height. \end{DoxyCompactList}\item 
-ogg\-\_\-uint32\-\_\-t {\bf pic\-\_\-x}
-\begin{DoxyCompactList}\small\item\em The X offset of the displayed picture. \end{DoxyCompactList}\item 
-ogg\-\_\-uint32\-\_\-t {\bf pic\-\_\-y}
-\begin{DoxyCompactList}\small\item\em The Y offset of the displayed picture. \end{DoxyCompactList}\item 
-{\bf th\-\_\-colorspace} {\bf colorspace}
-\begin{DoxyCompactList}\small\item\em The color space. \end{DoxyCompactList}\item 
-{\bf th\-\_\-pixel\-\_\-fmt} {\bf pixel\-\_\-fmt}
-\begin{DoxyCompactList}\small\item\em The pixel format. \end{DoxyCompactList}\item 
-int {\bf target\-\_\-bitrate}
-\begin{DoxyCompactList}\small\item\em The target bit-\/rate in bits per second. \end{DoxyCompactList}\item 
+ogg\_\-uint32\_\-t {\bf frame\_\-width}
+\begin{DoxyCompactList}\small\item\em The encoded frame width. \item\end{DoxyCompactList}\item 
+ogg\_\-uint32\_\-t {\bf frame\_\-height}
+\begin{DoxyCompactList}\small\item\em The encoded frame height. \item\end{DoxyCompactList}\item 
+ogg\_\-uint32\_\-t {\bf pic\_\-width}
+\begin{DoxyCompactList}\small\item\em The displayed picture width. \item\end{DoxyCompactList}\item 
+ogg\_\-uint32\_\-t {\bf pic\_\-height}
+\begin{DoxyCompactList}\small\item\em The displayed picture height. \item\end{DoxyCompactList}\item 
+ogg\_\-uint32\_\-t {\bf pic\_\-x}
+\begin{DoxyCompactList}\small\item\em The X offset of the displayed picture. \item\end{DoxyCompactList}\item 
+ogg\_\-uint32\_\-t {\bf pic\_\-y}
+\begin{DoxyCompactList}\small\item\em The Y offset of the displayed picture. \item\end{DoxyCompactList}\item 
+{\bf th\_\-colorspace} {\bf colorspace}
+\begin{DoxyCompactList}\small\item\em The color space. \item\end{DoxyCompactList}\item 
+{\bf th\_\-pixel\_\-fmt} {\bf pixel\_\-fmt}
+\begin{DoxyCompactList}\small\item\em The pixel format. \item\end{DoxyCompactList}\item 
+int {\bf target\_\-bitrate}
+\begin{DoxyCompactList}\small\item\em The target bit-\/rate in bits per second. \item\end{DoxyCompactList}\item 
 int {\bf quality}
-\begin{DoxyCompactList}\small\item\em The target quality level. \end{DoxyCompactList}\item 
-int {\bf keyframe\-\_\-granule\-\_\-shift}
-\begin{DoxyCompactList}\small\item\em The amount to shift to extract the last keyframe number from the granule position. \end{DoxyCompactList}\end{DoxyCompactItemize}
+\begin{DoxyCompactList}\small\item\em The target quality level. \item\end{DoxyCompactList}\item 
+int {\bf keyframe\_\-granule\_\-shift}
+\begin{DoxyCompactList}\small\item\em The amount to shift to extract the last keyframe number from the granule position. \item\end{DoxyCompactList}\end{DoxyCompactItemize}
 \begin{Indent}{\bf Theora version}\par
-{\em Bitstream version information.}\begin{DoxyCompactItemize}
+{\em \label{_amgrpf735645ddddaaf44dc0647da0e883f6c}
+Bitstream version information.}\begin{DoxyCompactItemize}
 \item 
-unsigned char {\bf version\-\_\-major}
+unsigned char {\bf version\_\-major}
 \item 
-unsigned char {\bf version\-\_\-minor}
+unsigned char {\bf version\_\-minor}
 \item 
-unsigned char {\bf version\-\_\-subminor}
+unsigned char {\bf version\_\-subminor}
 \end{DoxyCompactItemize}
 \end{Indent}
 \begin{Indent}{\bf Frame rate}\par
-{\em The frame rate, as a fraction.
+{\em \label{_amgrp801309c4a0e25a4db3fe5739b322b0a7}
+The frame rate, as a fraction.
 
 If either is 0, the frame rate is undefined. }\begin{DoxyCompactItemize}
 \item 
-ogg\-\_\-uint32\-\_\-t {\bf fps\-\_\-numerator}
+ogg\_\-uint32\_\-t {\bf fps\_\-numerator}
 \item 
-ogg\-\_\-uint32\-\_\-t {\bf fps\-\_\-denominator}
+ogg\_\-uint32\_\-t {\bf fps\_\-denominator}
 \end{DoxyCompactItemize}
 \end{Indent}
 \begin{Indent}{\bf Aspect ratio}\par
-{\em The aspect ratio of the pixels.
+{\em \label{_amgrpdeca19914b5126815a2220f15d067c9b}
+The aspect ratio of the pixels.
 
-If either value is zero, the aspect ratio is undefined. If not specified by any external means, 1\-:1 should be assumed. The aspect ratio of the full picture can be computed as 
+If either value is zero, the aspect ratio is undefined. If not specified by any external means, 1:1 should be assumed. The aspect ratio of the full picture can be computed as 
 \begin{DoxyCode}
-aspect_numerator*pic_width/(aspect_denominator*pic_height).
+  aspect_numerator*pic_width/(aspect_denominator*pic_height).
 \end{DoxyCode}
  }\begin{DoxyCompactItemize}
 \item 
-ogg\-\_\-uint32\-\_\-t {\bf aspect\-\_\-numerator}
+ogg\_\-uint32\_\-t {\bf aspect\_\-numerator}
 \item 
-ogg\-\_\-uint32\-\_\-t {\bf aspect\-\_\-denominator}
+ogg\_\-uint32\_\-t {\bf aspect\_\-denominator}
 \end{DoxyCompactItemize}
 \end{Indent}
 
 
 \subsection{Detailed Description}
-Theora bitstream information. 
-
-This contains the basic playback parameters for a stream, and corresponds to the initial 'info' header packet. To initialize an encoder, the application fills in this structure and passes it to \doxyref{th\-\_\-encode\-\_\-alloc()}{p.}{group__encfuncs_gaa91e47bc9dd5f6ee52045bd7b815e5a7}. A default encoding mode is chosen based on the values of the \doxyref{quality}{p.}{structth__info_aa4cdcf96cb46b256821993e9a830ee02} and \doxyref{target\-\_\-bitrate}{p.}{structth__info_a1d9c8d768a4ae623269f5bd8f6f7a015} fields. On decode, it is filled in by \doxyref{th\-\_\-decode\-\_\-headerin()}{p.}{group__decfuncs_ga006d01d36fbe64768c571e6a12b7fc50}, and then passed to \doxyref{th\-\_\-decode\-\_\-alloc()}{p.}{group__decfuncs_ga0ef07a9a97849054aa606c595a2d807e}.
+Theora bitstream information. This contains the basic playback parameters for a stream, and corresponds to the initial 'info' header packet. To initialize an encoder, the application fills in this structure and passes it to \doxyref{th\_\-encode\_\-alloc()}{p.}{group__encfuncs_gaa91e47bc9dd5f6ee52045bd7b815e5a7}. A default encoding mode is chosen based on the values of the \doxyref{quality}{p.}{structth__info_aa4cdcf96cb46b256821993e9a830ee02} and \doxyref{target\_\-bitrate}{p.}{structth__info_a1d9c8d768a4ae623269f5bd8f6f7a015} fields. On decode, it is filled in by \doxyref{th\_\-decode\_\-headerin()}{p.}{group__decfuncs_ga006d01d36fbe64768c571e6a12b7fc50}, and then passed to \doxyref{th\_\-decode\_\-alloc()}{p.}{group__decfuncs_ga0ef07a9a97849054aa606c595a2d807e}.
 
-Encoded Theora frames must be a multiple of 16 in size; this is what the \doxyref{frame\-\_\-width}{p.}{structth__info_a6b8087a4d831da53011a43b8d74087a0} and \doxyref{frame\-\_\-height}{p.}{structth__info_a6b1adc3a16a8336a72692b0a5937214c} members represent. To handle arbitrary picture sizes, a crop rectangle is specified in the \doxyref{pic\-\_\-x}{p.}{structth__info_a5b3f834bcf141564e7bb14f49101870f}, \doxyref{pic\-\_\-y}{p.}{structth__info_a8aacc575cab2dfe3735001c2ad32aa14}, \doxyref{pic\-\_\-width}{p.}{structth__info_a5048edf77b141dd3e9a92ca85e317345} and \doxyref{pic\-\_\-height}{p.}{structth__info_a775178474283c5990ba73f9ba7f6b88b} members.
+Encoded Theora frames must be a multiple of 16 in size; this is what the \doxyref{frame\_\-width}{p.}{structth__info_a6b8087a4d831da53011a43b8d74087a0} and \doxyref{frame\_\-height}{p.}{structth__info_a6b1adc3a16a8336a72692b0a5937214c} members represent. To handle arbitrary picture sizes, a crop rectangle is specified in the \doxyref{pic\_\-x}{p.}{structth__info_a5b3f834bcf141564e7bb14f49101870f}, \doxyref{pic\_\-y}{p.}{structth__info_a8aacc575cab2dfe3735001c2ad32aa14}, \doxyref{pic\_\-width}{p.}{structth__info_a5048edf77b141dd3e9a92ca85e317345} and \doxyref{pic\_\-height}{p.}{structth__info_a775178474283c5990ba73f9ba7f6b88b} members.
 
-All frame buffers contain pointers to the full, padded frame. However, the current encoder {\itshape will not} reference pixels outside of the cropped picture region, and the application does not need to fill them in. The decoder {\itshape will} allocate storage for a full frame, but the application {\itshape should not} rely on the padding containing sensible data.
+All frame buffers contain pointers to the full, padded frame. However, the current encoder {\itshape will not\/} reference pixels outside of the cropped picture region, and the application does not need to fill them in. The decoder {\itshape will\/} allocate storage for a full frame, but the application {\itshape should not\/} rely on the padding containing sensible data.
 
-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. See {\tt the Theora specification}, Section 4.\-4, for more details.
+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. See {\tt the Theora specification}, Section 4.4, for more details.
 
 Frame rate, in frames per second, is stored as a rational fraction, as is the pixel aspect ratio. Note that this refers to the aspect ratio of the individual pixels, not of the overall frame itself. The frame aspect ratio can be computed from pixel aspect ratio using the image dimensions. 
 
 \subsection{Field Documentation}
-\index{th\-\_\-info@{th\-\_\-info}!aspect\-\_\-denominator@{aspect\-\_\-denominator}}
-\index{aspect\-\_\-denominator@{aspect\-\_\-denominator}!th_info@{th\-\_\-info}}
-\subsubsection[{aspect\-\_\-denominator}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::aspect\-\_\-denominator}\label{structth__info_a04c0bd477222d747a76085d8720322e2}
-\index{th\-\_\-info@{th\-\_\-info}!aspect\-\_\-numerator@{aspect\-\_\-numerator}}
-\index{aspect\-\_\-numerator@{aspect\-\_\-numerator}!th_info@{th\-\_\-info}}
-\subsubsection[{aspect\-\_\-numerator}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::aspect\-\_\-numerator}\label{structth__info_a5be65dac9f75e37864cf73dd543570cd}
-\index{th\-\_\-info@{th\-\_\-info}!colorspace@{colorspace}}
-\index{colorspace@{colorspace}!th_info@{th\-\_\-info}}
-\subsubsection[{colorspace}]{\setlength{\rightskip}{0pt plus 5cm}{\bf th\-\_\-colorspace} th\-\_\-info\-::colorspace}\label{structth__info_a8c7828cd0e023e9d21108160d53659a6}
-
-
-The color space. 
-
-\index{th\-\_\-info@{th\-\_\-info}!fps\-\_\-denominator@{fps\-\_\-denominator}}
-\index{fps\-\_\-denominator@{fps\-\_\-denominator}!th_info@{th\-\_\-info}}
-\subsubsection[{fps\-\_\-denominator}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::fps\-\_\-denominator}\label{structth__info_aa619408f70c03935529f1d3eda7a3ec2}
-\index{th\-\_\-info@{th\-\_\-info}!fps\-\_\-numerator@{fps\-\_\-numerator}}
-\index{fps\-\_\-numerator@{fps\-\_\-numerator}!th_info@{th\-\_\-info}}
-\subsubsection[{fps\-\_\-numerator}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::fps\-\_\-numerator}\label{structth__info_a20606e61676f585a7e59cfc96de190a5}
-\index{th\-\_\-info@{th\-\_\-info}!frame\-\_\-height@{frame\-\_\-height}}
-\index{frame\-\_\-height@{frame\-\_\-height}!th_info@{th\-\_\-info}}
-\subsubsection[{frame\-\_\-height}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::frame\-\_\-height}\label{structth__info_a6b1adc3a16a8336a72692b0a5937214c}
-
-
-The encoded frame height. 
-
-This must be a multiple of 16, and less than 1048576. \index{th\-\_\-info@{th\-\_\-info}!frame\-\_\-width@{frame\-\_\-width}}
-\index{frame\-\_\-width@{frame\-\_\-width}!th_info@{th\-\_\-info}}
-\subsubsection[{frame\-\_\-width}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::frame\-\_\-width}\label{structth__info_a6b8087a4d831da53011a43b8d74087a0}
-
-
-The encoded frame width. 
-
-This must be a multiple of 16, and less than 1048576. \index{th\-\_\-info@{th\-\_\-info}!keyframe\-\_\-granule\-\_\-shift@{keyframe\-\_\-granule\-\_\-shift}}
-\index{keyframe\-\_\-granule\-\_\-shift@{keyframe\-\_\-granule\-\_\-shift}!th_info@{th\-\_\-info}}
-\subsubsection[{keyframe\-\_\-granule\-\_\-shift}]{\setlength{\rightskip}{0pt plus 5cm}int th\-\_\-info\-::keyframe\-\_\-granule\-\_\-shift}\label{structth__info_a693ca4ab11fbc0c3f32594b4bb8766ed}
-
-
-The amount to shift to extract the last keyframe number from the granule position. 
+\index{th\_\-info@{th\_\-info}!aspect\_\-denominator@{aspect\_\-denominator}}
+\index{aspect\_\-denominator@{aspect\_\-denominator}!th_info@{th\_\-info}}
+\subsubsection[{aspect\_\-denominator}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::aspect\_\-denominator}}\label{structth__info_a04c0bd477222d747a76085d8720322e2}
+\index{th\_\-info@{th\_\-info}!aspect\_\-numerator@{aspect\_\-numerator}}
+\index{aspect\_\-numerator@{aspect\_\-numerator}!th_info@{th\_\-info}}
+\subsubsection[{aspect\_\-numerator}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::aspect\_\-numerator}}\label{structth__info_a5be65dac9f75e37864cf73dd543570cd}
+\index{th\_\-info@{th\_\-info}!colorspace@{colorspace}}
+\index{colorspace@{colorspace}!th_info@{th\_\-info}}
+\subsubsection[{colorspace}]{\setlength{\rightskip}{0pt plus 5cm}{\bf th\_\-colorspace} {\bf th\_\-info::colorspace}}\label{structth__info_a8c7828cd0e023e9d21108160d53659a6}
 
-This can be at most 31. \doxyref{th\-\_\-info\-\_\-init()}{p.}{group__basefuncs_ga430d9c605816a6ca0bdce3a0b965b926} will set this to a default value (currently {\ttfamily 6}, which is good for streaming applications), but you can set it to 0 to make every frame a keyframe. The maximum distance between key frames is {\ttfamily 1$<$$<$\doxyref{keyframe\-\_\-granule\-\_\-shift}{p.}{structth__info_a693ca4ab11fbc0c3f32594b4bb8766ed}}. The keyframe frequency can be more finely controlled with \doxyref{T\-H\-\_\-\-E\-N\-C\-C\-T\-L\-\_\-\-S\-E\-T\-\_\-\-K\-E\-Y\-F\-R\-A\-M\-E\-\_\-\-F\-R\-E\-Q\-U\-E\-N\-C\-Y\-\_\-\-F\-O\-R\-C\-E}{p.}{theoraenc_8h_a27e755e15b4b5604c54974b304037a49}, which can also be adjusted during encoding (for example, to force the next frame to be a keyframe), but it cannot be set larger than the amount permitted by this field after the headers have been output. \index{th\-\_\-info@{th\-\_\-info}!pic\-\_\-height@{pic\-\_\-height}}
-\index{pic\-\_\-height@{pic\-\_\-height}!th_info@{th\-\_\-info}}
-\subsubsection[{pic\-\_\-height}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::pic\-\_\-height}\label{structth__info_a775178474283c5990ba73f9ba7f6b88b}
 
+The color space. \index{th\_\-info@{th\_\-info}!fps\_\-denominator@{fps\_\-denominator}}
+\index{fps\_\-denominator@{fps\_\-denominator}!th_info@{th\_\-info}}
+\subsubsection[{fps\_\-denominator}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::fps\_\-denominator}}\label{structth__info_aa619408f70c03935529f1d3eda7a3ec2}
+\index{th\_\-info@{th\_\-info}!fps\_\-numerator@{fps\_\-numerator}}
+\index{fps\_\-numerator@{fps\_\-numerator}!th_info@{th\_\-info}}
+\subsubsection[{fps\_\-numerator}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::fps\_\-numerator}}\label{structth__info_a20606e61676f585a7e59cfc96de190a5}
+\index{th\_\-info@{th\_\-info}!frame\_\-height@{frame\_\-height}}
+\index{frame\_\-height@{frame\_\-height}!th_info@{th\_\-info}}
+\subsubsection[{frame\_\-height}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::frame\_\-height}}\label{structth__info_a6b1adc3a16a8336a72692b0a5937214c}
 
-The displayed picture height. 
 
-This must be no larger than height. \index{th\-\_\-info@{th\-\_\-info}!pic\-\_\-width@{pic\-\_\-width}}
-\index{pic\-\_\-width@{pic\-\_\-width}!th_info@{th\-\_\-info}}
-\subsubsection[{pic\-\_\-width}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::pic\-\_\-width}\label{structth__info_a5048edf77b141dd3e9a92ca85e317345}
+The encoded frame height. This must be a multiple of 16, and less than 1048576. \index{th\_\-info@{th\_\-info}!frame\_\-width@{frame\_\-width}}
+\index{frame\_\-width@{frame\_\-width}!th_info@{th\_\-info}}
+\subsubsection[{frame\_\-width}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::frame\_\-width}}\label{structth__info_a6b8087a4d831da53011a43b8d74087a0}
 
 
-The displayed picture width. 
+The encoded frame width. This must be a multiple of 16, and less than 1048576. \index{th\_\-info@{th\_\-info}!keyframe\_\-granule\_\-shift@{keyframe\_\-granule\_\-shift}}
+\index{keyframe\_\-granule\_\-shift@{keyframe\_\-granule\_\-shift}!th_info@{th\_\-info}}
+\subsubsection[{keyframe\_\-granule\_\-shift}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf th\_\-info::keyframe\_\-granule\_\-shift}}\label{structth__info_a693ca4ab11fbc0c3f32594b4bb8766ed}
 
-This must be no larger than width. \index{th\-\_\-info@{th\-\_\-info}!pic\-\_\-x@{pic\-\_\-x}}
-\index{pic\-\_\-x@{pic\-\_\-x}!th_info@{th\-\_\-info}}
-\subsubsection[{pic\-\_\-x}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::pic\-\_\-x}\label{structth__info_a5b3f834bcf141564e7bb14f49101870f}
 
+The amount to shift to extract the last keyframe number from the granule position. This can be at most 31. \doxyref{th\_\-info\_\-init()}{p.}{group__basefuncs_ga430d9c605816a6ca0bdce3a0b965b926} will set this to a default value (currently {\ttfamily 6}, which is good for streaming applications), but you can set it to 0 to make every frame a keyframe. The maximum distance between key frames is {\ttfamily 1$<$$<$\doxyref{keyframe\_\-granule\_\-shift}{p.}{structth__info_a693ca4ab11fbc0c3f32594b4bb8766ed}}. The keyframe frequency can be more finely controlled with \doxyref{TH\_\-ENCCTL\_\-SET\_\-KEYFRAME\_\-FREQUENCY\_\-FORCE}{p.}{theoraenc_8h_a27e755e15b4b5604c54974b304037a49}, which can also be adjusted during encoding (for example, to force the next frame to be a keyframe), but it cannot be set larger than the amount permitted by this field after the headers have been output. \index{th\_\-info@{th\_\-info}!pic\_\-height@{pic\_\-height}}
+\index{pic\_\-height@{pic\_\-height}!th_info@{th\_\-info}}
+\subsubsection[{pic\_\-height}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::pic\_\-height}}\label{structth__info_a775178474283c5990ba73f9ba7f6b88b}
 
-The X offset of the displayed picture. 
 
-This must be no larger than \doxyref{frame\-\_\-width}{p.}{structth__info_a6b8087a4d831da53011a43b8d74087a0}-\/\doxyref{pic\-\_\-width}{p.}{structth__info_a5048edf77b141dd3e9a92ca85e317345} or 255, whichever is smaller. \index{th\-\_\-info@{th\-\_\-info}!pic\-\_\-y@{pic\-\_\-y}}
-\index{pic\-\_\-y@{pic\-\_\-y}!th_info@{th\-\_\-info}}
-\subsubsection[{pic\-\_\-y}]{\setlength{\rightskip}{0pt plus 5cm}ogg\-\_\-uint32\-\_\-t th\-\_\-info\-::pic\-\_\-y}\label{structth__info_a8aacc575cab2dfe3735001c2ad32aa14}
+The displayed picture height. This must be no larger than height. \index{th\_\-info@{th\_\-info}!pic\_\-width@{pic\_\-width}}
+\index{pic\_\-width@{pic\_\-width}!th_info@{th\_\-info}}
+\subsubsection[{pic\_\-width}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::pic\_\-width}}\label{structth__info_a5048edf77b141dd3e9a92ca85e317345}
 
 
-The Y offset of the displayed picture. 
+The displayed picture width. This must be no larger than width. \index{th\_\-info@{th\_\-info}!pic\_\-x@{pic\_\-x}}
+\index{pic\_\-x@{pic\_\-x}!th_info@{th\_\-info}}
+\subsubsection[{pic\_\-x}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::pic\_\-x}}\label{structth__info_a5b3f834bcf141564e7bb14f49101870f}
 
-This must be no larger than \doxyref{frame\-\_\-height}{p.}{structth__info_a6b1adc3a16a8336a72692b0a5937214c}-\/\doxyref{pic\-\_\-height}{p.}{structth__info_a775178474283c5990ba73f9ba7f6b88b}, and \doxyref{frame\-\_\-height}{p.}{structth__info_a6b1adc3a16a8336a72692b0a5937214c}-\/\doxyref{pic\-\_\-height}{p.}{structth__info_a775178474283c5990ba73f9ba7f6b88b}-\/\doxyref{pic\-\_\-y}{p.}{structth__info_a8aacc575cab2dfe3735001c2ad32aa14} must be no larger than 255. This slightly funny restriction is due to the fact that the offset is specified from the top of the image for consistency with the standard graphics left-\/handed coordinate system used throughout this A\-P\-I, while it is stored in the encoded stream as an offset from the bottom. \index{th\-\_\-info@{th\-\_\-info}!pixel\-\_\-fmt@{pixel\-\_\-fmt}}
-\index{pixel\-\_\-fmt@{pixel\-\_\-fmt}!th_info@{th\-\_\-info}}
-\subsubsection[{pixel\-\_\-fmt}]{\setlength{\rightskip}{0pt plus 5cm}{\bf th\-\_\-pixel\-\_\-fmt} th\-\_\-info\-::pixel\-\_\-fmt}\label{structth__info_a2301388ef3755c41ab12fd144c1fc54e}
 
+The X offset of the displayed picture. This must be no larger than \doxyref{frame\_\-width}{p.}{structth__info_a6b8087a4d831da53011a43b8d74087a0}-\/\doxyref{pic\_\-width}{p.}{structth__info_a5048edf77b141dd3e9a92ca85e317345} or 255, whichever is smaller. \index{th\_\-info@{th\_\-info}!pic\_\-y@{pic\_\-y}}
+\index{pic\_\-y@{pic\_\-y}!th_info@{th\_\-info}}
+\subsubsection[{pic\_\-y}]{\setlength{\rightskip}{0pt plus 5cm}ogg\_\-uint32\_\-t {\bf th\_\-info::pic\_\-y}}\label{structth__info_a8aacc575cab2dfe3735001c2ad32aa14}
 
-The pixel format. 
 
-\index{th\-\_\-info@{th\-\_\-info}!quality@{quality}}
-\index{quality@{quality}!th_info@{th\-\_\-info}}
-\subsubsection[{quality}]{\setlength{\rightskip}{0pt plus 5cm}int th\-\_\-info\-::quality}\label{structth__info_aa4cdcf96cb46b256821993e9a830ee02}
+The Y offset of the displayed picture. This must be no larger than \doxyref{frame\_\-height}{p.}{structth__info_a6b1adc3a16a8336a72692b0a5937214c}-\/\doxyref{pic\_\-height}{p.}{structth__info_a775178474283c5990ba73f9ba7f6b88b}, and \doxyref{frame\_\-height}{p.}{structth__info_a6b1adc3a16a8336a72692b0a5937214c}-\/\doxyref{pic\_\-height}{p.}{structth__info_a775178474283c5990ba73f9ba7f6b88b}-\/\doxyref{pic\_\-y}{p.}{structth__info_a8aacc575cab2dfe3735001c2ad32aa14} must be no larger than 255. This slightly funny restriction is due to the fact that the offset is specified from the top of the image for consistency with the standard graphics left-\/handed coordinate system used throughout this API, while it is stored in the encoded stream as an offset from the bottom. \index{th\_\-info@{th\_\-info}!pixel\_\-fmt@{pixel\_\-fmt}}
+\index{pixel\_\-fmt@{pixel\_\-fmt}!th_info@{th\_\-info}}
+\subsubsection[{pixel\_\-fmt}]{\setlength{\rightskip}{0pt plus 5cm}{\bf th\_\-pixel\_\-fmt} {\bf th\_\-info::pixel\_\-fmt}}\label{structth__info_a2301388ef3755c41ab12fd144c1fc54e}
 
 
-The target quality level. 
+The pixel format. \index{th\_\-info@{th\_\-info}!quality@{quality}}
+\index{quality@{quality}!th_info@{th\_\-info}}
+\subsubsection[{quality}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf th\_\-info::quality}}\label{structth__info_aa4cdcf96cb46b256821993e9a830ee02}
 
-Valid values range from 0 to 63, inclusive, with higher values giving higher quality. If initializing an encoder with this struct, and \doxyref{target\-\_\-bitrate}{p.}{structth__info_a1d9c8d768a4ae623269f5bd8f6f7a015} is set to zero, V\-B\-R encoding at this quality will be activated by default. \index{th\-\_\-info@{th\-\_\-info}!target\-\_\-bitrate@{target\-\_\-bitrate}}
-\index{target\-\_\-bitrate@{target\-\_\-bitrate}!th_info@{th\-\_\-info}}
-\subsubsection[{target\-\_\-bitrate}]{\setlength{\rightskip}{0pt plus 5cm}int th\-\_\-info\-::target\-\_\-bitrate}\label{structth__info_a1d9c8d768a4ae623269f5bd8f6f7a015}
 
+The target quality level. Valid values range from 0 to 63, inclusive, with higher values giving higher quality. If initializing an encoder with this struct, and \doxyref{target\_\-bitrate}{p.}{structth__info_a1d9c8d768a4ae623269f5bd8f6f7a015} is set to zero, VBR encoding at this quality will be activated by default. \index{th\_\-info@{th\_\-info}!target\_\-bitrate@{target\_\-bitrate}}
+\index{target\_\-bitrate@{target\_\-bitrate}!th_info@{th\_\-info}}
+\subsubsection[{target\_\-bitrate}]{\setlength{\rightskip}{0pt plus 5cm}int {\bf th\_\-info::target\_\-bitrate}}\label{structth__info_a1d9c8d768a4ae623269f5bd8f6f7a015}
 
-The target bit-\/rate in bits per second. 
 
-If initializing an encoder with this struct, set this field to a non-\/zero value to activate C\-B\-R encoding by default. \index{th\-\_\-info@{th\-\_\-info}!version\-\_\-major@{version\-\_\-major}}
-\index{version\-\_\-major@{version\-\_\-major}!th_info@{th\-\_\-info}}
-\subsubsection[{version\-\_\-major}]{\setlength{\rightskip}{0pt plus 5cm}unsigned char th\-\_\-info\-::version\-\_\-major}\label{structth__info_a60b3e2cac006fee0e105a918d6a5a9f9}
-\index{th\-\_\-info@{th\-\_\-info}!version\-\_\-minor@{version\-\_\-minor}}
-\index{version\-\_\-minor@{version\-\_\-minor}!th_info@{th\-\_\-info}}
-\subsubsection[{version\-\_\-minor}]{\setlength{\rightskip}{0pt plus 5cm}unsigned char th\-\_\-info\-::version\-\_\-minor}\label{structth__info_abb1d4887a8079c6c5aaa6d7229f243d7}
-\index{th\-\_\-info@{th\-\_\-info}!version\-\_\-subminor@{version\-\_\-subminor}}
-\index{version\-\_\-subminor@{version\-\_\-subminor}!th_info@{th\-\_\-info}}
-\subsubsection[{version\-\_\-subminor}]{\setlength{\rightskip}{0pt plus 5cm}unsigned char th\-\_\-info\-::version\-\_\-subminor}\label{structth__info_abfacc79b7cabae12b6ac2484f76602d3}
+The target bit-\/rate in bits per second. If initializing an encoder with this struct, set this field to a non-\/zero value to activate CBR encoding by default. \index{th\_\-info@{th\_\-info}!version\_\-major@{version\_\-major}}
+\index{version\_\-major@{version\_\-major}!th_info@{th\_\-info}}
+\subsubsection[{version\_\-major}]{\setlength{\rightskip}{0pt plus 5cm}unsigned char {\bf th\_\-info::version\_\-major}}\label{structth__info_a60b3e2cac006fee0e105a918d6a5a9f9}
+\index{th\_\-info@{th\_\-info}!version\_\-minor@{version\_\-minor}}
+\index{version\_\-minor@{version\_\-minor}!th_info@{th\_\-info}}
+\subsubsection[{version\_\-minor}]{\setlength{\rightskip}{0pt plus 5cm}unsigned char {\bf th\_\-info::version\_\-minor}}\label{structth__info_abb1d4887a8079c6c5aaa6d7229f243d7}
+\index{th\_\-info@{th\_\-info}!version\_\-subminor@{version\_\-subminor}}
+\index{version\_\-subminor@{version\_\-subminor}!th_info@{th\_\-info}}
+\subsubsection[{version\_\-subminor}]{\setlength{\rightskip}{0pt plus 5cm}unsigned char {\bf th\_\-info::version\_\-subminor}}\label{structth__info_abfacc79b7cabae12b6ac2484f76602d3}
 
 
-The documentation for this struct was generated from the following file\-:\begin{DoxyCompactItemize}
+The documentation for this struct was generated from the following file:\begin{DoxyCompactItemize}
 \item 
-{\bf codec.\-h}\end{DoxyCompactItemize}
+{\bf codec.h}\end{DoxyCompactItemize}