2 * Android MediaCodec decoder
4 * Copyright (c) 2015-2016 Matthieu Bouron <matthieu.bouron stupeflix.com>
6 * This file is part of FFmpeg.
8 * FFmpeg is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * FFmpeg is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with FFmpeg; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 #include <sys/types.h>
26 #include "libavutil/common.h"
27 #include "libavutil/mem.h"
28 #include "libavutil/log.h"
29 #include "libavutil/pixfmt.h"
30 #include "libavutil/time.h"
31 #include "libavutil/timestamp.h"
36 #include "mediacodec_sw_buffer.h"
37 #include "mediacodec_wrapper.h"
38 #include "mediacodecdec.h"
41 * OMX.k3.video.decoder.avc, OMX.NVIDIA.* OMX.SEC.avc.dec and OMX.google
42 * codec workarounds used in various place are taken from the Gstreamer
45 * Gstreamer references:
46 * https://cgit.freedesktop.org/gstreamer/gst-plugins-bad/tree/sys/androidmedia/
48 * Gstreamer copyright notice:
50 * Copyright (C) 2012, Collabora Ltd.
51 * Author: Sebastian Dröge <sebastian.droege@collabora.co.uk>
53 * Copyright (C) 2012, Rafaël Carré <funman@videolanorg>
55 * Copyright (C) 2015, Sebastian Dröge <sebastian@centricular.com>
57 * Copyright (C) 2014-2015, Collabora Ltd.
58 * Author: Matthieu Bouron <matthieu.bouron@gcollabora.com>
60 * Copyright (C) 2015, Edward Hervey
61 * Author: Edward Hervey <bilboed@gmail.com>
63 * Copyright (C) 2015, Matthew Waters <matthew@centricular.com>
65 * This library is free software; you can redistribute it and/or
66 * modify it under the terms of the GNU Lesser General Public
67 * License as published by the Free Software Foundation
68 * version 2.1 of the License.
70 * This library is distributed in the hope that it will be useful,
71 * but WITHOUT ANY WARRANTY; without even the implied warranty of
72 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
73 * Lesser General Public License for more details.
75 * You should have received a copy of the GNU Lesser General Public
76 * License along with this library; if not, write to the Free Software
77 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
81 #define INPUT_DEQUEUE_TIMEOUT_US 8000
82 #define OUTPUT_DEQUEUE_TIMEOUT_US 8000
83 #define OUTPUT_DEQUEUE_BLOCK_TIMEOUT_US 1000000
86 COLOR_FormatYUV420Planar = 0x13,
87 COLOR_FormatYUV420SemiPlanar = 0x15,
88 COLOR_FormatYCbYCr = 0x19,
89 COLOR_FormatAndroidOpaque = 0x7F000789,
90 COLOR_QCOM_FormatYUV420SemiPlanar = 0x7fa30c00,
91 COLOR_QCOM_FormatYUV420SemiPlanar32m = 0x7fa30c04,
92 COLOR_QCOM_FormatYUV420PackedSemiPlanar64x32Tile2m8ka = 0x7fa30c03,
93 COLOR_TI_FormatYUV420PackedSemiPlanar = 0x7f000100,
94 COLOR_TI_FormatYUV420PackedSemiPlanarInterlaced = 0x7f000001,
100 enum AVPixelFormat pix_fmt;
102 } color_formats[] = {
104 { COLOR_FormatYUV420Planar, AV_PIX_FMT_YUV420P },
105 { COLOR_FormatYUV420SemiPlanar, AV_PIX_FMT_NV12 },
106 { COLOR_QCOM_FormatYUV420SemiPlanar, AV_PIX_FMT_NV12 },
107 { COLOR_QCOM_FormatYUV420SemiPlanar32m, AV_PIX_FMT_NV12 },
108 { COLOR_QCOM_FormatYUV420PackedSemiPlanar64x32Tile2m8ka, AV_PIX_FMT_NV12 },
109 { COLOR_TI_FormatYUV420PackedSemiPlanar, AV_PIX_FMT_NV12 },
110 { COLOR_TI_FormatYUV420PackedSemiPlanarInterlaced, AV_PIX_FMT_NV12 },
114 static enum AVPixelFormat mcdec_map_color_format(AVCodecContext *avctx,
115 MediaCodecDecContext *s,
119 enum AVPixelFormat ret = AV_PIX_FMT_NONE;
121 if (!strcmp(s->codec_name, "OMX.k3.video.decoder.avc") && color_format == COLOR_FormatYCbYCr) {
122 s->color_format = color_format = COLOR_TI_FormatYUV420PackedSemiPlanar;
125 for (i = 0; i < FF_ARRAY_ELEMS(color_formats); i++) {
126 if (color_formats[i].color_format == color_format) {
127 return color_formats[i].pix_fmt;
131 av_log(avctx, AV_LOG_ERROR, "Output color format 0x%x (value=%d) is not supported\n",
132 color_format, color_format);
137 static int mediacodec_wrap_buffer(AVCodecContext *avctx,
138 MediaCodecDecContext *s,
142 FFAMediaCodecBufferInfo *info,
148 frame->width = avctx->width;
149 frame->height = avctx->height;
150 frame->format = avctx->pix_fmt;
152 /* MediaCodec buffers needs to be copied to our own refcounted buffers
153 * because the flush command invalidates all input and output buffers.
155 if ((ret = ff_get_buffer(avctx, frame, 0)) < 0) {
156 av_log(avctx, AV_LOG_ERROR, "Could not allocate buffer\n");
160 /* Override frame->pkt_pts as ff_get_buffer will override its value based
161 * on the last avpacket received which is not in sync with the frame:
162 * * N avpackets can be pushed before 1 frame is actually returned
163 * * 0-sized avpackets are pushed to flush remaining frames at EOS */
164 frame->pkt_pts = info->presentationTimeUs;
165 frame->pkt_dts = AV_NOPTS_VALUE;
167 av_log(avctx, AV_LOG_DEBUG,
168 "Frame: width=%d stride=%d height=%d slice-height=%d "
169 "crop-top=%d crop-bottom=%d crop-left=%d crop-right=%d encoder=%s\n"
170 "destination linesizes=%d,%d,%d\n" ,
171 avctx->width, s->stride, avctx->height, s->slice_height,
172 s->crop_top, s->crop_bottom, s->crop_left, s->crop_right, s->codec_name,
173 frame->linesize[0], frame->linesize[1], frame->linesize[2]);
175 switch (s->color_format) {
176 case COLOR_FormatYUV420Planar:
177 ff_mediacodec_sw_buffer_copy_yuv420_planar(avctx, s, data, size, info, frame);
179 case COLOR_FormatYUV420SemiPlanar:
180 case COLOR_QCOM_FormatYUV420SemiPlanar:
181 case COLOR_QCOM_FormatYUV420SemiPlanar32m:
182 ff_mediacodec_sw_buffer_copy_yuv420_semi_planar(avctx, s, data, size, info, frame);
184 case COLOR_TI_FormatYUV420PackedSemiPlanar:
185 case COLOR_TI_FormatYUV420PackedSemiPlanarInterlaced:
186 ff_mediacodec_sw_buffer_copy_yuv420_packed_semi_planar(avctx, s, data, size, info, frame);
188 case COLOR_QCOM_FormatYUV420PackedSemiPlanar64x32Tile2m8ka:
189 ff_mediacodec_sw_buffer_copy_yuv420_packed_semi_planar_64x32Tile2m8ka(avctx, s, data, size, info, frame);
192 av_log(avctx, AV_LOG_ERROR, "Unsupported color format 0x%x (value=%d)\n",
193 s->color_format, s->color_format);
194 ret = AVERROR(EINVAL);
200 status = ff_AMediaCodec_releaseOutputBuffer(s->codec, index, 0);
202 av_log(avctx, AV_LOG_ERROR, "Failed to release output buffer\n");
203 ret = AVERROR_EXTERNAL;
209 static int mediacodec_dec_parse_format(AVCodecContext *avctx, MediaCodecDecContext *s)
217 av_log(avctx, AV_LOG_ERROR, "Output MediaFormat is not set\n");
218 return AVERROR(EINVAL);
221 format = ff_AMediaFormat_toString(s->format);
223 return AVERROR_EXTERNAL;
225 av_log(avctx, AV_LOG_DEBUG, "Parsing MediaFormat %s\n", format);
228 /* Mandatory fields */
229 if (!ff_AMediaFormat_getInt32(s->format, "width", &value)) {
230 format = ff_AMediaFormat_toString(s->format);
231 av_log(avctx, AV_LOG_ERROR, "Could not get %s from format %s\n", "width", format);
233 return AVERROR_EXTERNAL;
237 if (!ff_AMediaFormat_getInt32(s->format, "height", &value)) {
238 format = ff_AMediaFormat_toString(s->format);
239 av_log(avctx, AV_LOG_ERROR, "Could not get %s from format %s\n", "height", format);
241 return AVERROR_EXTERNAL;
245 if (!ff_AMediaFormat_getInt32(s->format, "stride", &value)) {
246 format = ff_AMediaFormat_toString(s->format);
247 av_log(avctx, AV_LOG_ERROR, "Could not get %s from format %s\n", "stride", format);
249 return AVERROR_EXTERNAL;
251 s->stride = value > 0 ? value : s->width;
253 if (!ff_AMediaFormat_getInt32(s->format, "slice-height", &value)) {
254 format = ff_AMediaFormat_toString(s->format);
255 av_log(avctx, AV_LOG_ERROR, "Could not get %s from format %s\n", "slice-height", format);
257 return AVERROR_EXTERNAL;
259 s->slice_height = value > 0 ? value : s->height;
261 if (strstr(s->codec_name, "OMX.Nvidia.")) {
262 s->slice_height = FFALIGN(s->height, 16);
263 } else if (strstr(s->codec_name, "OMX.SEC.avc.dec")) {
264 s->slice_height = avctx->height;
265 s->stride = avctx->width;
268 if (!ff_AMediaFormat_getInt32(s->format, "color-format", &value)) {
269 format = ff_AMediaFormat_toString(s->format);
270 av_log(avctx, AV_LOG_ERROR, "Could not get %s from format %s\n", "color-format", format);
272 return AVERROR_EXTERNAL;
274 s->color_format = value;
276 s->pix_fmt = avctx->pix_fmt = mcdec_map_color_format(avctx, s, value);
277 if (avctx->pix_fmt == AV_PIX_FMT_NONE) {
278 av_log(avctx, AV_LOG_ERROR, "Output color format is not supported\n");
279 return AVERROR(EINVAL);
282 /* Optional fields */
283 if (ff_AMediaFormat_getInt32(s->format, "crop-top", &value))
286 if (ff_AMediaFormat_getInt32(s->format, "crop-bottom", &value))
287 s->crop_bottom = value;
289 if (ff_AMediaFormat_getInt32(s->format, "crop-left", &value))
290 s->crop_left = value;
292 if (ff_AMediaFormat_getInt32(s->format, "crop-right", &value))
293 s->crop_right = value;
295 width = s->crop_right + 1 - s->crop_left;
296 height = s->crop_bottom + 1 - s->crop_top;
298 av_log(avctx, AV_LOG_INFO,
299 "Output crop parameters top=%d bottom=%d left=%d right=%d, "
300 "resulting dimensions width=%d height=%d\n",
301 s->crop_top, s->crop_bottom, s->crop_left, s->crop_right,
304 return ff_set_dimensions(avctx, width, height);
307 int ff_mediacodec_dec_init(AVCodecContext *avctx, MediaCodecDecContext *s,
308 const char *mime, FFAMediaFormat *format)
314 s->first_buffer_at = av_gettime();
316 profile = ff_AMediaCodecProfile_getProfileFromAVCodecContext(avctx);
318 av_log(avctx, AV_LOG_WARNING, "Unsupported or unknown profile");
321 s->codec_name = ff_AMediaCodecList_getCodecNameByType(mime, profile, 0, avctx);
322 if (!s->codec_name) {
323 ret = AVERROR_EXTERNAL;
327 av_log(avctx, AV_LOG_DEBUG, "Found decoder %s\n", s->codec_name);
328 s->codec = ff_AMediaCodec_createCodecByName(s->codec_name);
330 av_log(avctx, AV_LOG_ERROR, "Failed to create media decoder for type %s and name %s\n", mime, s->codec_name);
331 ret = AVERROR_EXTERNAL;
335 status = ff_AMediaCodec_configure(s->codec, format, NULL, NULL, 0);
337 char *desc = ff_AMediaFormat_toString(format);
338 av_log(avctx, AV_LOG_ERROR,
339 "Failed to configure codec (status = %d) with format %s\n",
343 ret = AVERROR_EXTERNAL;
347 status = ff_AMediaCodec_start(s->codec);
349 char *desc = ff_AMediaFormat_toString(format);
350 av_log(avctx, AV_LOG_ERROR,
351 "Failed to start codec (status = %d) with format %s\n",
354 ret = AVERROR_EXTERNAL;
358 s->format = ff_AMediaCodec_getOutputFormat(s->codec);
360 if ((ret = mediacodec_dec_parse_format(avctx, s)) < 0) {
361 av_log(avctx, AV_LOG_ERROR,
362 "Failed to configure context\n");
367 av_log(avctx, AV_LOG_DEBUG, "MediaCodec %p started successfully\n", s->codec);
372 av_log(avctx, AV_LOG_ERROR, "MediaCodec %p failed to start\n", s->codec);
373 ff_mediacodec_dec_close(avctx, s);
377 int ff_mediacodec_dec_decode(AVCodecContext *avctx, MediaCodecDecContext *s,
378 AVFrame *frame, int *got_frame,
383 int need_flushing = 0;
387 FFAMediaCodec *codec = s->codec;
388 FFAMediaCodecBufferInfo info = { 0 };
392 int64_t input_dequeue_timeout_us = INPUT_DEQUEUE_TIMEOUT_US;
393 int64_t output_dequeue_timeout_us = OUTPUT_DEQUEUE_TIMEOUT_US;
395 if (pkt->size == 0) {
399 if (s->flushing && need_flushing && s->queued_buffer_nb <= 0) {
403 while (offset < pkt->size || (need_flushing && !s->flushing)) {
406 index = ff_AMediaCodec_dequeueInputBuffer(codec, input_dequeue_timeout_us);
407 if (ff_AMediaCodec_infoTryAgainLater(codec, index)) {
412 av_log(avctx, AV_LOG_ERROR, "Failed to dequeue input buffer (status=%zd)\n", index);
413 return AVERROR_EXTERNAL;
416 data = ff_AMediaCodec_getInputBuffer(codec, index, &size);
418 av_log(avctx, AV_LOG_ERROR, "Failed to get input buffer\n");
419 return AVERROR_EXTERNAL;
423 uint32_t flags = ff_AMediaCodec_getBufferFlagEndOfStream(codec);
425 av_log(avctx, AV_LOG_DEBUG, "Sending End Of Stream signal\n");
427 status = ff_AMediaCodec_queueInputBuffer(codec, index, 0, 0, pkt->pts, flags);
429 av_log(avctx, AV_LOG_ERROR, "Failed to queue input empty buffer (status = %d)\n", status);
430 return AVERROR_EXTERNAL;
436 size = FFMIN(pkt->size - offset, size);
438 memcpy(data, pkt->data + offset, size);
441 status = ff_AMediaCodec_queueInputBuffer(codec, index, 0, size, pkt->pts, 0);
443 av_log(avctx, AV_LOG_ERROR, "Failed to queue input buffer (status = %d)\n", status);
444 return AVERROR_EXTERNAL;
447 s->queued_buffer_nb++;
448 if (s->queued_buffer_nb > s->queued_buffer_max)
449 s->queued_buffer_max = s->queued_buffer_nb;
454 /* If the codec is flushing, block for a fair amount of time to
455 * ensure we got a frame */
456 output_dequeue_timeout_us = OUTPUT_DEQUEUE_BLOCK_TIMEOUT_US;
457 } else if (s->dequeued_buffer_nb == 0) {
458 /* If the codec hasn't produced any frames, do not block so we
459 * can push data to it as fast as possible, and get the first
461 output_dequeue_timeout_us = 0;
464 index = ff_AMediaCodec_dequeueOutputBuffer(codec, &info, output_dequeue_timeout_us);
468 if (!s->first_buffer++) {
469 av_log(avctx, AV_LOG_DEBUG, "Got first buffer after %fms\n", (av_gettime() - s->first_buffer_at) / 1000);
472 av_log(avctx, AV_LOG_DEBUG, "Got output buffer %zd"
473 " offset=%" PRIi32 " size=%" PRIi32 " ts=%" PRIi64
474 " flags=%" PRIu32 "\n", index, info.offset, info.size,
475 info.presentationTimeUs, info.flags);
478 data = ff_AMediaCodec_getOutputBuffer(codec, index, &size);
480 av_log(avctx, AV_LOG_ERROR, "Failed to get output buffer\n");
481 return AVERROR_EXTERNAL;
484 if ((ret = mediacodec_wrap_buffer(avctx, s, data, size, index, &info, frame)) < 0) {
485 av_log(avctx, AV_LOG_ERROR, "Failed to wrap MediaCodec buffer\n");
490 s->queued_buffer_nb--;
491 s->dequeued_buffer_nb++;
493 status = ff_AMediaCodec_releaseOutputBuffer(codec, index, 0);
495 av_log(avctx, AV_LOG_ERROR, "Failed to release output buffer\n");
499 } else if (ff_AMediaCodec_infoOutputFormatChanged(codec, index)) {
503 status = ff_AMediaFormat_delete(s->format);
505 av_log(avctx, AV_LOG_ERROR, "Failed to delete MediaFormat %p\n", s->format);
509 s->format = ff_AMediaCodec_getOutputFormat(codec);
511 av_log(avctx, AV_LOG_ERROR, "Failed to get output format\n");
512 return AVERROR_EXTERNAL;
515 format = ff_AMediaFormat_toString(s->format);
517 return AVERROR_EXTERNAL;
519 av_log(avctx, AV_LOG_INFO, "Output MediaFormat changed to %s\n", format);
522 if ((ret = mediacodec_dec_parse_format(avctx, s)) < 0) {
526 } else if (ff_AMediaCodec_infoOutputBuffersChanged(codec, index)) {
527 ff_AMediaCodec_cleanOutputBuffers(codec);
528 } else if (ff_AMediaCodec_infoTryAgainLater(codec, index)) {
530 av_log(avctx, AV_LOG_ERROR, "Failed to dequeue output buffer within %" PRIi64 "ms "
531 "while flushing remaining frames, output will probably lack last %d frames\n",
532 output_dequeue_timeout_us / 1000, s->queued_buffer_nb);
534 av_log(avctx, AV_LOG_DEBUG, "No output buffer available, try again later\n");
537 av_log(avctx, AV_LOG_ERROR, "Failed to dequeue output buffer (status=%zd)\n", index);
538 return AVERROR_EXTERNAL;
544 int ff_mediacodec_dec_flush(AVCodecContext *avctx, MediaCodecDecContext *s)
546 FFAMediaCodec *codec = s->codec;
549 s->queued_buffer_nb = 0;
550 s->dequeued_buffer_nb = 0;
554 status = ff_AMediaCodec_flush(codec);
556 av_log(avctx, AV_LOG_ERROR, "Failed to flush codec\n");
557 return AVERROR_EXTERNAL;
561 s->first_buffer_at = av_gettime();
566 int ff_mediacodec_dec_close(AVCodecContext *avctx, MediaCodecDecContext *s)
569 ff_AMediaCodec_delete(s->codec);
574 ff_AMediaFormat_delete(s->format);
578 av_freep(&s->codec_name);