Add explanatory comments to the #endif part of multiple inclusion guards.
[mplayer/greg.git] / libmpdemux / demux_roq.c
blob7b80edbb6cb6b765788a1ad6c5e0199ae3fa848b
1 /*
2 RoQ file demuxer for the MPlayer program
3 by Mike Melanson
4 based on Dr. Tim Ferguson's RoQ document found at:
5 http://www.csse.monash.edu.au/~timf/videocodec.html
6 */
8 #include <stdio.h>
9 #include <stdlib.h>
10 #include <unistd.h>
12 #include "config.h"
13 #include "mp_msg.h"
14 #include "help_mp.h"
16 #include "stream/stream.h"
17 #include "demuxer.h"
18 #include "stheader.h"
20 #define RoQ_INFO 0x1001
21 #define RoQ_QUAD_CODEBOOK 0x1002
22 #define RoQ_QUAD_VQ 0x1011
23 #define RoQ_SOUND_MONO 0x1020
24 #define RoQ_SOUND_STEREO 0x1021
26 #define CHUNK_TYPE_AUDIO 0
27 #define CHUNK_TYPE_VIDEO 1
29 typedef struct roq_chunk_t
31 int chunk_type;
32 off_t chunk_offset;
33 int chunk_size;
35 float video_chunk_number; // in the case of a video chunk
36 int running_audio_sample_count; // for an audio chunk
37 } roq_chunk_t;
39 typedef struct roq_data_t
41 int total_chunks;
42 int current_chunk;
43 int total_video_chunks;
44 int total_audio_sample_count;
45 roq_chunk_t *chunks;
46 } roq_data_t;
48 // Check if a stream qualifies as a RoQ file based on the magic numbers
49 // at the start of the file:
50 // 84 10 FF FF FF FF xx xx
51 static int roq_check_file(demuxer_t *demuxer)
53 if ((stream_read_dword(demuxer->stream) == 0x8410FFFF) &&
54 ((stream_read_dword(demuxer->stream) & 0xFFFF0000) == 0xFFFF0000))
55 return DEMUXER_TYPE_ROQ;
56 else
57 return 0;
60 // return value:
61 // 0 = EOF or no stream found
62 // 1 = successfully read a packet
63 static int demux_roq_fill_buffer(demuxer_t *demuxer, demux_stream_t *ds)
65 sh_video_t *sh_video = demuxer->video->sh;
66 roq_data_t *roq_data = (roq_data_t *)demuxer->priv;
67 roq_chunk_t roq_chunk;
69 if (roq_data->current_chunk >= roq_data->total_chunks)
70 return 0;
72 roq_chunk = roq_data->chunks[roq_data->current_chunk];
74 // make sure we're at the right place in the stream and fetch the chunk
75 stream_seek(demuxer->stream, roq_chunk.chunk_offset);
77 if (roq_chunk.chunk_type == CHUNK_TYPE_AUDIO)
78 ds_read_packet(demuxer->audio, demuxer->stream, roq_chunk.chunk_size,
80 roq_chunk.chunk_offset, 0);
81 else
82 ds_read_packet(demuxer->video, demuxer->stream, roq_chunk.chunk_size,
83 roq_chunk.video_chunk_number / sh_video->fps,
84 roq_chunk.chunk_offset, 0);
86 roq_data->current_chunk++;
87 return 1;
90 static demuxer_t* demux_open_roq(demuxer_t* demuxer)
92 sh_video_t *sh_video = NULL;
93 sh_audio_t *sh_audio = NULL;
95 roq_data_t *roq_data = malloc(sizeof(roq_data_t));
96 int chunk_id;
97 int chunk_size;
98 int chunk_arg;
99 int last_chunk_id = 0;
100 int largest_audio_chunk = 0;
101 int fps;
103 roq_data->total_chunks = 0;
104 roq_data->current_chunk = 0;
105 roq_data->total_video_chunks = 0;
106 roq_data->chunks = NULL;
108 // position the stream and start traversing
109 stream_seek(demuxer->stream, 6);
110 fps = stream_read_word_le(demuxer->stream);
111 while (!stream_eof(demuxer->stream))
113 chunk_id = stream_read_word_le(demuxer->stream);
114 chunk_size = stream_read_dword_le(demuxer->stream);
115 chunk_arg = stream_read_word_le(demuxer->stream);
117 // this is the only useful header info in the file
118 if (chunk_id == RoQ_INFO)
120 // there should only be one RoQ_INFO chunk per file
121 if (sh_video)
123 mp_msg(MSGT_DECVIDEO, MSGL_WARN, "Found more than one RoQ_INFO chunk\n");
124 stream_skip(demuxer->stream, 8);
126 else
128 // this is a good opportunity to create a video stream header
129 sh_video = new_sh_video(demuxer, 0);
130 // make sure the demuxer knows about the new stream header
131 demuxer->video->sh = sh_video;
132 // make sure that the video demuxer stream header knows about its
133 // parent video demuxer stream
134 sh_video->ds = demuxer->video;
136 sh_video->disp_w = stream_read_word_le(demuxer->stream);
137 sh_video->disp_h = stream_read_word_le(demuxer->stream);
138 stream_skip(demuxer->stream, 4);
140 // custom fourcc for internal MPlayer use
141 sh_video->format = mmioFOURCC('R', 'o', 'Q', 'V');
143 // constant frame rate
144 sh_video->fps = fps;
145 sh_video->frametime = 1 / sh_video->fps;
148 else if ((chunk_id == RoQ_SOUND_MONO) ||
149 (chunk_id == RoQ_SOUND_STEREO))
151 // create the audio stream header if it hasn't been created it
152 if (sh_audio == NULL)
154 // make the header first
155 sh_audio = new_sh_audio(demuxer, 0);
156 // make sure the demuxer knows about the new stream header
157 demuxer->audio->sh = sh_audio;
158 // make sure that the audio demuxer stream header knows about its
159 // parent audio demuxer stream
160 sh_audio->ds = demuxer->audio;
162 // go through the bother of making a WAVEFORMATEX structure
163 sh_audio->wf = malloc(sizeof(WAVEFORMATEX));
165 // custom fourcc for internal MPlayer use
166 sh_audio->format = mmioFOURCC('R', 'o', 'Q', 'A');
167 if (chunk_id == RoQ_SOUND_STEREO)
168 sh_audio->wf->nChannels = 2;
169 else
170 sh_audio->wf->nChannels = 1;
171 // always 22KHz, 16-bit
172 sh_audio->wf->nSamplesPerSec = 22050;
173 sh_audio->wf->wBitsPerSample = 16;
176 // index the chunk
177 roq_data->chunks = (roq_chunk_t *)realloc(roq_data->chunks,
178 (roq_data->total_chunks + 1) * sizeof (roq_chunk_t));
179 roq_data->chunks[roq_data->total_chunks].chunk_type = CHUNK_TYPE_AUDIO;
180 roq_data->chunks[roq_data->total_chunks].chunk_offset =
181 stream_tell(demuxer->stream) - 8;
182 roq_data->chunks[roq_data->total_chunks].chunk_size = chunk_size + 8;
183 roq_data->chunks[roq_data->total_chunks].running_audio_sample_count =
184 roq_data->total_audio_sample_count;
186 // audio housekeeping
187 if (chunk_size > largest_audio_chunk)
188 largest_audio_chunk = chunk_size;
189 roq_data->total_audio_sample_count +=
190 (chunk_size / sh_audio->wf->nChannels);
192 stream_skip(demuxer->stream, chunk_size);
193 roq_data->total_chunks++;
195 else if ((chunk_id == RoQ_QUAD_CODEBOOK) ||
196 ((chunk_id == RoQ_QUAD_VQ) && (last_chunk_id != RoQ_QUAD_CODEBOOK)))
198 // index a new chunk if it's a codebook or quad VQ not following a
199 // codebook
200 roq_data->chunks = (roq_chunk_t *)realloc(roq_data->chunks,
201 (roq_data->total_chunks + 1) * sizeof (roq_chunk_t));
202 roq_data->chunks[roq_data->total_chunks].chunk_type = CHUNK_TYPE_VIDEO;
203 roq_data->chunks[roq_data->total_chunks].chunk_offset =
204 stream_tell(demuxer->stream) - 8;
205 roq_data->chunks[roq_data->total_chunks].chunk_size = chunk_size + 8;
206 roq_data->chunks[roq_data->total_chunks].video_chunk_number =
207 roq_data->total_video_chunks++;
209 stream_skip(demuxer->stream, chunk_size);
210 roq_data->total_chunks++;
212 else if ((chunk_id == RoQ_QUAD_VQ) && (last_chunk_id == RoQ_QUAD_CODEBOOK))
214 // if it's a quad VQ chunk following a codebook chunk, extend the last
215 // chunk
216 roq_data->chunks[roq_data->total_chunks - 1].chunk_size += (chunk_size + 8);
217 stream_skip(demuxer->stream, chunk_size);
219 else if (!stream_eof(demuxer->stream))
221 mp_msg(MSGT_DECVIDEO, MSGL_WARN, "Unknown RoQ chunk ID: %04X\n", chunk_id);
224 last_chunk_id = chunk_id;
227 // minimum output buffer size = largest audio chunk * 2, since each byte
228 // in the DPCM encoding effectively represents 1 16-bit sample
229 // (store it in wf->nBlockAlign for the time being since init_audio() will
230 // step on it anyway)
231 if (sh_audio)
232 sh_audio->wf->nBlockAlign = largest_audio_chunk * 2;
234 roq_data->current_chunk = 0;
236 demuxer->priv = roq_data;
238 stream_reset(demuxer->stream);
240 return demuxer;
243 static void demux_close_roq(demuxer_t* demuxer) {
244 roq_data_t *roq_data = demuxer->priv;
246 if(!roq_data)
247 return;
248 free(roq_data);
252 demuxer_desc_t demuxer_desc_roq = {
253 "RoQ demuxer",
254 "roq",
255 "ROQ",
256 "Mike Melanson",
258 DEMUXER_TYPE_ROQ,
259 0, // unsafe autodetect
260 roq_check_file,
261 demux_roq_fill_buffer,
262 demux_open_roq,
263 demux_close_roq,
264 NULL,
265 NULL