theoraplay.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/**
* TheoraPlay; multithreaded Ogg Theora/Ogg Vorbis decoding.
*
* Please see the file LICENSE.txt in the source's root directory.
*
* This file written by Ryan C. Gordon.
*/
#ifndef _INCL_THEORAPLAY_H_
#define _INCL_THEORAPLAY_H_
#ifdef __cplusplus
extern "C" {
#endif
16
17
18
19
20
21
22
23
typedef struct THEORAPLAY_Io THEORAPLAY_Io;
struct THEORAPLAY_Io
{
long (*read)(THEORAPLAY_Io *io, void *buf, long buflen);
void (*close)(THEORAPLAY_Io *io);
void *userdata;
};
24
25
typedef struct THEORAPLAY_Decoder THEORAPLAY_Decoder;
26
27
28
29
/* YV12 is YCrCb, not YCbCr; that's what SDL uses for YV12 overlays. */
typedef enum THEORAPLAY_VideoFormat
{
THEORAPLAY_VIDFMT_YV12, /* NTSC colorspace, planar YCrCb 4:2:0 */
30
THEORAPLAY_VIDFMT_IYUV, /* NTSC colorspace, planar YCbCr 4:2:0 */
31
32
33
34
THEORAPLAY_VIDFMT_RGB, /* 24 bits packed pixel RGB */
THEORAPLAY_VIDFMT_RGBA /* 32 bits packed pixel RGBA (full alpha). */
} THEORAPLAY_VideoFormat;
35
typedef struct THEORAPLAY_VideoFrame
36
37
{
unsigned int playms;
38
double fps;
39
40
unsigned int width;
unsigned int height;
41
42
THEORAPLAY_VideoFormat format;
unsigned char *pixels;
43
44
struct THEORAPLAY_VideoFrame *next;
} THEORAPLAY_VideoFrame;
46
typedef struct THEORAPLAY_AudioPacket
48
unsigned int playms; /* playback start time in milliseconds. */
49
int channels;
50
int freq;
51
int frames;
52
float *samples; /* frames * channels float32 samples. */
53
54
struct THEORAPLAY_AudioPacket *next;
} THEORAPLAY_AudioPacket;
56
57
58
59
THEORAPLAY_Decoder *THEORAPLAY_startDecodeFile(const char *fname,
const unsigned int maxframes,
THEORAPLAY_VideoFormat vidfmt);
THEORAPLAY_Decoder *THEORAPLAY_startDecode(THEORAPLAY_Io *io,
60
61
const unsigned int maxframes,
THEORAPLAY_VideoFormat vidfmt);
62
void THEORAPLAY_stopDecode(THEORAPLAY_Decoder *decoder);
64
int THEORAPLAY_isDecoding(THEORAPLAY_Decoder *decoder);
65
int THEORAPLAY_decodingError(THEORAPLAY_Decoder *decoder);
66
67
68
69
70
int THEORAPLAY_isInitialized(THEORAPLAY_Decoder *decoder);
int THEORAPLAY_hasVideoStream(THEORAPLAY_Decoder *decoder);
int THEORAPLAY_hasAudioStream(THEORAPLAY_Decoder *decoder);
unsigned int THEORAPLAY_availableVideo(THEORAPLAY_Decoder *decoder);
unsigned int THEORAPLAY_availableAudio(THEORAPLAY_Decoder *decoder);
72
73
const THEORAPLAY_AudioPacket *THEORAPLAY_getAudio(THEORAPLAY_Decoder *decoder);
void THEORAPLAY_freeAudio(const THEORAPLAY_AudioPacket *item);
75
76
const THEORAPLAY_VideoFrame *THEORAPLAY_getVideo(THEORAPLAY_Decoder *decoder);
void THEORAPLAY_freeVideo(const THEORAPLAY_VideoFrame *item);
77
78
79
80
81
82
83
84
#ifdef __cplusplus
}
#endif
#endif /* include-once blocker. */
/* end of theoraplay.h ... */