theora_info Struct Reference
[Legacy pre-1.0 C API]

Theora bitstream info. More...

#include <theora.h>


Data Fields

ogg_uint32_t width
 encoded frame width
ogg_uint32_t height
 encoded frame height
ogg_uint32_t frame_width
 display frame width
ogg_uint32_t frame_height
 display frame height
ogg_uint32_t offset_x
 horizontal offset of the displayed frame
ogg_uint32_t offset_y
 vertical offset of the displayed frame
ogg_uint32_t fps_numerator
 frame rate numerator
ogg_uint32_t fps_denominator
 frame rate denominator
ogg_uint32_t aspect_numerator
 pixel aspect ratio numerator
ogg_uint32_t aspect_denominator
 pixel aspect ratio denominator
theora_colorspace colorspace
 colorspace
int target_bitrate
 nominal bitrate in bits per second
int quality
 Nominal quality setting, 0-63.
int quick_p
 Quick encode/decode.
unsigned char version_major
unsigned char version_minor
unsigned char version_subminor
void * codec_setup
int dropframes_p
int keyframe_auto_p
ogg_uint32_t keyframe_frequency
ogg_uint32_t keyframe_frequency_force
ogg_uint32_t keyframe_data_target_bitrate
ogg_int32_t keyframe_auto_threshold
ogg_uint32_t keyframe_mindistance
ogg_int32_t noise_sensitivity
ogg_int32_t sharpness
theora_pixelformat pixelformat
 chroma subsampling mode to expect


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 * 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 examples/encoder_example.c for usage examples of the other paramters and good default settings for the encoder parameters.


Field Documentation

pixel aspect ratio denominator

pixel aspect ratio numerator

colorspace

frame rate denominator

frame rate numerator

display frame height

display frame width

ogg_uint32_t theora_info::height

encoded frame height

ogg_uint32_t theora_info::offset_x

horizontal offset of the displayed frame

ogg_uint32_t theora_info::offset_y

vertical offset of the displayed frame

chroma subsampling mode to expect

Nominal quality setting, 0-63.

Quick encode/decode.

nominal bitrate in bits per second

ogg_uint32_t theora_info::width

encoded frame width


The documentation for this struct was generated from the following file:

Generated on Wed Aug 5 12:38:08 2009 for libtheora by  doxygen 1.5.8