blob: 1b4f3a9492bcce828ed186dce703db6db66f44c8
1 | /* |
2 | * Android MediaCodec Wrapper |
3 | * |
4 | * Copyright (c) 2015-2016 Matthieu Bouron <matthieu.bouron stupeflix.com> |
5 | * |
6 | * This file is part of FFmpeg. |
7 | * |
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. |
12 | * |
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. |
17 | * |
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 |
21 | */ |
22 | |
23 | #ifndef AVCODEC_MEDIACODEC_WRAPPER_H |
24 | #define AVCODEC_MEDIACODEC_WRAPPER_H |
25 | |
26 | #include <stdint.h> |
27 | #include <sys/types.h> |
28 | |
29 | /** |
30 | * The following API around MediaCodec and MediaFormat is based on the |
31 | * NDK one provided by Google since Android 5.0. |
32 | * |
33 | * Differences from the NDK API: |
34 | * |
35 | * Buffers returned by ff_AMediaFormat_toString and ff_AMediaFormat_getString |
36 | * are newly allocated buffer and must be freed by the user after use. |
37 | * |
38 | * The MediaCrypto API is not implemented. |
39 | * |
40 | * ff_AMediaCodec_infoTryAgainLater, ff_AMediaCodec_infoOutputBuffersChanged, |
41 | * ff_AMediaCodec_infoOutputFormatChanged, ff_AMediaCodec_cleanOutputBuffers |
42 | * ff_AMediaCodec_getName and ff_AMediaCodec_getBufferFlagEndOfStream are not |
43 | * part of the original NDK API and are convenience functions to hide JNI |
44 | * implementation. |
45 | * |
46 | * The API around MediaCodecList is not part of the NDK (and is lacking as |
47 | * we still need to retrieve the codec name to work around faulty decoders |
48 | * and encoders). |
49 | * |
50 | * For documentation, please refers to NdkMediaCodec.h NdkMediaFormat.h and |
51 | * http://developer.android.com/reference/android/media/MediaCodec.html. |
52 | * |
53 | */ |
54 | |
55 | int ff_AMediaCodecProfile_getProfileFromAVCodecContext(AVCodecContext *avctx); |
56 | |
57 | char *ff_AMediaCodecList_getCodecNameByType(const char *mime, int profile, int encoder, void *log_ctx); |
58 | |
59 | struct FFAMediaFormat; |
60 | typedef struct FFAMediaFormat FFAMediaFormat; |
61 | |
62 | FFAMediaFormat *ff_AMediaFormat_new(void); |
63 | int ff_AMediaFormat_delete(FFAMediaFormat* format); |
64 | |
65 | char* ff_AMediaFormat_toString(FFAMediaFormat* format); |
66 | |
67 | int ff_AMediaFormat_getInt32(FFAMediaFormat* format, const char *name, int32_t *out); |
68 | int ff_AMediaFormat_getInt64(FFAMediaFormat* format, const char *name, int64_t *out); |
69 | int ff_AMediaFormat_getFloat(FFAMediaFormat* format, const char *name, float *out); |
70 | int ff_AMediaFormat_getBuffer(FFAMediaFormat* format, const char *name, void** data, size_t *size); |
71 | int ff_AMediaFormat_getString(FFAMediaFormat* format, const char *name, const char **out); |
72 | |
73 | void ff_AMediaFormat_setInt32(FFAMediaFormat* format, const char* name, int32_t value); |
74 | void ff_AMediaFormat_setInt64(FFAMediaFormat* format, const char* name, int64_t value); |
75 | void ff_AMediaFormat_setFloat(FFAMediaFormat* format, const char* name, float value); |
76 | void ff_AMediaFormat_setString(FFAMediaFormat* format, const char* name, const char* value); |
77 | void ff_AMediaFormat_setBuffer(FFAMediaFormat* format, const char* name, void* data, size_t size); |
78 | |
79 | struct FFAMediaCodec; |
80 | typedef struct FFAMediaCodec FFAMediaCodec; |
81 | typedef struct FFAMediaCodecCryptoInfo FFAMediaCodecCryptoInfo; |
82 | |
83 | struct FFAMediaCodecBufferInfo { |
84 | int32_t offset; |
85 | int32_t size; |
86 | int64_t presentationTimeUs; |
87 | uint32_t flags; |
88 | }; |
89 | typedef struct FFAMediaCodecBufferInfo FFAMediaCodecBufferInfo; |
90 | |
91 | char *ff_AMediaCodec_getName(FFAMediaCodec *codec); |
92 | |
93 | FFAMediaCodec* ff_AMediaCodec_createCodecByName(const char *name); |
94 | FFAMediaCodec* ff_AMediaCodec_createDecoderByType(const char *mime_type); |
95 | FFAMediaCodec* ff_AMediaCodec_createEncoderByType(const char *mime_type); |
96 | |
97 | int ff_AMediaCodec_configure(FFAMediaCodec* codec, const FFAMediaFormat* format, void* surface, void *crypto, uint32_t flags); |
98 | int ff_AMediaCodec_start(FFAMediaCodec* codec); |
99 | int ff_AMediaCodec_stop(FFAMediaCodec* codec); |
100 | int ff_AMediaCodec_flush(FFAMediaCodec* codec); |
101 | int ff_AMediaCodec_delete(FFAMediaCodec* codec); |
102 | |
103 | uint8_t* ff_AMediaCodec_getInputBuffer(FFAMediaCodec* codec, size_t idx, size_t *out_size); |
104 | uint8_t* ff_AMediaCodec_getOutputBuffer(FFAMediaCodec* codec, size_t idx, size_t *out_size); |
105 | |
106 | ssize_t ff_AMediaCodec_dequeueInputBuffer(FFAMediaCodec* codec, int64_t timeoutUs); |
107 | int ff_AMediaCodec_queueInputBuffer(FFAMediaCodec* codec, size_t idx, off_t offset, size_t size, uint64_t time, uint32_t flags); |
108 | |
109 | ssize_t ff_AMediaCodec_dequeueOutputBuffer(FFAMediaCodec* codec, FFAMediaCodecBufferInfo *info, int64_t timeoutUs); |
110 | FFAMediaFormat* ff_AMediaCodec_getOutputFormat(FFAMediaCodec* codec); |
111 | |
112 | int ff_AMediaCodec_releaseOutputBuffer(FFAMediaCodec* codec, size_t idx, int render); |
113 | int ff_AMediaCodec_releaseOutputBufferAtTime(FFAMediaCodec *codec, size_t idx, int64_t timestampNs); |
114 | |
115 | int ff_AMediaCodec_infoTryAgainLater(FFAMediaCodec *codec, ssize_t idx); |
116 | int ff_AMediaCodec_infoOutputBuffersChanged(FFAMediaCodec *codec, ssize_t idx); |
117 | int ff_AMediaCodec_infoOutputFormatChanged(FFAMediaCodec *codec, ssize_t indx); |
118 | |
119 | int ff_AMediaCodec_getBufferFlagCodecConfig (FFAMediaCodec *codec); |
120 | int ff_AMediaCodec_getBufferFlagEndOfStream(FFAMediaCodec *codec); |
121 | int ff_AMediaCodec_getBufferFlagKeyFrame(FFAMediaCodec *codec); |
122 | |
123 | int ff_AMediaCodec_getConfigureFlagEncode(FFAMediaCodec *codec); |
124 | |
125 | int ff_AMediaCodec_cleanOutputBuffers(FFAMediaCodec *codec); |
126 | |
127 | #endif /* AVCODEC_MEDIACODEC_WRAPPER_H */ |
128 |