1 /* 2 * Copyright (C) 2014 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 /* 18 * This file defines an NDK API. 19 * Do not remove methods. 20 * Do not change method signatures. 21 * Do not change the value of constants. 22 * Do not change the size of any of the classes defined in here. 23 * Do not reference types that are not part of the NDK. 24 * Do not #include files that aren't part of the NDK. 25 */ 26 27 #ifndef _NDK_MEDIA_FORMAT_H 28 #define _NDK_MEDIA_FORMAT_H 29 30 #include <sys/cdefs.h> 31 #include <sys/types.h> 32 33 #include "NdkMediaError.h" 34 35 #ifdef __cplusplus 36 extern "C" { 37 #endif 38 39 #if __ANDROID_API__ >= 21 40 41 struct AMediaFormat; 42 typedef struct AMediaFormat AMediaFormat; 43 44 AMediaFormat *AMediaFormat_new(); 45 media_status_t AMediaFormat_delete(AMediaFormat*); 46 47 /** 48 * Human readable representation of the format. The returned string is owned by the format, 49 * and remains valid until the next call to toString, or until the format is deleted. 50 */ 51 const char* AMediaFormat_toString(AMediaFormat*); 52 53 bool AMediaFormat_getInt32(AMediaFormat*, const char *name, int32_t *out); 54 bool AMediaFormat_getInt64(AMediaFormat*, const char *name, int64_t *out); 55 bool AMediaFormat_getFloat(AMediaFormat*, const char *name, float *out); 56 /** 57 * The returned data is owned by the format and remains valid as long as the named entry 58 * is part of the format. 59 */ 60 bool AMediaFormat_getBuffer(AMediaFormat*, const char *name, void** data, size_t *size); 61 /** 62 * The returned string is owned by the format, and remains valid until the next call to getString, 63 * or until the format is deleted. 64 */ 65 bool AMediaFormat_getString(AMediaFormat*, const char *name, const char **out); 66 67 68 void AMediaFormat_setInt32(AMediaFormat*, const char* name, int32_t value); 69 void AMediaFormat_setInt64(AMediaFormat*, const char* name, int64_t value); 70 void AMediaFormat_setFloat(AMediaFormat*, const char* name, float value); 71 /** 72 * The provided string is copied into the format. 73 */ 74 void AMediaFormat_setString(AMediaFormat*, const char* name, const char* value); 75 /** 76 * The provided data is copied into the format. 77 */ 78 void AMediaFormat_setBuffer(AMediaFormat*, const char* name, void* data, size_t size); 79 80 81 82 /** 83 * XXX should these be ints/enums that we look up in a table as needed? 84 */ 85 extern const char* AMEDIAFORMAT_KEY_AAC_PROFILE; 86 extern const char* AMEDIAFORMAT_KEY_BIT_RATE; 87 extern const char* AMEDIAFORMAT_KEY_CHANNEL_COUNT; 88 extern const char* AMEDIAFORMAT_KEY_CHANNEL_MASK; 89 extern const char* AMEDIAFORMAT_KEY_COLOR_FORMAT; 90 extern const char* AMEDIAFORMAT_KEY_DURATION; 91 extern const char* AMEDIAFORMAT_KEY_FLAC_COMPRESSION_LEVEL; 92 extern const char* AMEDIAFORMAT_KEY_FRAME_RATE; 93 extern const char* AMEDIAFORMAT_KEY_HEIGHT; 94 extern const char* AMEDIAFORMAT_KEY_IS_ADTS; 95 extern const char* AMEDIAFORMAT_KEY_IS_AUTOSELECT; 96 extern const char* AMEDIAFORMAT_KEY_IS_DEFAULT; 97 extern const char* AMEDIAFORMAT_KEY_IS_FORCED_SUBTITLE; 98 extern const char* AMEDIAFORMAT_KEY_I_FRAME_INTERVAL; 99 extern const char* AMEDIAFORMAT_KEY_LANGUAGE; 100 extern const char* AMEDIAFORMAT_KEY_MAX_HEIGHT; 101 extern const char* AMEDIAFORMAT_KEY_MAX_INPUT_SIZE; 102 extern const char* AMEDIAFORMAT_KEY_MAX_WIDTH; 103 extern const char* AMEDIAFORMAT_KEY_MIME; 104 extern const char* AMEDIAFORMAT_KEY_PUSH_BLANK_BUFFERS_ON_STOP; 105 extern const char* AMEDIAFORMAT_KEY_REPEAT_PREVIOUS_FRAME_AFTER; 106 extern const char* AMEDIAFORMAT_KEY_SAMPLE_RATE; 107 extern const char* AMEDIAFORMAT_KEY_WIDTH; 108 extern const char* AMEDIAFORMAT_KEY_STRIDE; 109 110 #endif /* __ANDROID_API__ >= 21 */ 111 112 #ifdef __cplusplus 113 } // extern "C" 114 #endif 115 116 #endif // _NDK_MEDIA_FORMAT_H 117