include/media_codec_port.h

   1 /*
   2 * Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved
   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 #ifndef __TIZEN_MEDIA_CODEC_PORT_H__
  18 #define __TIZEN_MEDIA_CODEC_PORT_H__
  19
  20 #include <tizen.h>
  21 #include <glib.h>
  22 #include <dlfcn.h>
  23 #include <gst/gst.h>
  24
  25 #include <media_codec.h>
  26 #include <media_codec_queue.h>
  27 #include <media_codec_bitstream.h>
  28 #include <media_codec_spec_emul.h>
  29 #include <media_codec_ini.h>
  30
  31
  32 /*===========================================================================================
  33 |                                                                                                                                                                                      |
  34 |  GLOBAL DEFINITIONS AND DECLARATIONS FOR MODULE                                                                                      |
  35 |                                                                                                                                                                                      |
  36 ========================================================================================== */
  37
  38 /*---------------------------------------------------------------------------
  39 |    GLOBAL #defines:                                                                                                                    |
  40 ---------------------------------------------------------------------------*/
  41 #define CHECK_BIT(x, y) (((x) >> (y)) & 0x01)
  42 #define GET_IS_ENCODER(x) CHECK_BIT(x, 0)
  43 #define GET_IS_DECODER(x) CHECK_BIT(x, 1)
  44 #define GET_IS_HW(x) CHECK_BIT(x, 2)
  45 #define GET_IS_SW(x) CHECK_BIT(x, 3)
  46
  47 //#define GET_IS_OMX(x) CHECK_BIT(x, 4)
  48 //#define GET_IS_GEN(x) CHECK_BIT(x, 5)
  49
  50 #if 1
  51 #define MEDIACODEC_FENTER();
  52 #define MEDIACODEC_FLEAVE();
  53 #else
  54 #define MEDIACODEC_FENTER();          LOGW("%s Enter",__FUNCTION__);
  55 #define MEDIACODEC_FLEAVE();          LOGW("%s Exit",__FUNCTION__);
  56 #endif
  57
  58 /*---------------------------------------------------------------------------
  59 |    GLOBAL CONSTANT DEFINITIONS:                                                                                          |
  60 ---------------------------------------------------------------------------*/
  61 /**
  62  * @brief Enumerations of media codec port's retrun value
  63  */
  64 typedef enum
  65 {
  66     MC_ERROR_NONE               =    0,
  67     MC_ERROR                    =   -1,     /**< codec happens error */
  68     MC_MEMORY_ERROR             =   -2,     /**< codec memory is not enough */
  69     MC_PARAM_ERROR              =   -3,     /**< codec parameter is error */
  70     MC_INVALID_ARG              =   -4,     /** < codec has invalid arguments */
  71     MC_PERMISSION_DENIED        =   -5,
  72     MC_INVALID_STATUS           =   -6,     /**< codec works at invalid status */
  73     MC_NOT_SUPPORTED            =   -7,     /**< codec can't support this specific video format */
  74     MC_INVALID_IN_BUF           =   -8,
  75     MC_INVALID_OUT_BUF          =   -9,
  76     MC_INTERNAL_ERROR           =   -10,
  77     MC_HW_ERROR                 =   -11,    /**< codec happens hardware error */
  78     MC_NOT_INITIALIZED          =   -12,
  79     MC_INVALID_STREAM           =   -13,
  80     MC_CODEC_NOT_FOUND          =   -14,
  81     MC_ERROR_DECODE             =   -15,
  82     MC_OUTPUT_BUFFER_EMPTY      =   -16,
  83     MC_OUTPUT_BUFFER_OVERFLOW   =   -17,    /**< codec output buffer is overflow */
  84     MC_MEMORY_ALLOCED           =   -18,    /**< codec has got memory and can decode one frame */
  85     MC_COURRPTED_INI            =   -19,
  86 } mc_ret_e;
  87
  88 /*---------------------------------------------------------------------------
  89 |    GLOBAL DATA TYPE DEFINITIONS:                                                                                         |
  90 ---------------------------------------------------------------------------*/
  91 /**
  92  * @brief Called when the dequeue input buffer done
  93  * @details It will be invoked when mediacodec has released dequeue buffer.
  94  * @param[in]   user_data  The user data passed from the callback registration function
  95  * @pre It will be invoked when dequeue buffer process completed if you register this callback using mediacodec_set_dequeue_input_buffer_cb().
  96  * @see mediacodec_set_dequeue_input_buffer_cb()
  97  * @see mediacodec_unset_dequeue_input_buffer_cb()
  98  */
  99
 100
 101 typedef struct _mc_decoder_info_t mc_decoder_info_t;
 102 typedef struct _mc_encoder_info_t mc_encoder_info_t;
 103 typedef struct _mc_handle_t mc_handle_t;
 104
 105 typedef void (*mc_dequeue_input_buffer_cb)(media_packet_h pkt, void *user_data);
 106 typedef void (*mc_empty_buffer_cb)(media_packet_h pkt, void *user_data);
 107 typedef void (*mc_fill_buffer_cb)(media_packet_h pkt, void *user_data);
 108 typedef void (*mc_error_cb)(mediacodec_error_e error, void *user_data);
 109 typedef void (*mc_eos_cb)(void *user_data);
 110 typedef void (*mc_buffer_status_cb)(mediacodec_status_e status, void *user_data);
 111 typedef void (*mc_supported_codec_cb)(mediacodec_codec_type_e codec_type, void *user_data);
 112
 113 int (*mc_sniff_bitstream)(mc_handle_t *handle, media_packet_h pkt);
 114
 115 int mc_sniff_h264_bitstream(mc_handle_t *handle, media_packet_h pkt);
 116 int mc_sniff_mpeg4_bitstream(mc_handle_t *handle, media_packet_h pkt);
 117 int mc_sniff_h263_bitstream(mc_handle_t *handle, media_packet_h pkt);
 118 int mc_sniff_yuv(mc_handle_t *handle, media_packet_h pkt);
 119
 120 typedef enum {
 121     _MEDIACODEC_EVENT_TYPE_COMPLETE,
 122     _MEDIACODEC_EVENT_TYPE_EMPTYBUFFER,
 123     _MEDIACODEC_EVENT_TYPE_FILLBUFFER,
 124     _MEDIACODEC_EVENT_TYPE_ERROR,
 125     _MEDIACODEC_EVENT_TYPE_EOS,
 126     _MEDIACODEC_EVENT_TYPE_BUFFER_STATUS,
 127     _MEDIACODEC_EVENT_TYPE_INTERNAL_FILLBUFFER,
 128     _MEDIACODEC_EVENT_TYPE_SUPPORTED_CODEC,
 129     _MEDIACODEC_EVENT_TYPE_NUM
 130 } _mediacodec_event_e;
 131
 132
 133 typedef enum _mc_codec_port_type_e
 134 {
 135     CODEC_PORT_TYPE_GENERAL,
 136     CODEC_PORT_TYPE_OMX,
 137     CODEC_PORT_TYPE_GST,
 138     CODEC_PORT_TYPE_MAX,
 139 } mc_codec_port_type_e;
 140
 141 typedef enum _mc_vendor_e
 142 {
 143     MC_VENDOR_DEFAULT,
 144     MC_VENDOR_SLSI_SEC,
 145     MC_VENDOR_SLSI_EXYNOS,
 146     MC_VENDOR_QCT,
 147     MC_VENDOR_SPRD
 148 } mc_vendor_e;
 149
 150 struct _mc_decoder_info_t
 151 {
 152     int width;
 153     int height;
 154     int actwidth;
 155     int actheight;
 156
 157     int samplerate;
 158     int channel;
 159     int bit;
 160 };
 161
 162 struct _mc_encoder_info_t
 163 {
 164     int width;
 165     int height;
 166     int bitrate;
 167     int format;
 168     int fps;
 169     int qp_min;
 170     int qp_max;
 171     int vbvbuffer_size;
 172     int level;
 173     int profile;
 174
 175     int samplerate;
 176     int channel;
 177     int bit;
 178 };
 179
 180 /* Codec Private data */
 181 struct _mc_handle_t
 182 {
 183     int state;                                  /**<  mc current state */
 184     bool is_encoder;
 185     bool is_video;
 186     bool is_hw;
 187     bool is_prepared;
 188
 189     GList *supported_codecs;
 190     mediacodec_port_type_e port_type;
 191     mediacodec_codec_type_e codec_id;
 192     mc_vendor_e vendor;
 193
 194     void *ports[2];
 195     void *core;
 196
 197     union
 198     {
 199         mc_decoder_info_t decoder;
 200         mc_encoder_info_t encoder;
 201     } info;
 202
 203     /* for process done cb */
 204     void* user_cb[_MEDIACODEC_EVENT_TYPE_NUM];
 205     void* user_data[_MEDIACODEC_EVENT_TYPE_NUM];
 206
 207     mc_codec_map_t encoder_map[MEDIA_CODEC_MAX_CODEC_TYPE];
 208     mc_codec_map_t decoder_map[MEDIA_CODEC_MAX_CODEC_TYPE];
 209
 210     int num_supported_codecs;
 211     int num_supported_decoder;
 212     int num_supported_encoder;
 213
 214     mc_ini_t ini;
 215 };
 216
 217 /*===========================================================================================
 218 |                                                                                                                                                                                      |
 219 |  GLOBAL FUNCTION PROTOTYPES                                                                                                                            |
 220 |                                                                                                                                                                                      |
 221 ========================================================================================== */
 222
 223 #ifdef __cplusplus
 224 extern "C" {
 225 #endif
 226
 227 int mc_create(MMHandleType *mediacodec);
 228 int mc_destroy(MMHandleType mediacodec);
 229
 230 int mc_set_codec(MMHandleType mediacodec, mediacodec_codec_type_e codec_id, mediacodec_support_type_e flags);
 231
 232 int mc_set_vdec_info(MMHandleType mediacodec, int width, int height);
 233 int mc_set_venc_info(MMHandleType mediacodec, int width, int height, int fps, int target_bits);
 234
 235 int mc_set_adec_info(MMHandleType mediacodec, int samplerate, int channel, int bit);
 236 int mc_set_aenc_info(MMHandleType mediacodec, int samplerate, int channel, int bit,  int bitrate);
 237
 238 int mc_prepare(MMHandleType mediacodec);
 239 int mc_unprepare(MMHandleType mediacodec);
 240
 241 int mc_process_input(MMHandleType mediacodec, media_packet_h inbuf, uint64_t timeOutUs);
 242 int mc_get_output(MMHandleType mediacodec, media_packet_h *outbuf, uint64_t timeOutUs);
 243
 244 int mc_flush_buffers(MMHandleType mediacodec);
 245 int mc_get_supported_type(MMHandleType mediacodec, mediacodec_codec_type_e codec_type, bool encoder, int *support_type);
 246
 247 int mc_set_empty_buffer_cb(MMHandleType mediacodec, mediacodec_input_buffer_used_cb callback, void* user_data);
 248 int mc_unset_empty_buffer_cb(MMHandleType mediacodec);
 249
 250 int mc_set_fill_buffer_cb(MMHandleType mediacodec, mediacodec_output_buffer_available_cb callback, void* user_data);
 251 int mc_unset_fill_buffer_cb(MMHandleType mediacodec);
 252
 253 int mc_set_error_cb(MMHandleType mediacodec, mediacodec_error_cb callback, void* user_data);
 254 int mc_unset_error_cb(MMHandleType mediacodec);
 255
 256 int mc_set_eos_cb(MMHandleType mediacodec, mediacodec_eos_cb callback, void* user_data);
 257 int mc_unset_eos_cb(MMHandleType mediacodec);
 258
 259 int mc_set_buffer_status_cb(MMHandleType mediacodec, mediacodec_buffer_status_cb callback, void* user_data);
 260 int mc_unset_buffer_status_cb(MMHandleType mediacodec);
 261
 262
 263 #ifdef __cplusplus
 264 }
 265 #endif
 266
 267 #endif /* __TIZEN_MEDIA_CODEC_PORT_H__ */