3 * Copyright (c) 2001, 2002, 2003 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
24 #define Y4M_MAGIC "YUV4MPEG2"
25 #define Y4M_FRAME_MAGIC "FRAME"
26 #define Y4M_LINE_MAX 256
28 struct frame_attributes {
33 #if CONFIG_YUV4MPEGPIPE_MUXER
34 static int yuv4_generate_header(AVFormatContext *s, char* buf)
38 int raten, rated, aspectn, aspectd, n;
40 const char *colorspace = "";
43 width = st->codec->width;
44 height = st->codec->height;
46 av_reduce(&raten, &rated, st->codec->time_base.den,
47 st->codec->time_base.num, (1UL << 31) - 1);
49 aspectn = st->sample_aspect_ratio.num;
50 aspectd = st->sample_aspect_ratio.den;
52 if (aspectn == 0 && aspectd == 1)
53 aspectd = 0; // 0:0 means unknown
55 inter = 'p'; /* progressive is the default */
56 if (st->codec->coded_frame && st->codec->coded_frame->interlaced_frame)
57 inter = st->codec->coded_frame->top_field_first ? 't' : 'b';
59 switch (st->codec->pix_fmt) {
61 colorspace = " Cmono";
64 colorspace = " C411 XYSCSS=411";
67 switch (st->codec->chroma_sample_location) {
68 case AVCHROMA_LOC_TOPLEFT: colorspace = " C420paldv XYSCSS=420PALDV"; break;
69 case AVCHROMA_LOC_LEFT: colorspace = " C420mpeg2 XYSCSS=420MPEG2"; break;
70 default: colorspace = " C420jpeg XYSCSS=420JPEG"; break;
74 colorspace = " C422 XYSCSS=422";
77 colorspace = " C444 XYSCSS=444";
81 /* construct stream header, if this is the first frame */
82 n = snprintf(buf, Y4M_LINE_MAX, "%s W%d H%d F%d:%d I%c A%d:%d%s\n",
83 Y4M_MAGIC, width, height, raten, rated, inter,
84 aspectn, aspectd, colorspace);
89 static int yuv4_write_packet(AVFormatContext *s, AVPacket *pkt)
91 AVStream *st = s->streams[pkt->stream_index];
92 AVIOContext *pb = s->pb;
94 int* first_pkt = s->priv_data;
95 int width, height, h_chroma_shift, v_chroma_shift;
97 char buf2[Y4M_LINE_MAX + 1];
99 uint8_t *ptr, *ptr1, *ptr2;
101 picture = (AVPicture *)pkt->data;
103 /* for the first packet we have to output the header as well */
106 if (yuv4_generate_header(s, buf2) < 0) {
107 av_log(s, AV_LOG_ERROR,
108 "Error. YUV4MPEG stream header write failed.\n");
111 avio_write(pb, buf2, strlen(buf2));
115 /* construct frame header */
117 snprintf(buf1, sizeof(buf1), "%s\n", Y4M_FRAME_MAGIC);
118 avio_write(pb, buf1, strlen(buf1));
120 width = st->codec->width;
121 height = st->codec->height;
123 ptr = picture->data[0];
124 for (i = 0; i < height; i++) {
125 avio_write(pb, ptr, width);
126 ptr += picture->linesize[0];
129 if (st->codec->pix_fmt != PIX_FMT_GRAY8) {
130 // Adjust for smaller Cb and Cr planes
131 avcodec_get_chroma_sub_sample(st->codec->pix_fmt, &h_chroma_shift,
133 width >>= h_chroma_shift;
134 height >>= v_chroma_shift;
136 ptr1 = picture->data[1];
137 ptr2 = picture->data[2];
138 for (i = 0; i < height; i++) { /* Cb */
139 avio_write(pb, ptr1, width);
140 ptr1 += picture->linesize[1];
142 for (i = 0; i < height; i++) { /* Cr */
143 avio_write(pb, ptr2, width);
144 ptr2 += picture->linesize[2];
151 static int yuv4_write_header(AVFormatContext *s)
153 int *first_pkt = s->priv_data;
155 if (s->nb_streams != 1)
158 if (s->streams[0]->codec->codec_id != CODEC_ID_RAWVIDEO) {
159 av_log(s, AV_LOG_ERROR,
160 "A non-rawvideo stream was selected, but yuv4mpeg only handles rawvideo streams\n");
161 return AVERROR(EINVAL);
164 if (s->streams[0]->codec->pix_fmt == PIX_FMT_YUV411P) {
165 av_log(s, AV_LOG_ERROR, "Warning: generating rarely used 4:1:1 YUV "
166 "stream, some mjpegtools might not work.\n");
167 } else if ((s->streams[0]->codec->pix_fmt != PIX_FMT_YUV420P) &&
168 (s->streams[0]->codec->pix_fmt != PIX_FMT_YUV422P) &&
169 (s->streams[0]->codec->pix_fmt != PIX_FMT_GRAY8) &&
170 (s->streams[0]->codec->pix_fmt != PIX_FMT_YUV444P)) {
171 av_log(s, AV_LOG_ERROR, "ERROR: yuv4mpeg only handles yuv444p, "
172 "yuv422p, yuv420p, yuv411p and gray pixel formats. "
173 "Use -pix_fmt to select one.\n");
181 AVOutputFormat ff_yuv4mpegpipe_muxer = {
182 .name = "yuv4mpegpipe",
183 .long_name = NULL_IF_CONFIG_SMALL("YUV4MPEG pipe format"),
185 .priv_data_size = sizeof(int),
186 .audio_codec = CODEC_ID_NONE,
187 .video_codec = CODEC_ID_RAWVIDEO,
188 .write_header = yuv4_write_header,
189 .write_packet = yuv4_write_packet,
190 .flags = AVFMT_RAWPICTURE,
194 /* Header size increased to allow room for optional flags */
195 #define MAX_YUV4_HEADER 80
196 #define MAX_FRAME_HEADER 80
198 static int yuv4_read_header(AVFormatContext *s)
200 char header[MAX_YUV4_HEADER + 10]; // Include headroom for
201 // the longest option
202 char *tokstart, *tokend, *header_end;
204 AVIOContext *pb = s->pb;
205 int width = -1, height = -1, raten = 0,
206 rated = 0, aspectn = 0, aspectd = 0;
207 enum PixelFormat pix_fmt = PIX_FMT_NONE, alt_pix_fmt = PIX_FMT_NONE;
208 enum AVChromaLocation chroma_sample_location = AVCHROMA_LOC_UNSPECIFIED;
210 struct frame_attributes *s1 = s->priv_data;
212 for (i = 0; i < MAX_YUV4_HEADER; i++) {
213 header[i] = avio_r8(pb);
214 if (header[i] == '\n') {
215 header[i + 1] = 0x20; // Add a space after last option.
216 // Makes parsing "444" vs "444alpha" easier.
221 if (i == MAX_YUV4_HEADER)
223 if (strncmp(header, Y4M_MAGIC, strlen(Y4M_MAGIC)))
226 s1->interlaced_frame = 0;
227 s1->top_field_first = 0;
228 header_end = &header[i + 1]; // Include space
229 for (tokstart = &header[strlen(Y4M_MAGIC) + 1];
230 tokstart < header_end; tokstart++) {
231 if (*tokstart == 0x20)
233 switch (*tokstart++) {
234 case 'W': // Width. Required.
235 width = strtol(tokstart, &tokend, 10);
238 case 'H': // Height. Required.
239 height = strtol(tokstart, &tokend, 10);
242 case 'C': // Color space
243 if (strncmp("420jpeg", tokstart, 7) == 0) {
244 pix_fmt = PIX_FMT_YUV420P;
245 chroma_sample_location = AVCHROMA_LOC_CENTER;
246 } else if (strncmp("420mpeg2", tokstart, 8) == 0) {
247 pix_fmt = PIX_FMT_YUV420P;
248 chroma_sample_location = AVCHROMA_LOC_LEFT;
249 } else if (strncmp("420paldv", tokstart, 8) == 0) {
250 pix_fmt = PIX_FMT_YUV420P;
251 chroma_sample_location = AVCHROMA_LOC_TOPLEFT;
252 } else if (strncmp("420", tokstart, 3) == 0) {
253 pix_fmt = PIX_FMT_YUV420P;
254 chroma_sample_location = AVCHROMA_LOC_CENTER;
255 } else if (strncmp("411", tokstart, 3) == 0)
256 pix_fmt = PIX_FMT_YUV411P;
257 else if (strncmp("422", tokstart, 3) == 0)
258 pix_fmt = PIX_FMT_YUV422P;
259 else if (strncmp("444alpha", tokstart, 8) == 0 ) {
260 av_log(s, AV_LOG_ERROR, "Cannot handle 4:4:4:4 "
261 "YUV4MPEG stream.\n");
263 } else if (strncmp("444", tokstart, 3) == 0)
264 pix_fmt = PIX_FMT_YUV444P;
265 else if (strncmp("mono", tokstart, 4) == 0) {
266 pix_fmt = PIX_FMT_GRAY8;
268 av_log(s, AV_LOG_ERROR, "YUV4MPEG stream contains an unknown "
272 while (tokstart < header_end && *tokstart != 0x20)
275 case 'I': // Interlace type
276 switch (*tokstart++){
280 s1->interlaced_frame = 0;
283 s1->interlaced_frame = 1;
284 s1->top_field_first = 1;
287 s1->interlaced_frame = 1;
288 s1->top_field_first = 0;
291 av_log(s, AV_LOG_ERROR, "YUV4MPEG stream contains mixed "
292 "interlaced and non-interlaced frames.\n");
295 av_log(s, AV_LOG_ERROR, "YUV4MPEG has invalid header.\n");
299 case 'F': // Frame rate
300 sscanf(tokstart, "%d:%d", &raten, &rated); // 0:0 if unknown
301 while (tokstart < header_end && *tokstart != 0x20)
304 case 'A': // Pixel aspect
305 sscanf(tokstart, "%d:%d", &aspectn, &aspectd); // 0:0 if unknown
306 while (tokstart < header_end && *tokstart != 0x20)
309 case 'X': // Vendor extensions
310 if (strncmp("YSCSS=", tokstart, 6) == 0) {
311 // Older nonstandard pixel format representation
313 if (strncmp("420JPEG", tokstart, 7) == 0)
314 alt_pix_fmt = PIX_FMT_YUV420P;
315 else if (strncmp("420MPEG2", tokstart, 8) == 0)
316 alt_pix_fmt = PIX_FMT_YUV420P;
317 else if (strncmp("420PALDV", tokstart, 8) == 0)
318 alt_pix_fmt = PIX_FMT_YUV420P;
319 else if (strncmp("411", tokstart, 3) == 0)
320 alt_pix_fmt = PIX_FMT_YUV411P;
321 else if (strncmp("422", tokstart, 3) == 0)
322 alt_pix_fmt = PIX_FMT_YUV422P;
323 else if (strncmp("444", tokstart, 3) == 0)
324 alt_pix_fmt = PIX_FMT_YUV444P;
326 while (tokstart < header_end && *tokstart != 0x20)
332 if (width == -1 || height == -1) {
333 av_log(s, AV_LOG_ERROR, "YUV4MPEG has invalid header.\n");
337 if (pix_fmt == PIX_FMT_NONE) {
338 if (alt_pix_fmt == PIX_FMT_NONE)
339 pix_fmt = PIX_FMT_YUV420P;
341 pix_fmt = alt_pix_fmt;
344 if (raten <= 0 || rated <= 0) {
345 // Frame rate unknown
350 if (aspectn == 0 && aspectd == 0) {
351 // Pixel aspect unknown
355 st = avformat_new_stream(s, NULL);
357 return AVERROR(ENOMEM);
358 st->codec->width = width;
359 st->codec->height = height;
360 av_reduce(&raten, &rated, raten, rated, (1UL << 31) - 1);
361 avpriv_set_pts_info(st, 64, rated, raten);
362 st->codec->pix_fmt = pix_fmt;
363 st->codec->codec_type = AVMEDIA_TYPE_VIDEO;
364 st->codec->codec_id = CODEC_ID_RAWVIDEO;
365 st->sample_aspect_ratio = (AVRational){ aspectn, aspectd };
366 st->codec->chroma_sample_location = chroma_sample_location;
371 static int yuv4_read_packet(AVFormatContext *s, AVPacket *pkt)
374 char header[MAX_FRAME_HEADER+1];
375 int packet_size, width, height;
376 AVStream *st = s->streams[0];
377 struct frame_attributes *s1 = s->priv_data;
379 for (i = 0; i < MAX_FRAME_HEADER; i++) {
380 header[i] = avio_r8(s->pb);
381 if (header[i] == '\n') {
386 if (i == MAX_FRAME_HEADER)
388 if (strncmp(header, Y4M_FRAME_MAGIC, strlen(Y4M_FRAME_MAGIC)))
391 width = st->codec->width;
392 height = st->codec->height;
394 packet_size = avpicture_get_size(st->codec->pix_fmt, width, height);
398 if (av_get_packet(s->pb, pkt, packet_size) != packet_size)
401 if (st->codec->coded_frame) {
402 st->codec->coded_frame->interlaced_frame = s1->interlaced_frame;
403 st->codec->coded_frame->top_field_first = s1->top_field_first;
406 pkt->stream_index = 0;
410 static int yuv4_probe(AVProbeData *pd)
412 /* check file header */
413 if (strncmp(pd->buf, Y4M_MAGIC, sizeof(Y4M_MAGIC) - 1) == 0)
414 return AVPROBE_SCORE_MAX;
419 #if CONFIG_YUV4MPEGPIPE_DEMUXER
420 AVInputFormat ff_yuv4mpegpipe_demuxer = {
421 .name = "yuv4mpegpipe",
422 .long_name = NULL_IF_CONFIG_SMALL("YUV4MPEG pipe format"),
423 .priv_data_size = sizeof(struct frame_attributes),
424 .read_probe = yuv4_probe,
425 .read_header = yuv4_read_header,
426 .read_packet = yuv4_read_packet,