2 * Magic Lantern Video (MLV) demuxer
3 * Copyright (c) 2014 Peter Ross
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 * Magic Lantern Video (MLV) demuxer
27 #include "libavutil/eval.h"
28 #include "libavutil/imgutils.h"
29 #include "libavutil/intreadwrite.h"
30 #include "libavutil/rational.h"
32 #include "avio_internal.h"
36 #define MLV_VERSION "v2.0"
38 #define MLV_VIDEO_CLASS_RAW 1
39 #define MLV_VIDEO_CLASS_YUV 2
40 #define MLV_VIDEO_CLASS_JPEG 3
41 #define MLV_VIDEO_CLASS_H264 4
43 #define MLV_AUDIO_CLASS_WAV 1
45 #define MLV_CLASS_FLAG_DELTA 0x40
46 #define MLV_CLASS_FLAG_LZMA 0x80
55 static int probe(AVProbeData *p)
57 if (AV_RL32(p->buf) == MKTAG('M','L','V','I') &&
58 AV_RL32(p->buf + 4) >= 52 &&
59 !memcmp(p->buf + 8, MLV_VERSION, 5))
60 return AVPROBE_SCORE_MAX;
64 static int check_file_header(AVIOContext *pb, uint64_t guid)
72 return AVERROR_INVALIDDATA;
73 avio_read(pb, version, 8);
74 if (memcmp(version, MLV_VERSION, 5) || avio_rl64(pb) != guid)
75 return AVERROR_INVALIDDATA;
76 avio_skip(pb, size - 24);
80 static void read_string(AVFormatContext *avctx, AVIOContext *pb, const char *tag, int size)
82 char * value = av_malloc(size + 1);
88 avio_read(pb, value, size);
95 av_dict_set(&avctx->metadata, tag, value, AV_DICT_DONT_STRDUP_VAL);
98 static void read_uint8(AVFormatContext *avctx, AVIOContext *pb, const char *tag, const char *fmt)
100 av_dict_set_int(&avctx->metadata, tag, avio_r8(pb), 0);
103 static void read_uint16(AVFormatContext *avctx, AVIOContext *pb, const char *tag, const char *fmt)
105 av_dict_set_int(&avctx->metadata, tag, avio_rl16(pb), 0);
108 static void read_uint32(AVFormatContext *avctx, AVIOContext *pb, const char *tag, const char *fmt)
110 av_dict_set_int(&avctx->metadata, tag, avio_rl32(pb), 0);
113 static void read_uint64(AVFormatContext *avctx, AVIOContext *pb, const char *tag, const char *fmt)
115 av_dict_set_int(&avctx->metadata, tag, avio_rl64(pb), 0);
118 static int scan_file(AVFormatContext *avctx, AVStream *vst, AVStream *ast, int file)
120 MlvContext *mlv = avctx->priv_data;
121 AVIOContext *pb = mlv->pb[file];
123 while (!avio_feof(pb)) {
126 type = avio_rl32(pb);
127 size = avio_rl32(pb);
128 avio_skip(pb, 8); //timestamp
132 if (vst && type == MKTAG('R','A','W','I') && size >= 164) {
133 vst->codecpar->width = avio_rl16(pb);
134 vst->codecpar->height = avio_rl16(pb);
135 ret = av_image_check_size(vst->codecpar->width, vst->codecpar->height, 0, avctx);
138 if (avio_rl32(pb) != 1)
139 avpriv_request_sample(avctx, "raw api version");
140 avio_skip(pb, 20); // pointer, width, height, pitch, frame_size
141 vst->codecpar->bits_per_coded_sample = avio_rl32(pb);
142 if (vst->codecpar->bits_per_coded_sample < 0 ||
143 vst->codecpar->bits_per_coded_sample > (INT_MAX - 7) / (vst->codecpar->width * vst->codecpar->height)) {
144 av_log(avctx, AV_LOG_ERROR,
145 "invalid bits_per_coded_sample %d (size: %dx%d)\n",
146 vst->codecpar->bits_per_coded_sample,
147 vst->codecpar->width, vst->codecpar->height);
148 return AVERROR_INVALIDDATA;
150 avio_skip(pb, 8 + 16 + 24); // black_level, white_level, xywh, active_area, exposure_bias
151 if (avio_rl32(pb) != 0x2010100) /* RGGB */
152 avpriv_request_sample(avctx, "cfa_pattern");
153 avio_skip(pb, 80); // calibration_illuminant1, color_matrix1, dynamic_range
154 vst->codecpar->format = AV_PIX_FMT_BAYER_RGGB16LE;
155 vst->codecpar->codec_tag = MKTAG('B', 'I', 'T', 16);
157 } else if (ast && type == MKTAG('W', 'A', 'V', 'I') && size >= 16) {
158 ret = ff_get_wav_header(avctx, pb, ast->codecpar, 16, 0);
162 } else if (type == MKTAG('I','N','F','O')) {
164 read_string(avctx, pb, "info", size);
166 } else if (type == MKTAG('I','D','N','T') && size >= 36) {
167 read_string(avctx, pb, "cameraName", 32);
168 read_uint32(avctx, pb, "cameraModel", "0x%"PRIx32);
171 read_string(avctx, pb, "cameraSerial", 32);
174 } else if (type == MKTAG('L','E','N','S') && size >= 48) {
175 read_uint16(avctx, pb, "focalLength", "%i");
176 read_uint16(avctx, pb, "focalDist", "%i");
177 read_uint16(avctx, pb, "aperture", "%i");
178 read_uint8(avctx, pb, "stabilizerMode", "%i");
179 read_uint8(avctx, pb, "autofocusMode", "%i");
180 read_uint32(avctx, pb, "flags", "0x%"PRIx32);
181 read_uint32(avctx, pb, "lensID", "%"PRIi32);
182 read_string(avctx, pb, "lensName", 32);
185 read_string(avctx, pb, "lensSerial", 32);
188 } else if (vst && type == MKTAG('V', 'I', 'D', 'F') && size >= 4) {
189 uint64_t pts = avio_rl32(pb);
190 ff_add_index_entry(&vst->index_entries, &vst->nb_index_entries, &vst->index_entries_allocated_size,
191 avio_tell(pb) - 20, pts, file, 0, AVINDEX_KEYFRAME);
193 } else if (ast && type == MKTAG('A', 'U', 'D', 'F') && size >= 4) {
194 uint64_t pts = avio_rl32(pb);
195 ff_add_index_entry(&ast->index_entries, &ast->nb_index_entries, &ast->index_entries_allocated_size,
196 avio_tell(pb) - 20, pts, file, 0, AVINDEX_KEYFRAME);
198 } else if (vst && type == MKTAG('W','B','A','L') && size >= 28) {
199 read_uint32(avctx, pb, "wb_mode", "%"PRIi32);
200 read_uint32(avctx, pb, "kelvin", "%"PRIi32);
201 read_uint32(avctx, pb, "wbgain_r", "%"PRIi32);
202 read_uint32(avctx, pb, "wbgain_g", "%"PRIi32);
203 read_uint32(avctx, pb, "wbgain_b", "%"PRIi32);
204 read_uint32(avctx, pb, "wbs_gm", "%"PRIi32);
205 read_uint32(avctx, pb, "wbs_ba", "%"PRIi32);
207 } else if (type == MKTAG('R','T','C','I') && size >= 20) {
209 struct tm time = { 0 };
210 time.tm_sec = avio_rl16(pb);
211 time.tm_min = avio_rl16(pb);
212 time.tm_hour = avio_rl16(pb);
213 time.tm_mday = avio_rl16(pb);
214 time.tm_mon = avio_rl16(pb);
215 time.tm_year = avio_rl16(pb);
216 time.tm_wday = avio_rl16(pb);
217 time.tm_yday = avio_rl16(pb);
218 time.tm_isdst = avio_rl16(pb);
220 if (strftime(str, sizeof(str), "%Y-%m-%d %H:%M:%S", &time))
221 av_dict_set(&avctx->metadata, "time", str, 0);
223 } else if (type == MKTAG('E','X','P','O') && size >= 16) {
224 av_dict_set(&avctx->metadata, "isoMode", avio_rl32(pb) ? "auto" : "manual", 0);
225 read_uint32(avctx, pb, "isoValue", "%"PRIi32);
226 read_uint32(avctx, pb, "isoAnalog", "%"PRIi32);
227 read_uint32(avctx, pb, "digitalGain", "%"PRIi32);
230 read_uint64(avctx, pb, "shutterValue", "%"PRIi64);
233 } else if (type == MKTAG('S','T','Y','L') && size >= 36) {
234 read_uint32(avctx, pb, "picStyleId", "%"PRIi32);
235 read_uint32(avctx, pb, "contrast", "%"PRIi32);
236 read_uint32(avctx, pb, "sharpness", "%"PRIi32);
237 read_uint32(avctx, pb, "saturation", "%"PRIi32);
238 read_uint32(avctx, pb, "colortone", "%"PRIi32);
239 read_string(avctx, pb, "picStyleName", 16);
241 } else if (type == MKTAG('M','A','R','K')) {
242 } else if (type == MKTAG('N','U','L','L')) {
243 } else if (type == MKTAG('M','L','V','I')) { /* occurs when MLV and Mnn files are concatenated */
245 av_log(avctx, AV_LOG_INFO, "unsupported tag %c%c%c%c, size %u\n", type&0xFF, (type>>8)&0xFF, (type>>16)&0xFF, (type>>24)&0xFF, size);
252 static int read_header(AVFormatContext *avctx)
254 MlvContext *mlv = avctx->priv_data;
255 AVIOContext *pb = avctx->pb;
256 AVStream *vst = NULL, *ast = NULL;
258 unsigned nb_video_frames, nb_audio_frames;
263 size = avio_rl32(pb);
265 return AVERROR_INVALIDDATA;
269 guid = avio_rl64(pb);
270 snprintf(guidstr, sizeof(guidstr), "0x%"PRIx64, guid);
271 av_dict_set(&avctx->metadata, "guid", guidstr, 0);
273 avio_skip(pb, 8); //fileNum, fileCount, fileFlags
275 mlv->class[0] = avio_rl16(pb);
276 mlv->class[1] = avio_rl16(pb);
278 nb_video_frames = avio_rl32(pb);
279 nb_audio_frames = avio_rl32(pb);
281 if (nb_video_frames && mlv->class[0]) {
282 vst = avformat_new_stream(avctx, NULL);
284 return AVERROR(ENOMEM);
286 vst->nb_frames = nb_video_frames;
287 if ((mlv->class[0] & (MLV_CLASS_FLAG_DELTA|MLV_CLASS_FLAG_LZMA)))
288 avpriv_request_sample(avctx, "compression");
289 vst->codecpar->codec_type = AVMEDIA_TYPE_VIDEO;
290 switch (mlv->class[0] & ~(MLV_CLASS_FLAG_DELTA|MLV_CLASS_FLAG_LZMA)) {
291 case MLV_VIDEO_CLASS_RAW:
292 vst->codecpar->codec_id = AV_CODEC_ID_RAWVIDEO;
294 case MLV_VIDEO_CLASS_YUV:
295 vst->codecpar->format = AV_PIX_FMT_YUV420P;
296 vst->codecpar->codec_id = AV_CODEC_ID_RAWVIDEO;
297 vst->codecpar->codec_tag = 0;
299 case MLV_VIDEO_CLASS_JPEG:
300 vst->codecpar->codec_id = AV_CODEC_ID_MJPEG;
301 vst->codecpar->codec_tag = 0;
303 case MLV_VIDEO_CLASS_H264:
304 vst->codecpar->codec_id = AV_CODEC_ID_H264;
305 vst->codecpar->codec_tag = 0;
308 avpriv_request_sample(avctx, "unknown video class");
312 if (nb_audio_frames && mlv->class[1]) {
313 ast = avformat_new_stream(avctx, NULL);
315 return AVERROR(ENOMEM);
317 ast->nb_frames = nb_audio_frames;
318 if ((mlv->class[1] & MLV_CLASS_FLAG_LZMA))
319 avpriv_request_sample(avctx, "compression");
320 if ((mlv->class[1] & ~MLV_CLASS_FLAG_LZMA) != MLV_AUDIO_CLASS_WAV)
321 avpriv_request_sample(avctx, "unknown audio class");
323 ast->codecpar->codec_type = AVMEDIA_TYPE_AUDIO;
324 avpriv_set_pts_info(ast, 33, 1, ast->codecpar->sample_rate);
328 AVRational framerate;
329 framerate.num = avio_rl32(pb);
330 framerate.den = avio_rl32(pb);
331 avpriv_set_pts_info(vst, 64, framerate.den, framerate.num);
335 avio_skip(pb, size - 52);
337 /* scan primary file */
338 mlv->pb[100] = avctx->pb;
339 ret = scan_file(avctx, vst, ast, 100);
343 /* scan secondary files */
344 if (strlen(avctx->filename) > 2) {
346 char *filename = av_strdup(avctx->filename);
349 return AVERROR(ENOMEM);
351 for (i = 0; i < 100; i++) {
352 snprintf(filename + strlen(filename) - 2, 3, "%02d", i);
353 if (avctx->io_open(avctx, &mlv->pb[i], filename, AVIO_FLAG_READ, NULL) < 0)
355 if (check_file_header(mlv->pb[i], guid) < 0) {
356 av_log(avctx, AV_LOG_WARNING, "ignoring %s; bad format or guid mismatch\n", filename);
357 ff_format_io_close(avctx, &mlv->pb[i]);
360 av_log(avctx, AV_LOG_INFO, "scanning %s\n", filename);
361 ret = scan_file(avctx, vst, ast, i);
363 av_log(avctx, AV_LOG_WARNING, "ignoring %s; %s\n", filename, av_err2str(ret));
364 ff_format_io_close(avctx, &mlv->pb[i]);
372 vst->duration = vst->nb_index_entries;
374 ast->duration = ast->nb_index_entries;
376 if ((vst && !vst->nb_index_entries) || (ast && !ast->nb_index_entries)) {
377 av_log(avctx, AV_LOG_ERROR, "no index entries found\n");
378 return AVERROR_INVALIDDATA;
382 avio_seek(pb, FFMIN(vst->index_entries[0].pos, ast->index_entries[0].pos), SEEK_SET);
384 avio_seek(pb, vst->index_entries[0].pos, SEEK_SET);
386 avio_seek(pb, ast->index_entries[0].pos, SEEK_SET);
391 static int read_packet(AVFormatContext *avctx, AVPacket *pkt)
393 MlvContext *mlv = avctx->priv_data;
395 AVStream *st = avctx->streams[mlv->stream_index];
397 unsigned int size, space;
399 if (mlv->pts >= st->duration)
402 index = av_index_search_timestamp(st, mlv->pts, AVSEEK_FLAG_ANY);
404 av_log(avctx, AV_LOG_ERROR, "could not find index entry for frame %"PRId64"\n", mlv->pts);
408 pb = mlv->pb[st->index_entries[index].size];
409 avio_seek(pb, st->index_entries[index].pos, SEEK_SET);
411 avio_skip(pb, 4); // blockType
412 size = avio_rl32(pb);
414 return AVERROR_INVALIDDATA;
415 avio_skip(pb, 12); //timestamp, frameNumber
416 if (st->codecpar->codec_type == AVMEDIA_TYPE_VIDEO)
417 avio_skip(pb, 8); // cropPosX, cropPosY, panPosX, panPosY
418 space = avio_rl32(pb);
419 avio_skip(pb, space);
421 if ((mlv->class[st->id] & (MLV_CLASS_FLAG_DELTA|MLV_CLASS_FLAG_LZMA))) {
422 ret = AVERROR_PATCHWELCOME;
423 } else if (st->codecpar->codec_type == AVMEDIA_TYPE_VIDEO) {
424 ret = av_get_packet(pb, pkt, (st->codecpar->width * st->codecpar->height * st->codecpar->bits_per_coded_sample + 7) >> 3);
425 } else { // AVMEDIA_TYPE_AUDIO
426 if (space > UINT_MAX - 24 || size < (24 + space))
427 return AVERROR_INVALIDDATA;
428 ret = av_get_packet(pb, pkt, size - (24 + space));
434 pkt->stream_index = mlv->stream_index;
438 if (mlv->stream_index == avctx->nb_streams) {
439 mlv->stream_index = 0;
445 static int read_seek(AVFormatContext *avctx, int stream_index, int64_t timestamp, int flags)
447 MlvContext *mlv = avctx->priv_data;
449 if ((flags & AVSEEK_FLAG_FRAME) || (flags & AVSEEK_FLAG_BYTE))
450 return AVERROR(ENOSYS);
452 if (!avctx->pb->seekable)
455 mlv->pts = timestamp;
459 static int read_close(AVFormatContext *s)
461 MlvContext *mlv = s->priv_data;
463 for (i = 0; i < 100; i++)
465 ff_format_io_close(s, &mlv->pb[i]);
469 AVInputFormat ff_mlv_demuxer = {
471 .long_name = NULL_IF_CONFIG_SMALL("Magic Lantern Video (MLV)"),
472 .priv_data_size = sizeof(MlvContext),
474 .read_header = read_header,
475 .read_packet = read_packet,
476 .read_close = read_close,
477 .read_seek = read_seek,