\section{theora\_\-info Struct Reference}
\label{structtheora__info}\index{theora_info@{theora\_\-info}}
Theora bitstream info.  


{\tt \#include $<$theora.h$>$}

\subsection*{Data Fields}
\begin{CompactItemize}
\item 
ogg\_\-uint32\_\-t {\bf width}\label{structtheora__info_6f1094fe341bac5ad9b23e0afab836a6}

\begin{CompactList}\small\item\em encoded frame width \item\end{CompactList}\item 
ogg\_\-uint32\_\-t {\bf height}\label{structtheora__info_8e7f84ca1724bb90c210c2815f904a01}

\begin{CompactList}\small\item\em encoded frame height \item\end{CompactList}\item 
ogg\_\-uint32\_\-t {\bf frame\_\-width}\label{structtheora__info_a3c69b1f45e66cabae99a8a90c13003e}

\begin{CompactList}\small\item\em display frame width \item\end{CompactList}\item 
ogg\_\-uint32\_\-t {\bf frame\_\-height}\label{structtheora__info_6aa64f83107f32b7e4214462bd173cda}

\begin{CompactList}\small\item\em display frame height \item\end{CompactList}\item 
ogg\_\-uint32\_\-t {\bf offset\_\-x}\label{structtheora__info_ef18353df17bab7b78b1f3a48141fda5}

\begin{CompactList}\small\item\em horizontal offset of the displayed frame \item\end{CompactList}\item 
ogg\_\-uint32\_\-t {\bf offset\_\-y}\label{structtheora__info_5e7da1d6b6f90f4f038d04f9cf677e3d}

\begin{CompactList}\small\item\em vertical offset of the displayed frame \item\end{CompactList}\item 
ogg\_\-uint32\_\-t {\bf fps\_\-numerator}\label{structtheora__info_b5b73000d86c892a805d7edc874ffdf8}

\begin{CompactList}\small\item\em frame rate numerator \item\end{CompactList}\item 
ogg\_\-uint32\_\-t {\bf fps\_\-denominator}\label{structtheora__info_fca33e94f7c437ea5d2dc4eb6ab4642a}

\begin{CompactList}\small\item\em frame rate denominator \item\end{CompactList}\item 
ogg\_\-uint32\_\-t {\bf aspect\_\-numerator}\label{structtheora__info_dcd1750a5bb10c3da1a29b2154683bb3}

\begin{CompactList}\small\item\em pixel aspect ratio numerator \item\end{CompactList}\item 
ogg\_\-uint32\_\-t {\bf aspect\_\-denominator}\label{structtheora__info_4dd10a45536510b8748e80fb6adf8e51}

\begin{CompactList}\small\item\em pixel aspect ratio denominator \item\end{CompactList}\item 
{\bf theora\_\-colorspace} {\bf colorspace}\label{structtheora__info_fc1972d0a6227b957f51baf417483e78}

\begin{CompactList}\small\item\em colorspace \item\end{CompactList}\item 
int {\bf target\_\-bitrate}\label{structtheora__info_d568c28dc5fa1f22630826e5eb95a874}

\begin{CompactList}\small\item\em nominal bitrate in bits per second \item\end{CompactList}\item 
int {\bf quality}\label{structtheora__info_48df8ab9e7ec3a47656c2e2028ee2dba}

\begin{CompactList}\small\item\em Nominal quality setting, 0-63. \item\end{CompactList}\item 
int {\bf quick\_\-p}\label{structtheora__info_8ac3973b333ca026c0749a2f2ff044db}

\begin{CompactList}\small\item\em Quick encode/decode. \item\end{CompactList}\item 
unsigned char \textbf{version\_\-major}\label{structtheora__info_658d5d9af1546c6a155b652569910935}

\item 
unsigned char \textbf{version\_\-minor}\label{structtheora__info_248c4c2c467e75c128e37596c4acefa1}

\item 
unsigned char \textbf{version\_\-subminor}\label{structtheora__info_107b3fc2cd72eff290ac665966a806d2}

\item 
void $\ast$ \textbf{codec\_\-setup}\label{structtheora__info_7bfcea185ef25b5d1c264a473e1c46bf}

\item 
int \textbf{dropframes\_\-p}\label{structtheora__info_1fa7ebf4307a40cae93bd2952ac7b61d}

\item 
int \textbf{keyframe\_\-auto\_\-p}\label{structtheora__info_90b808a057363c58eba4fb210729f5bd}

\item 
ogg\_\-uint32\_\-t \textbf{keyframe\_\-frequency}\label{structtheora__info_18c71b2258bddb04f72d6e96282b319e}

\item 
ogg\_\-uint32\_\-t \textbf{keyframe\_\-frequency\_\-force}\label{structtheora__info_74a72a8f7eac847705d2ebda3703aed7}

\item 
ogg\_\-uint32\_\-t \textbf{keyframe\_\-data\_\-target\_\-bitrate}\label{structtheora__info_1ee985972c9ac6447b5b1080eac25c88}

\item 
ogg\_\-int32\_\-t \textbf{keyframe\_\-auto\_\-threshold}\label{structtheora__info_5eadc1d55bb41e886fa86164a0870ef9}

\item 
ogg\_\-uint32\_\-t \textbf{keyframe\_\-mindistance}\label{structtheora__info_5cd8291a9c734b51d96a68e9fd890969}

\item 
ogg\_\-int32\_\-t \textbf{noise\_\-sensitivity}\label{structtheora__info_c819b9b14cd2b87d6f1c143a25a8f321}

\item 
ogg\_\-int32\_\-t \textbf{sharpness}\label{structtheora__info_844635956752ae709296df19a66de0e7}

\item 
{\bf theora\_\-pixelformat} {\bf pixelformat}\label{structtheora__info_37b7d715f46d0240195b3a0184e7b178}

\begin{CompactList}\small\item\em chroma subsampling mode to expect \item\end{CompactList}\end{CompactItemize}


\subsection{Detailed Description}
Theora bitstream info. 

Contains the basic playback parameters for a stream, corresponding to the initial 'info' header packet.

Encoded theora frames must be a multiple of 16 in width and height. To handle other frame sizes, a crop rectangle is specified in frame\_\-height and frame\_\-width, offset\_\-x and $\ast$ offset\_\-y. The offset and size should still be a multiple of 2 to avoid chroma sampling shifts. Offset values in this structure are measured from the upper left of the image.

Frame rate, in frames per second, is stored as a rational fraction. Aspect ratio is also stored as a rational fraction, and refers to the aspect ratio of the frame pixels, not of the overall frame itself.

See {\tt examples/encoder\_\-example.c} for usage examples of the other paramters and good default settings for the encoder parameters. 



The documentation for this struct was generated from the following file:\begin{CompactItemize}
\item 
{\bf theora.h}\end{CompactItemize}
