2 * "Real" compatible muxer.
3 * Copyright (c) 2000, 2001 Fabrice Bellard
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 #include "avio_internal.h"
24 #include "libavutil/dict.h"
26 typedef struct StreamInfo {
28 int packet_total_size;
30 /* codec related output */
32 AVRational frame_rate;
33 int nb_frames; /* current frame number */
34 int total_frames; /* total number of frames */
36 AVCodecParameters *par;
39 typedef struct RMMuxContext {
40 StreamInfo streams[2];
41 StreamInfo *audio_stream, *video_stream;
42 int data_pos; /* position of the data after the header */
46 #define BUFFER_DURATION 0
47 /* the header needs at most 7 + 4 + 12 B */
48 #define MAX_HEADER_SIZE (7 + 4 + 12)
49 /* UINT16_MAX is the maximal chunk size */
50 #define MAX_PACKET_SIZE (UINT16_MAX - MAX_HEADER_SIZE)
53 static void put_str(AVIOContext *s, const char *tag)
55 avio_wb16(s,strlen(tag));
61 static void put_str8(AVIOContext *s, const char *tag)
63 avio_w8(s, strlen(tag));
69 static int rv10_write_header(AVFormatContext *ctx,
70 int data_size, int index_pos)
72 RMMuxContext *rm = ctx->priv_data;
73 AVIOContext *s = ctx->pb;
75 unsigned char *data_offset_ptr, *start_ptr;
76 const char *desc, *mimetype;
77 int nb_packets, packet_total_size, packet_max_size, size, packet_avg_size, i;
78 int bit_rate, v, duration, flags, data_pos;
79 AVDictionaryEntry *tag;
81 start_ptr = s->buf_ptr;
83 ffio_wfourcc(s, ".RMF");
84 avio_wb32(s,18); /* header size */
87 avio_wb32(s,4 + ctx->nb_streams); /* num headers */
89 ffio_wfourcc(s,"PROP");
93 packet_total_size = 0;
97 for(i=0;i<ctx->nb_streams;i++) {
98 StreamInfo *stream = &rm->streams[i];
99 bit_rate += stream->bit_rate;
100 if (stream->packet_max_size > packet_max_size)
101 packet_max_size = stream->packet_max_size;
102 nb_packets += stream->nb_packets;
103 packet_total_size += stream->packet_total_size;
104 /* select maximum duration */
105 v = av_rescale_q_rnd(stream->total_frames, (AVRational){1000, 1}, stream->frame_rate, AV_ROUND_ZERO);
109 avio_wb32(s, bit_rate); /* max bit rate */
110 avio_wb32(s, bit_rate); /* avg bit rate */
111 avio_wb32(s, packet_max_size); /* max packet size */
113 packet_avg_size = packet_total_size / nb_packets;
116 avio_wb32(s, packet_avg_size); /* avg packet size */
117 avio_wb32(s, nb_packets); /* num packets */
118 avio_wb32(s, duration); /* duration */
119 avio_wb32(s, BUFFER_DURATION); /* preroll */
120 avio_wb32(s, index_pos); /* index offset */
121 /* computation of data the data offset */
122 data_offset_ptr = s->buf_ptr;
123 avio_wb32(s, 0); /* data offset : will be patched after */
124 avio_wb16(s, ctx->nb_streams); /* num streams */
125 flags = 1 | 2; /* save allowed & perfect play */
126 if (!(s->seekable & AVIO_SEEKABLE_NORMAL))
127 flags |= 4; /* live broadcast */
132 ffio_wfourcc(s,"CONT");
134 for(i=0; i<FF_ARRAY_ELEMS(ff_rm_metadata); i++) {
135 tag = av_dict_get(ctx->metadata, ff_rm_metadata[i], NULL, 0);
136 if(tag) size += strlen(tag->value);
140 for(i=0; i<FF_ARRAY_ELEMS(ff_rm_metadata); i++) {
141 tag = av_dict_get(ctx->metadata, ff_rm_metadata[i], NULL, 0);
142 put_str(s, tag ? tag->value : "");
145 for(i=0;i<ctx->nb_streams;i++) {
148 stream = &rm->streams[i];
150 if (stream->par->codec_type == AVMEDIA_TYPE_AUDIO) {
151 desc = "The Audio Stream";
152 mimetype = "audio/x-pn-realaudio";
153 codec_data_size = 73;
155 desc = "The Video Stream";
156 mimetype = "video/x-pn-realvideo";
157 codec_data_size = 34;
160 ffio_wfourcc(s,"MDPR");
161 size = 10 + 9 * 4 + strlen(desc) + strlen(mimetype) + codec_data_size;
165 avio_wb16(s, i); /* stream number */
166 avio_wb32(s, stream->bit_rate); /* max bit rate */
167 avio_wb32(s, stream->bit_rate); /* avg bit rate */
168 avio_wb32(s, stream->packet_max_size); /* max packet size */
169 if (stream->nb_packets > 0)
170 packet_avg_size = stream->packet_total_size /
174 avio_wb32(s, packet_avg_size); /* avg packet size */
175 avio_wb32(s, 0); /* start time */
176 avio_wb32(s, BUFFER_DURATION); /* preroll */
178 if (!(s->seekable & AVIO_SEEKABLE_NORMAL) || !stream->total_frames)
179 avio_wb32(s, (int)(3600 * 1000));
181 avio_wb32(s, av_rescale_q_rnd(stream->total_frames, (AVRational){1000, 1}, stream->frame_rate, AV_ROUND_ZERO));
183 put_str8(s, mimetype);
184 avio_wb32(s, codec_data_size);
186 if (stream->par->codec_type == AVMEDIA_TYPE_AUDIO) {
187 int coded_frame_size, fscode, sample_rate;
188 int frame_size = av_get_audio_frame_duration2(stream->par, 0);
189 sample_rate = stream->par->sample_rate;
190 coded_frame_size = (stream->par->bit_rate *
191 frame_size) / (8 * sample_rate);
192 /* audio codec info */
193 avio_write(s, ".ra", 3);
195 avio_wb32(s, 0x00040000); /* version */
196 ffio_wfourcc(s, ".ra4");
197 avio_wb32(s, 0x01b53530); /* stream length */
198 avio_wb16(s, 4); /* unknown */
199 avio_wb32(s, 0x39); /* header size */
201 switch(sample_rate) {
218 avio_wb16(s, fscode); /* codec additional info, for AC-3, seems
219 to be a frequency code */
220 /* special hack to compensate rounding errors... */
221 if (coded_frame_size == 557)
223 avio_wb32(s, coded_frame_size); /* frame length */
224 avio_wb32(s, 0x51540); /* unknown */
225 avio_wb32(s, stream->par->bit_rate / 8 * 60); /* bytes per minute */
226 avio_wb32(s, stream->par->bit_rate / 8 * 60); /* bytes per minute */
228 /* frame length : seems to be very important */
229 avio_wb16(s, coded_frame_size);
230 avio_wb32(s, 0); /* unknown */
231 avio_wb16(s, stream->par->sample_rate); /* sample rate */
232 avio_wb32(s, 0x10); /* unknown */
233 avio_wb16(s, stream->par->channels);
234 put_str8(s, "Int0"); /* codec name */
235 if (stream->par->codec_tag) {
236 avio_w8(s, 4); /* tag length */
237 avio_wl32(s, stream->par->codec_tag);
239 av_log(ctx, AV_LOG_ERROR, "Invalid codec tag\n");
242 avio_wb16(s, 0); /* title length */
243 avio_wb16(s, 0); /* author length */
244 avio_wb16(s, 0); /* copyright length */
245 avio_w8(s, 0); /* end of header */
247 /* video codec info */
248 avio_wb32(s,34); /* size */
249 ffio_wfourcc(s, "VIDO");
250 if(stream->par->codec_id == AV_CODEC_ID_RV10)
251 ffio_wfourcc(s,"RV10");
253 ffio_wfourcc(s,"RV20");
254 avio_wb16(s, stream->par->width);
255 avio_wb16(s, stream->par->height);
257 if (stream->frame_rate.num / stream->frame_rate.den > 65535) {
258 av_log(s, AV_LOG_ERROR, "Frame rate %d is too high\n", stream->frame_rate.num / stream->frame_rate.den);
259 return AVERROR(EINVAL);
262 avio_wb16(s, stream->frame_rate.num / stream->frame_rate.den); /* frames per seconds ? */
263 avio_wb32(s,0); /* unknown meaning */
264 avio_wb16(s, stream->frame_rate.num / stream->frame_rate.den); /* unknown meaning */
265 avio_wb32(s,0); /* unknown meaning */
266 avio_wb16(s, 8); /* unknown meaning */
267 /* Seems to be the codec version: only use basic H.263. The next
268 versions seems to add a differential DC coding as in
269 MPEG... nothing new under the sun. */
270 if(stream->par->codec_id == AV_CODEC_ID_RV10)
271 avio_wb32(s,0x10000000);
273 avio_wb32(s,0x20103001);
274 //avio_wb32(s,0x10003000);
278 /* patch data offset field */
279 data_pos = s->buf_ptr - start_ptr;
280 rm->data_pos = data_pos;
281 data_offset_ptr[0] = data_pos >> 24;
282 data_offset_ptr[1] = data_pos >> 16;
283 data_offset_ptr[2] = data_pos >> 8;
284 data_offset_ptr[3] = data_pos;
287 ffio_wfourcc(s, "DATA");
288 avio_wb32(s,data_size + 10 + 8);
291 avio_wb32(s, nb_packets); /* number of packets */
292 avio_wb32(s,0); /* next data header */
296 static void write_packet_header(AVFormatContext *ctx, StreamInfo *stream,
297 int length, int key_frame)
300 AVIOContext *s = ctx->pb;
302 stream->nb_packets++;
303 stream->packet_total_size += length;
304 if (length > stream->packet_max_size)
305 stream->packet_max_size = length;
307 avio_wb16(s,0); /* version */
308 avio_wb16(s,length + 12);
309 avio_wb16(s, stream->num); /* stream number */
310 timestamp = av_rescale_q_rnd(stream->nb_frames, (AVRational){1000, 1}, stream->frame_rate, AV_ROUND_ZERO);
311 avio_wb32(s, timestamp); /* timestamp */
312 avio_w8(s, 0); /* reserved */
313 avio_w8(s, key_frame ? 2 : 0); /* flags */
316 static int rm_write_header(AVFormatContext *s)
318 RMMuxContext *rm = s->priv_data;
321 AVCodecParameters *par;
323 if (s->nb_streams > 2) {
324 av_log(s, AV_LOG_ERROR, "At most 2 streams are currently supported for muxing in RM\n");
325 return AVERROR_PATCHWELCOME;
328 for(n=0;n<s->nb_streams;n++) {
329 AVStream *st = s->streams[n];
332 s->streams[n]->id = n;
333 par = s->streams[n]->codecpar;
334 stream = &rm->streams[n];
335 memset(stream, 0, sizeof(StreamInfo));
337 stream->bit_rate = par->bit_rate;
340 switch (par->codec_type) {
341 case AVMEDIA_TYPE_AUDIO:
342 rm->audio_stream = stream;
343 frame_size = av_get_audio_frame_duration2(par, 0);
344 stream->frame_rate = (AVRational){par->sample_rate, frame_size};
345 /* XXX: dummy values */
346 stream->packet_max_size = 1024;
347 stream->nb_packets = 0;
348 stream->total_frames = stream->nb_packets;
350 case AVMEDIA_TYPE_VIDEO:
351 rm->video_stream = stream;
352 // TODO: should be avg_frame_rate
353 stream->frame_rate = av_inv_q(st->time_base);
354 /* XXX: dummy values */
355 stream->packet_max_size = 4096;
356 stream->nb_packets = 0;
357 stream->total_frames = stream->nb_packets;
364 if (rv10_write_header(s, 0, 0))
365 return AVERROR_INVALIDDATA;
370 static int rm_write_audio(AVFormatContext *s, const uint8_t *buf, int size, int flags)
372 RMMuxContext *rm = s->priv_data;
373 AVIOContext *pb = s->pb;
374 StreamInfo *stream = rm->audio_stream;
377 write_packet_header(s, stream, size, !!(flags & AV_PKT_FLAG_KEY));
379 if (stream->par->codec_id == AV_CODEC_ID_AC3) {
380 /* for AC-3, the words seem to be reversed */
381 for (i = 0; i < size; i += 2) {
382 avio_w8(pb, buf[i + 1]);
386 avio_write(pb, buf, size);
392 static int rm_write_video(AVFormatContext *s, const uint8_t *buf, int size, int flags)
394 RMMuxContext *rm = s->priv_data;
395 AVIOContext *pb = s->pb;
396 StreamInfo *stream = rm->video_stream;
397 int key_frame = !!(flags & AV_PKT_FLAG_KEY);
399 /* XXX: this is incorrect: should be a parameter */
401 /* Well, I spent some time finding the meaning of these bits. I am
402 not sure I understood everything, but it works !! */
403 if (size > MAX_PACKET_SIZE) {
404 av_log(s, AV_LOG_ERROR, "Muxing packets larger than 64 kB (%d) is not supported\n", size);
405 return AVERROR_PATCHWELCOME;
407 write_packet_header(s, stream, size + 7 + (size >= 0x4000)*4, key_frame);
408 /* bit 7: '1' if final packet of a frame converted in several packets */
410 /* bit 7: '1' if I-frame. bits 6..0 : sequence number in current
411 frame starting from 1 */
418 avio_wb32(pb, size); /* total frame size */
419 avio_wb32(pb, size); /* offset from the start or the end */
421 avio_wb16(pb, 0x4000 | size); /* total frame size */
422 avio_wb16(pb, 0x4000 | size); /* offset from the start or the end */
424 avio_w8(pb, stream->nb_frames & 0xff);
426 avio_write(pb, buf, size);
432 static int rm_write_packet(AVFormatContext *s, AVPacket *pkt)
434 if (s->streams[pkt->stream_index]->codecpar->codec_type ==
436 return rm_write_audio(s, pkt->data, pkt->size, pkt->flags);
438 return rm_write_video(s, pkt->data, pkt->size, pkt->flags);
441 static int rm_write_trailer(AVFormatContext *s)
443 RMMuxContext *rm = s->priv_data;
444 int data_size, index_pos, i;
445 AVIOContext *pb = s->pb;
447 if (s->pb->seekable & AVIO_SEEKABLE_NORMAL) {
448 /* end of file: finish to write header */
449 index_pos = avio_tell(pb);
450 data_size = index_pos - rm->data_pos;
452 /* FIXME: write index */
454 /* undocumented end header */
458 avio_seek(pb, 0, SEEK_SET);
459 for(i=0;i<s->nb_streams;i++)
460 rm->streams[i].total_frames = rm->streams[i].nb_frames;
461 rv10_write_header(s, data_size, 0);
463 /* undocumented end header */
472 AVOutputFormat ff_rm_muxer = {
474 .long_name = NULL_IF_CONFIG_SMALL("RealMedia"),
475 .mime_type = "application/vnd.rn-realmedia",
476 .extensions = "rm,ra",
477 .priv_data_size = sizeof(RMMuxContext),
478 .audio_codec = AV_CODEC_ID_AC3,
479 .video_codec = AV_CODEC_ID_RV10,
480 .write_header = rm_write_header,
481 .write_packet = rm_write_packet,
482 .write_trailer = rm_write_trailer,
483 .codec_tag = (const AVCodecTag* const []){ ff_rm_codec_tags, 0 },