tizen 2.4 release accepted/tizen_2.4_mobile tizen_2.4 accepted/tizen/2.4/mobile/20151029.034910 submit/tizen_2.4/20151028.063521 tizen_2.4_mobile_release
authorjk7744.park <jk7744.park@samsung.com>
Sat, 24 Oct 2015 07:22:27 +0000 (16:22 +0900)
committerjk7744.park <jk7744.park@samsung.com>
Sat, 24 Oct 2015 07:22:27 +0000 (16:22 +0900)
CMakeLists.txt
include/media_format.h
include/media_format_private.h
include/media_packet.h
include/media_packet_internal.h [new file with mode: 0755]
include/media_packet_private.h
packaging/capi-media-tool.spec
src/media_format.c
src/media_packet.c
src/media_packet_internal.c [new file with mode: 0755]
test/media_packet_test.c

index 6e75836..05117a0 100755 (executable)
@@ -19,7 +19,7 @@ FOREACH(flag ${${fw_name}_CFLAGS})
     SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}")
 ENDFOREACH(flag)
 
-SET(CMAKE_C_FLAGS "-I./include -I./include/headers ${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} -fPIC -Wall -w")
+SET(CMAKE_C_FLAGS "-I./include -I./include/headers ${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} -fPIC -Wall -w -Werror -Wcast-qual -Wextra -Wno-array-bounds -Wno-empty-body -Wno-ignored-qualifiers -Wno-unused-parameter -Wshadow -Wwrite-strings -Wswitch-default -Wno-unused-but-set-parameter -Wno-unused-but-set-variable")
 SET(CMAKE_C_FLAGS_DEBUG "-O0 -g")
 
 IF("${ARCH}" STREQUAL "arm")
index 53d4d82..617061e 100755 (executable)
@@ -19,6 +19,7 @@
 
 #include <stdbool.h>
 #include <stdint.h>
+#include <tizen.h>
 
 #ifdef __cplusplus
 extern "C" {
@@ -36,14 +37,14 @@ extern "C" {
 
 /**
  * @brief Media Format handle type.
-  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+  * @since_tizen 2.3
  */
 typedef struct media_format_s* media_format_h;
 
 
 /**
  * @brief Enumerations of  media format error
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum
 {
@@ -57,7 +58,7 @@ typedef enum
 
 /**
  * @brief Enumeration for media format type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
     MEDIA_FORMAT_NONE    = 0x00000000,          /**< media format type is NONE */
@@ -69,7 +70,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for media format data type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
     MEDIA_FORMAT_ENCODED = 0x10000000,          /**< media format data type is encoded type */
@@ -78,7 +79,7 @@ typedef enum {
 
 /**
  * @brief Enumeration for media format MIME type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 
 /* TODO : More an more audio/video types are needed !!!! */
@@ -87,53 +88,70 @@ typedef enum {
 */
 typedef enum {
     /* Audio */
-    MEDIA_FORMAT_L16 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1010),          /**< media format mime type is L16, AUDIO*/
+    MEDIA_FORMAT_L16 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1010),           /**< media format mime type is L16, AUDIO*/
     MEDIA_FORMAT_ALAW = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1020),          /**< media format mime type is ALAW, AUDIO*/
     MEDIA_FORMAT_ULAW = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1030),          /**< media format mime type is ULAW,  AUDIO */
-    MEDIA_FORMAT_AMR = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1040),          /**< media format mime type is AMR,  AUDIO */
+    MEDIA_FORMAT_AMR = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1040),           /**< media format mime type is AMR,  AUDIO,  indicates MEDIA_FORMAT_AMR_NB (Since tizen 2.4) */
+    MEDIA_FORMAT_AMR_NB = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1040),        /**< media format mime type is AMR_NB,  AUDIO , (Since tizen 2.4) */
+    MEDIA_FORMAT_AMR_WB = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1041),        /**< media format mime type is AMR_WB,  AUDIO, (Since tizen 2.4) */
     MEDIA_FORMAT_G729 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1050),          /**< media format mime type is G729,  AUDIO*/
-    MEDIA_FORMAT_AAC = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1060),          /**< media format mime type is AAC,  AUDIO*/
-    MEDIA_FORMAT_MP3 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1070),          /**< media format mime type is MP3,  AUDIO*/
-
-    MEDIA_FORMAT_PCM = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_RAW | 0x1510),          /**< media format mime type is PCM, AUDIO*/
-    MEDIA_FORMAT_PCMA = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_RAW | 0x1520),          /**< media format mime type is PCM A-law, AUDIO*/
-    MEDIA_FORMAT_PCMU = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_RAW | 0x1530),          /**< media format mime type is PCM U-law, AUDIO */
+    MEDIA_FORMAT_AAC = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1060),           /**< media format mime type is AAC,  AUDIO, indicates MEDIA_FORMAT_AAC_LC (Since tizen 2.4) */
+    MEDIA_FORMAT_AAC_LC = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1060),        /**< media format mime type is AAC_LC,  AUDIO, (Since tizen 2.4) */
+    MEDIA_FORMAT_AAC_HE = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1061),        /**< media format mime type is AAC_HE,  AUDIO, (Since tizen 2.4) */
+    MEDIA_FORMAT_AAC_HE_PS = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1062),     /**< media format mime type is AAC_HE_PS,  AUDIO, (Since tizen 2.4) */
+    MEDIA_FORMAT_MP3 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1070),           /**< media format mime type is MP3,  AUDIO*/
+    MEDIA_FORMAT_VORBIS = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1080),        /**< media format mime type is VORBIS,  AUDIO, (Since tizen 2.4) */
+    MEDIA_FORMAT_FLAC = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1090),          /**< media format mime type is FLAC,  AUDIO, (Since tizen 2.4) */
+    MEDIA_FORMAT_WMAV1 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A0),         /**< media format mime type is WMAV1,  AUDIO, (Since tizen 2.4) */
+    MEDIA_FORMAT_WMAV2 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A1),         /**< media format mime type is WMAV2,  AUDIO, (Since tizen 2.4) */
+    MEDIA_FORMAT_WMAPRO = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A2),        /**< media format mime type is WMAVPRO,  AUDIO, (Since tizen 2.4) */
+    MEDIA_FORMAT_WMALSL = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A3),        /**< media format mime type is WMAVLSL,  AUDIO, (Since tizen 2.4) */
+
+    MEDIA_FORMAT_PCM = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_RAW | 0x1510),               /**< media format mime type is PCM, AUDIO*/
+    MEDIA_FORMAT_PCMA = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_RAW | 0x1520),              /**< media format mime type is PCM A-law, AUDIO*/
+    MEDIA_FORMAT_PCMU = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_RAW | 0x1530),              /**< media format mime type is PCM U-law, AUDIO */
 
     /* Video */
     MEDIA_FORMAT_H261 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2010),          /**< media format mime type is H261, VIDEO */
     MEDIA_FORMAT_H263 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2020),          /**< media format mime type is H263, VIDEO */
-    MEDIA_FORMAT_H263P = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2021),          /**< media format mime type is H263P, VIDEO */
-    MEDIA_FORMAT_H264_SP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2030),          /**< media format mime type is H264_SP, VIDEO */
-    MEDIA_FORMAT_H264_MP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2031),          /**< media format mime type is H264_MP, VIDEO */
-    MEDIA_FORMAT_H264_HP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2032),          /**< media format mime type is H264_HP, VIDEO */
-    MEDIA_FORMAT_MJPEG = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2040),          /**< media format mime type is MJPEG, VIDEO */
-    MEDIA_FORMAT_MPEG1 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2050),          /**< media format mime type is MPEG1, VIDEO */
-    MEDIA_FORMAT_MPEG2_SP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2060),          /**< media format mime type is MPEG2_SP, VIDEO */
-    MEDIA_FORMAT_MPEG2_MP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2061),          /**< media format mime type is MPEG2_MP, VIDEO */
-    MEDIA_FORMAT_MPEG2_HP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2062),          /**< media format mime type is MPEG2_HP, VIDEO */
-    MEDIA_FORMAT_MPEG4_SP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2070),          /**< media format mime type is MPEG4_SP, VIDEO */
-    MEDIA_FORMAT_MPEG4_ASP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2071),          /**< media format mime type is MPEG4_ASP, VIDEO */
-
-    MEDIA_FORMAT_I420 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2510),          /**< media format mime type is I420, VIDEO */
-    MEDIA_FORMAT_NV12 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2520),          /**< media format mime type is NV12, VIDEO */
-    MEDIA_FORMAT_NV12T = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2530),          /**< media format mime type is NV12T, VIDEO */
-    MEDIA_FORMAT_YV12 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2540),          /**< media format mime type is YV12, VIDEO */
-    MEDIA_FORMAT_NV21 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2550),          /**< media format mime type is NV21, VIDEO */
-    MEDIA_FORMAT_NV16 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2560),          /**< media format mime type is NV16, VIDEO */
-    MEDIA_FORMAT_YUYV = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2570),          /**< media format mime type is YUYV, VIDEO */
-    MEDIA_FORMAT_UYVY = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2580),          /**< media format mime type is UYVY, VIDEO */
-    MEDIA_FORMAT_422P = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2590),          /**< media format mime type is 422P, VIDEO */
-    MEDIA_FORMAT_RGB565 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x25a0),          /**< media format mime type is RGB565, VIDEO */
-    MEDIA_FORMAT_RGB888 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x25b0),          /**< media format mime type is RGB888, VIDEO */
-    MEDIA_FORMAT_RGBA = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x25c0),          /**< media format mime type is RGBA, VIDEO */
-    MEDIA_FORMAT_ARGB = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x25d0),          /**< media format mime type is ARGB, VIDEO */
+    MEDIA_FORMAT_H263P = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2021),         /**< media format mime type is H263P, VIDEO */
+    MEDIA_FORMAT_H264_SP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2030),       /**< media format mime type is H264_SP, VIDEO */
+    MEDIA_FORMAT_H264_MP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2031),       /**< media format mime type is H264_MP, VIDEO */
+    MEDIA_FORMAT_H264_HP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2032),       /**< media format mime type is H264_HP, VIDEO */
+    MEDIA_FORMAT_MJPEG = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2040),         /**< media format mime type is MJPEG, VIDEO */
+    MEDIA_FORMAT_MPEG1 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2050),         /**< media format mime type is MPEG1, VIDEO */
+    MEDIA_FORMAT_MPEG2_SP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2060),      /**< media format mime type is MPEG2_SP, VIDEO */
+    MEDIA_FORMAT_MPEG2_MP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2061),      /**< media format mime type is MPEG2_MP, VIDEO */
+    MEDIA_FORMAT_MPEG2_HP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2062),      /**< media format mime type is MPEG2_HP, VIDEO */
+    MEDIA_FORMAT_MPEG4_SP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2070),      /**< media format mime type is MPEG4_SP, VIDEO */
+    MEDIA_FORMAT_MPEG4_ASP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2071),     /**< media format mime type is MPEG4_ASP, VIDEO */
+    MEDIA_FORMAT_HEVC = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2080),          /**< media format mime type is HEVC, VIDEO, (Since tizen 2.4) */
+    MEDIA_FORMAT_VP8 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2090),           /**< media format mime type is VP8, VIDEO, (Since tizen 2.4) */
+    MEDIA_FORMAT_VP9 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x20A0),           /**< media format mime type is VP9, VIDEO, (Since tizen 2.4) */
+    MEDIA_FORMAT_VC1 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x20B0),           /**< media format mime type is VC1, VIDEO, (Since tizen 2.4) */
+
+    MEDIA_FORMAT_I420 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2510),              /**< media format mime type is I420, VIDEO */
+    MEDIA_FORMAT_NV12 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2520),              /**< media format mime type is NV12, VIDEO */
+    MEDIA_FORMAT_NV12T = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2530),             /**< media format mime type is NV12T, VIDEO */
+    MEDIA_FORMAT_YV12 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2540),              /**< media format mime type is YV12, VIDEO */
+    MEDIA_FORMAT_NV21 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2550),              /**< media format mime type is NV21, VIDEO */
+    MEDIA_FORMAT_NV16 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2560),              /**< media format mime type is NV16, VIDEO */
+    MEDIA_FORMAT_YUYV = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2570),              /**< media format mime type is YUYV, VIDEO */
+    MEDIA_FORMAT_UYVY = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2580),              /**< media format mime type is UYVY, VIDEO */
+    MEDIA_FORMAT_422P = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x2590),              /**< media format mime type is 422P, VIDEO */
+    MEDIA_FORMAT_RGB565 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x25a0),            /**< media format mime type is RGB565, VIDEO */
+    MEDIA_FORMAT_RGB888 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x25b0),            /**< media format mime type is RGB888, VIDEO */
+    MEDIA_FORMAT_RGBA = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x25c0),              /**< media format mime type is RGBA, VIDEO */
+    MEDIA_FORMAT_ARGB = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x25d0),              /**< media format mime type is ARGB, VIDEO */
+
+    MEDIA_FORMAT_NATIVE_VIDEO = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x3000),      /**< media format mime type is HW dependent , VIDEO, (Since tizen 2.4) */
 
     MEDIA_FORMAT_MAX          /**< media format mime type is MEDIA_FORMAT_MAX, Do not use */
 } media_format_mimetype_e;
 
 /**
  * @brief Enumeration for media color model.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum {
     MEDIA_COLOR_MODEL_NONE,          /**< media format color model is NONE */
@@ -144,10 +162,13 @@ typedef enum {
 
 /**
  * @brief Creates a media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details    It creates media format. and reference count will be set to 1
                     For destroying media_format_h handle, use media_format_unref()
  * @param[out] fmt allocated media_format_h
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_OUT_OF_MEMORY Out of memory
@@ -159,7 +180,7 @@ int media_format_create(media_format_h* fmt);
 
 /**
  * @brief Gets video information of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   returns mimetype, width, height, average bps, max bps of this media format
  * @param[in] fmt media_format_h to get video information
  * @param[out] mimetype media_format_mimetype_e , ex) MEDIA_FORMAT_H264_HP
@@ -167,6 +188,9 @@ int media_format_create(media_format_h* fmt);
  * @param[out] height height of the video
  * @param[out] avg_bps average bps of the video
  * @param[out] max_bps max bps of the video
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -180,7 +204,7 @@ int media_format_get_video_info(media_format_h fmt, media_format_mimetype_e* mim
 
 /**
  * @brief Gets audio information of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   returns mimetype, channels, height, samplerate bps, max bps of this media format
  * @param[in] fmt media_format_h to get audio information
  * @param[out] mimetype media_format_mimetype_e , ex) MEDIA_FORMAT_PCM
@@ -188,6 +212,9 @@ int media_format_get_video_info(media_format_h fmt, media_format_mimetype_e* mim
  * @param[out] samplerate sampling rate of the audio
  * @param[out] bit bit resolution of the audio
  * @param[out] avg_bps average bps of the audio
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -200,11 +227,29 @@ int media_format_get_video_info(media_format_h fmt, media_format_mimetype_e* mim
 int media_format_get_audio_info(media_format_h fmt, media_format_mimetype_e* mimetype, int* channel, int* samplerate, int* bit, int* avg_bps);
 
 /**
+ * @brief Gets audio aac type of media format
+ * @since_tizen 2.4
+ * @param[in] fmt media_format_h to get audio information
+ * @param[out] is_adts aac adts flag of the audio
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MEDIA_FORMAT_ERROR_NONE Successful
+ * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
+ * @see media_format_set_audio_aac_type()
+ */
+int media_format_get_audio_aac_type(media_format_h fmt, bool* is_adts);
+
+/**
  * @brief Sets video MIME type of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets MIME type
  * @param[in] fmt media_format_h to set
  * @param[in] mimetype media_format_mimetype_e , ex) MEDIA_FORMAT_H264_HP
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -214,11 +259,14 @@ int media_format_set_video_mime(media_format_h fmt, media_format_mimetype_e mime
 
 /**
  * @brief Sets video width of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets video width
  * @param[in] fmt media_format_h to set
  * @param[in] width width of the video
  * @pre must set video MIME type by media_format_set_video_mime()
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -229,11 +277,14 @@ int media_format_set_video_width(media_format_h fmt, int width);
 
 /**
  * @brief Sets video height of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets video height
  * @param[in] fmt media_format_h to set
  * @param[in] height height of the video
  * @pre must set video MIME type by media_format_set_video_mime()
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -243,11 +294,14 @@ int media_format_set_video_height(media_format_h fmt, int height);
 
 /**
  * @brief Sets video avg_bps of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets avg_bps
  * @param[in] fmt media_format_h to set
  * @param[in] avg_bps average bps of the video
  * @pre must set video MIME type by media_format_set_video_mime()
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -257,11 +311,14 @@ int media_format_set_video_avg_bps(media_format_h fmt, int avg_bps);
 
 /**
  * @brief Sets video max_bps of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets max_bps
  * @param[in] fmt media_format_h to set
  * @param[in] max_bps max bps of the video
  * @pre must set video MIME type by media_format_set_video_mime()
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -271,10 +328,13 @@ int media_format_set_video_max_bps(media_format_h fmt, int max_bps);
 
 /**
  * @brief Sets audio MIME type of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets MIME type
  * @param[in] fmt media_format_h to set audio information
  * @param[in] mimetype media_format_mimetype_e , ex) MEDIA_FORMAT_PCM
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -284,11 +344,14 @@ int media_format_set_audio_mime(media_format_h fmt, media_format_mimetype_e mime
 
 /**
  * @brief Sets audio channel of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets audio channel
  * @param[in] fmt media_format_h to set audio information
  * @param[in] channel channel of the audio
  * @pre must set audio MIME type by media_format_set_audio_mime()
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -298,11 +361,14 @@ int media_format_set_audio_channel(media_format_h fmt, int channel);
 
 /**
  * @brief Sets audio samplerate of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets audio samplerate of this media format
  * @param[in] fmt media_format_h to set
  * @param[in] samplerate sampling rate of the audio
  * @pre must set audio MIME type by media_format_set_audio_mime()
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -312,11 +378,14 @@ int media_format_set_audio_samplerate(media_format_h fmt, int samplerate);
 
  /**
  * @brief Sets audio bit of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets audio bit resolution of this media format
  * @param[in] fmt media_format_h to set
  * @param[in] bit bit of the audio
  * @pre must set audio MIME type by media_format_set_audio_mime()
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -326,11 +395,14 @@ int media_format_set_audio_bit(media_format_h fmt, int bit);
 
  /**
  * @brief Sets audio avg_bps of media format
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details   Sets audio avg_bps of this media format
  * @param[in] fmt media_format_h to set
  * @param[in] avg_bps avg_bps of the audio
  * @pre must set audio MIME type by media_format_set_audio_mime()
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
@@ -338,11 +410,31 @@ int media_format_set_audio_bit(media_format_h fmt, int bit);
  */
 int media_format_set_audio_avg_bps(media_format_h fmt, int avg_bps);
 
+ /**
+ * @brief Sets audio aac type of media format
+ * @since_tizen 2.4
+ * @details   Sets audio aac data type of this media format
+ * @param[in] fmt media_format_h to set
+ * @param[in] is_adts aac adts flag of the audio
+ * @pre must set audio MIME type by media_format_set_audio_mime()
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MEDIA_FORMAT_ERROR_NONE Successful
+ * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MEDIA_FORMAT_ERROR_INVALID_OPERATION Invalid operation
+ * @see media_format_get_audio_aac_type()
+ */
+int media_format_set_audio_aac_type(media_format_h fmt, bool is_adts);
+
 /**
  * @brief Increase reference count of media_format_h object
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details    increase ref_count of media_format_h
  * @param[in] fmt exist media_format_h
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_OUT_OF_MEMORY Out of memory
@@ -353,9 +445,12 @@ int media_format_ref(media_format_h fmt);
 
 /**
  * @brief Decrease reference count of media_format_h object
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details    decrease ref_count of media_format_h
  * @param[in] fmt exist media_format_h
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_OUT_OF_MEMORY Out of memory
@@ -366,10 +461,13 @@ int media_format_unref(media_format_h fmt);
 
 /**
  * @brief Check whether the media_format_h is writable or not.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details    Check the number of media_format's ref_count
  * @param[in] fmt exist media_format_h
  * @param[out] is_writable if ref_count is 1, return true. if not, return false
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_OUT_OF_MEMORY Out of memory
@@ -379,15 +477,18 @@ int media_format_is_writable(media_format_h fmt, bool* is_writable);
 
  /**
  * @brief Returns a writable copy of media_format_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @details If there is only one reference count on fmt, the caller must be the owner,
  *              and so this function will return the object unchanged.
  *              while, if there is more than one reference count on the object, a new object will be returned.
  *              The caller will own a reference to the returned object.
  *              In a nutshell, this function unrefs the fmt and refs the out_fmt returned.
  *              Don't access fmt after calling this function.
- * @param[in] fmt exist media_format_h , don't access it after calling this function.
- * @param[out] out_fmt new copied media_format_h, the caller is owner of this object.
+ * @param[in] fmt exist media_format_h , don't access it after calling this function
+ * @param[out] out_fmt new copied media_format_h, the caller is owner of this object
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_FORMAT_ERROR_NONE Successful
  * @retval #MEDIA_FORMAT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_FORMAT_ERROR_OUT_OF_MEMORY Out of memory
index c44b1b7..25209ea 100755 (executable)
@@ -53,61 +53,61 @@ extern "C" {
 
 /**
  * @brief Check whether given media format is for audio or not
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_FORMAT_IS_AUDIO(x_fmt) (MEDIA_FORMAT_CAST(x_fmt)->mimetype & MEDIA_FORMAT_AUDIO)
 
 /**
  * @brief Check whether given media format is for video or not
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_FORMAT_IS_VIDEO(x_fmt) (MEDIA_FORMAT_CAST(x_fmt)->mimetype & MEDIA_FORMAT_VIDEO)
 
 /**
  * @brief Check whether given media format is for text or not
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_FORMAT_IS_TEXT(x_fmt) (false)
 
 /**
  * @brief Check whether given media format is for raw type or not
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_FORMAT_IS_RAW(x_fmt) (MEDIA_FORMAT_CAST(x_fmt)->mimetype & MEDIA_FORMAT_RAW)
 
 /**
  * @brief Check whether given media format is for encoded type or not
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_FORMAT_IS_ENCODED(x_fmt) (MEDIA_FORMAT_CAST(x_fmt)->mimetype & MEDIA_FORMAT_ENCODED)
 
 /**
  * @brief Gets the number of media format ref_count
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_FORMAT_GET_REFCOUNT(x_fmt) (g_atomic_int_get(&(MEDIA_FORMAT_CAST(x_fmt))->ref_count))
 
 /**
  * @brief Check whether given media format is writable or not
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_FORMAT_IS_WRITABLE(x_fmt) (MEDIA_FORMAT_GET_REFCOUNT(x_fmt) == 1)
 
 /**
  * @brief increase the media format's ref_count
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_FORMAT_INC_REFCOUNT(x_fmt) (g_atomic_int_inc(&(MEDIA_FORMAT_CAST(x_fmt))->ref_count))
 
 /**
  * @brief decrease the media format's ref_count and return true if ref_count become zero.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_FORMAT_DEC_REFCOUNT_TEST(x_fmt) (g_atomic_int_dec_and_test(&(MEDIA_FORMAT_CAST(x_fmt))->ref_count))
 
 /**
  * @brief Media format for configuring video codec.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct _media_format_video_spec_s {
     int width;          /**< media format video width */
@@ -118,18 +118,19 @@ typedef struct _media_format_video_spec_s {
 
 /**
  * @brief Media format for configuring audio codec.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct _media_fomat_audio_spec_s {
     int channel;          /**< media format audio's the number of channels */
     int samplerate;          /**< media format audio sampling rate */
     int bit;                /**< media format audio's the bit resolution */
     int avg_bps;          /**< media format audio max bps */
+    bool is_adts;          /**< media format audio aac adts flag */
 } media_format_audio_spec_s;
 
 /**
  * @brief Structure of media format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct _media_format_s
 {
index 8c60d20..a6f5c1b 100755 (executable)
@@ -41,13 +41,13 @@ extern "C" {
 
 /**
  * @brief  The Media Packet handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef struct media_packet_s *media_packet_h;
 
 /**
  * @brief Enumeration for media packet error.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum
 {
@@ -60,7 +60,7 @@ typedef enum
 
 /**
  * @brief Enumeration for media buffer flag.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 typedef enum
 {
@@ -71,7 +71,7 @@ typedef enum
 
 /**
  * @brief Enumeration for the return values of media packet finalize call back functions.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @see media_packet_finalize_cb()
  */
 typedef enum _finalize_cb_ret
@@ -84,7 +84,7 @@ typedef enum _finalize_cb_ret
  * @brief   Called when the media packet is destroyed.
  * @details It will be invoked when media_packet_destroy() is called.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet        The media packet handle
  * @param[in] error_code    The error code of #media_packet_error_e
@@ -107,7 +107,7 @@ typedef int (*media_packet_finalize_cb)(media_packet_h packet, int error_code, v
  * @brief    Creates a media packet handle and allocates buffer.
  * @details  The buffer will be allocated to heap or tbm_surface.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @c packet must be released by using media_packet_destroy().
  * @param[in]  fmt       The allocated #media_format_h by caller
@@ -115,6 +115,8 @@ typedef int (*media_packet_finalize_cb)(media_packet_h packet, int error_code, v
  * @param[in]  fcb_data  The user data to be passed to the media_packet_finalize_cb() function
  * @param[out] packet    A new handle for media packet
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_OUT_OF_MEMORY     Out of memory
@@ -162,7 +164,7 @@ int media_packet_create_alloc(media_format_h fmt, media_packet_finalize_cb fcb,
  * @brief    Creates a media packet handle.
  * @details  It creates only media packet handle without allocated buffer.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @c packet must be released by using media_packet_destroy().
  * @param[in] fmt       The allocated #media_format_h by caller
@@ -170,6 +172,8 @@ int media_packet_create_alloc(media_format_h fmt, media_packet_finalize_cb fcb,
  * @param[in] fcb_data  The user data to be passed to the media_packet_finalize_cb() function
  * @param[out] packet   A new handle for media packet
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_OUT_OF_MEMORY     Out of memory
@@ -217,7 +221,7 @@ int media_packet_create(media_format_h fmt, media_packet_finalize_cb fcb, void *
  * @brief    Copies a media packet handle.
  * @details  It re-creates only media packet handle with exist media packet handle.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @c new_packet must be released by using media_packet_destroy().
  * @param[in]   org_packet   The existing media packet handle
@@ -225,6 +229,8 @@ int media_packet_create(media_format_h fmt, media_packet_finalize_cb fcb, void *
  * @param[in]   fcb_data     The user data to be passed to the media_packet_finalize_cb() function
  * @param[out]  new_packet   A new handle for media packet
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_OUT_OF_MEMORY     Out of memory
@@ -239,10 +245,12 @@ int media_packet_copy(media_packet_h org_packet, media_packet_finalize_cb fcb, v
  * @brief    Allocates buffer with media packet handle.
  * @details  Before using media_packet_alloc(), media packet handle must be exist.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet   The existing media packet handle
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_OUT_OF_MEMORY     Out of memory
@@ -256,7 +264,7 @@ int media_packet_alloc(media_packet_h packet);
 /**
  * @brief    Creates media packet handle and allocates buffer with #tbm_surface_h.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @c packet must be released by using media_packet_destroy().
  * @param[in]   fmt       The allocated #media_format_h by caller
@@ -264,6 +272,9 @@ int media_packet_alloc(media_packet_h packet);
  * @param[in]   fcb       The media_packet_finalize_cb() to register
  * @param[in]   fcb_data  The user data to be passed to the media_packet_finalize_cb() function
  * @param[out]  packet  A new handle for media packet
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_OUT_OF_MEMORY     Out of memory
@@ -308,17 +319,77 @@ int media_packet_alloc(media_packet_h packet);
 int media_packet_create_from_tbm_surface(media_format_h fmt, tbm_surface_h surface, media_packet_finalize_cb fcb, void *fcb_data, media_packet_h *packet);
 
 /**
+ * @brief    Creates media packet handle with already allocated external buffer.
+ * @details It does not support video's #MEDIA_FORMAT_RAW type.
+ *
+ * @since_tizen 2.4
+ *
+ * @remarks The @c packet must be released by using media_packet_destroy().
+ * @param[in]   fmt       The allocated #media_format_h by caller
+ * @param[in]   mem_ptr   The memory pointer which is created by external module
+ * @param[in]   fcb       The media_packet_finalize_cb() to register
+ * @param[in]   fcb_data  The user data to be passed to the media_packet_finalize_cb() function
+ * @param[out]  packet  A new handle for media packet
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MEDIA_PACKET_ERROR_NONE              Successful
+ * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MEDIA_PACKET_ERROR_OUT_OF_MEMORY     Out of memory
+ * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
+ *
+ * @pre Must have media_format_h instance by media_format_create()
+ * @post Must do media_format_unref()
+ *
+ * @see media_packet_destroy()
+ * @see media_packet_finalize_cb()
+ * @see media_format_unref()
+ * @par Example
+   @code
+   #include <media_packet.h>
+
+   {
+   media_format_h fmt;
+   media_packet_h packet;
+
+   media_format_create(&fmt);
+   media_format_set_video_mime(fmt, MEDIA_FORMAT_H264_HP);
+   media_format_set_video_width(fmt, 640);
+   media_format_set_video_height(fmt, 480);
+   media_format_set_video_avg_bps(fmt, 10000000);
+   media_format_set_video_max_bps(fmt, 15000000);
+
+   media_packet_create_from_external_memory (fmt, mem_ptr, size,  _finalize_callback, fcb_data, &packet);
+   media_format_unref(fmt);
+
+   ...
+   media_packet_destroy(packet);
+   }
+
+   int _finalize_callback(media_packet_h packet, int err, void* userdata)
+   {
+       ...
+       return MEDIA_PACKET_FINALIZE;
+   }
+
+   @endcode
+ */
+int media_packet_create_from_external_memory(media_format_h fmt, void *mem_ptr, uint64_t size, media_packet_finalize_cb fcb, void *fcb_data, media_packet_h *packet);
+
+/**
  * @brief Gets #media_format_h of media packet
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] fmt      The media format of media packet
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  *
  * @see media_format_unref()
 * @par Example
+ * @par Example
    @code
    #include <media_packet.h>
 
@@ -338,11 +409,13 @@ int media_packet_get_format(media_packet_h packet, media_format_h *fmt);
 
 /**
  * @brief Sets #media_format_h of media packet
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet   The media packet handle
  * @param[in] fmt      The #media_format_h to set
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  *
@@ -367,11 +440,13 @@ int media_packet_set_format(media_packet_h packet, media_format_h fmt);
 
 /**
  * @brief Sets PTS of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet   The media packet handle
  * @param[in] pts      The PTS value to set
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -380,11 +455,13 @@ int media_packet_set_pts(media_packet_h packet, uint64_t pts);
 
 /**
  * @brief Sets DTS of media packet handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[in]  dts      The DTS value to set
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -393,11 +470,13 @@ int media_packet_set_dts(media_packet_h packet, uint64_t dts);
 
 /**
  * @brief Sets PTS of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet    The media packet handle
  * @param[in] duration  The duration value to set
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -406,11 +485,13 @@ int media_packet_set_duration(media_packet_h packet, uint64_t duration);
 
 /**
  * @brief Sets buffer size of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] size     The buffer size value to set
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -419,11 +500,13 @@ int media_packet_set_buffer_size(media_packet_h packet, uint64_t size);
 
 /**
  * @brief Gets PTS of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] pts      The PTS value to get
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
@@ -432,11 +515,13 @@ int media_packet_get_pts(media_packet_h packet, uint64_t *pts);
 
 /**
  * @brief Gets DTS of media packet
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] dts      The DTS value to get
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -445,11 +530,13 @@ int media_packet_get_dts(media_packet_h packet, uint64_t *dts);
 
 /**
  * @brief Gets duration of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet    The media packet handle
  * @param[out] duration  The duration value to get
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -458,11 +545,13 @@ int media_packet_get_duration(media_packet_h packet, uint64_t *duration);
 
 /**
  * @brief Gets buffer size of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] size     The buffer size value to get
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -471,11 +560,13 @@ int media_packet_get_buffer_size(media_packet_h packet, uint64_t *size);
 
 /**
  * @brief Gets buffer data pointer of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] data     The allocated buffer data pointer
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -484,11 +575,13 @@ int media_packet_get_buffer_data_ptr(media_packet_h packet, void **data);
 
 /**
  * @brief Gets TBM surface data of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] surface  The tbm_surface data pointer
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -497,11 +590,13 @@ int media_packet_get_tbm_surface(media_packet_h packet, tbm_surface_h *surface);
 
 /**
  * @brief Sets extra data of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet   The media packet handle
  * @param[in] extra    The extra data to set
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -510,11 +605,13 @@ int media_packet_set_extra(media_packet_h packet, void *extra);
 
 /**
  * @brief Gets extra data of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] extra    The extra data to get
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -523,12 +620,14 @@ int media_packet_get_extra(media_packet_h packet, void **extra);
 
 /**
  * @brief Checks whether the given media packet is for video.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] is_video @c true if the given media packet is for video,
  *                      otherwise @c false if the given media packet is not for video
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -540,12 +639,14 @@ int media_packet_is_video(media_packet_h packet, bool *is_video);
 
 /**
  * @brief Checks whether the given media packet is for audio.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet    The media packet handle
  * @param[out] is_audio  @c true if the given media packet is for audio,
  *                       otherwise @c false if the given media packet is not for audio
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -556,12 +657,14 @@ int media_packet_is_audio(media_packet_h packet, bool *is_audio);
 
 /**
  * @brief Checks whether the given media packet is encoded type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet      The media packet handle
  * @param[out] is_encoded  @c true if the given media packet is encoded,
  *                         otherwise @c false if the given media packet is not encoded
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -573,12 +676,14 @@ int media_packet_is_encoded(media_packet_h packet, bool *is_encoded);
 
 /**
  * @brief Checks whether the given media packet is raw type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] is_raw   @c true if the given media packet is for raw video,
  *                      otherwise @c false if the given media packet is not for raw video
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -590,11 +695,13 @@ int media_packet_is_raw(media_packet_h packet, bool *is_raw);
 
 /**
  * @brief Sets #media_buffer_flags_e of media packet.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet    The media packet handle
  * @param[in] flags    The media_buffer_flags_e of media packet to set
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -606,11 +713,13 @@ int media_packet_set_flags(media_packet_h packet, media_buffer_flags_e flags);
 
 /**
  * @brief Unsets media_buffer_flags_e of media packet
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet   The media packet handle
  * @param[in] flags    The media_buffer_flags_e of media packet to unset
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -622,12 +731,14 @@ int media_packet_unset_flags(media_packet_h packet, media_buffer_flags_e flags);
 
 /**
  * @brief Checks whether the given media packet is codec data.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet            The media packet handle
  * @param[out] is_codec_config  @c true if the given media packet is for codec data,
  *                              otherwise @c false if the given media packet is not for codec data
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -639,12 +750,14 @@ int media_packet_is_codec_config(media_packet_h packet, bool *is_codec_config);
 
 /**
  * @brief Checks whether the given media packet is eos.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet   The media packet handle
  * @param[out] is_eos  @c true if the given media packet is for eos,
  *                     otherwise @c false if the given media packet is not for eos
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -656,12 +769,14 @@ int media_packet_is_end_of_stream(media_packet_h packet, bool *is_eos);
 
 /**
  * @brief Checks whether the given media packet is sync frame.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] is_sync  @c true if the given media packet is for sync frame,
  *                      otherwise @c false if the given media packet is not for sync frame
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -673,12 +788,14 @@ int media_packet_is_sync_frame(media_packet_h packet, bool *is_sync);
 
 /**
  * @brief Checks whether the allocated buffer is tbm surface or not.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in]  packet   The media packet handle
  * @param[out] has_tbm_surface  @c true if the given media packet's allocated buffer is tbm surface,
  *                      otherwise @c false if the given media packet's allocated buffer is not tbm surface
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -686,12 +803,110 @@ int media_packet_is_sync_frame(media_packet_h packet, bool *is_sync);
 int media_packet_has_tbm_surface_buffer(media_packet_h packet, bool* has_tbm_surface);
 
 /**
+ * @brief Gets the number of planes from tbm surface in the given media packet.
+ * @details Use only if the media_format_h is #MEDIA_FORMAT_RAW and #MEDIA_FORMAT_VIDEO.
+ *          It means that media_packet_h's buffer is allocated on tbm_surface.
+ *          If not sure of that, use media_packet_is_video() and media_packet_is_raw() or media_packet_has_tbm_surface_buffer().
+ *
+ * @since_tizen 2.4
+ *
+ * @param[in]  packet   The media packet handle
+ * @param[out] num  The number of planes from tbm_surface
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MEDIA_PACKET_ERROR_NONE              Successful
+ * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
+ */
+int media_packet_get_number_of_video_planes(media_packet_h packet, uint32_t* num);
+
+/**
+ * @brief Gets stride width from tbm surface in the given media packet.
+ * @details Use only if the media_format_h is #MEDIA_FORMAT_RAW and #MEDIA_FORMAT_VIDEO.
+ *          It means that media_packet_h's buffer is allocated on tbm_surface.
+ *          If not sure of that, use media_packet_is_video() and media_packet_is_raw() or media_packet_has_tbm_surface_buffer().
+ *
+ * @since_tizen 2.4
+ *
+ * @param[in]  packet   The media packet handle
+ * @param[in]  plane_idx   The plane index value
+ * @param[out] stride_w  the stride value from tbm_surface
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MEDIA_PACKET_ERROR_NONE              Successful
+ * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
+ */
+int media_packet_get_video_stride_width(media_packet_h packet, int plane_idx, int *stride_width);
+
+/**
+ * @brief Gets stride height from tbm surface in the given media packet.
+ * @details Use only if the media_format_h is #MEDIA_FORMAT_RAW and #MEDIA_FORMAT_VIDEO.
+ *          It means that media_packet_h's buffer is allocated on tbm_surface.
+ *          If not sure of that, use media_packet_is_video() and media_packet_is_raw() or media_packet_has_tbm_surface_buffer().
+ *
+ * @since_tizen 2.4
+ *
+ * @param[in]  packet   The media packet handle
+ * @param[in]  plane_idx   The plane index value
+ * @param[out] stride_h  The stride height value from tbm_surface
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MEDIA_PACKET_ERROR_NONE              Successful
+ * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
+ */
+int media_packet_get_video_stride_height(media_packet_h packet, int plane_idx, int *stride_height);
+
+/**
+ * @brief Gets plane data pointer from tbm surface in the given media packet.
+ * @details Use only if the media_format_h is #MEDIA_FORMAT_RAW and #MEDIA_FORMAT_VIDEO.
+ *          It means that media_packet_h's buffer is allocated on tbm_surface.
+ *          If not sure of that, use media_packet_is_video() and media_packet_is_raw() or media_packet_has_tbm_surface_buffer().
+ *
+ * @since_tizen 2.4
+ *
+ * @remarks The @c plane_data_ptr must not be released by using free(). Note that It is released by media_packet_destory() or tbm_surface_destroy().
+ * @param[in]  packet   The media packet handle
+ * @param[in]  plane_idx   The plane index value
+ * @param[out] plane_data_ptr  The plane data pointer from tbm_surface
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MEDIA_PACKET_ERROR_NONE              Successful
+ * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
+ */
+int media_packet_get_video_plane_data_ptr(media_packet_h packet, int plane_idx, void **plane_data_ptr);
+
+/**
+ * @brief Gets codec data and the codec data size of media packet.
+ * @since_tizen 2.4
+ *
+ * @param[in] packet   The media packet handle
+ * @param[out] codec_data    The codec data to get
+ * @param[out] codec_data_size    The codec data size to get
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MEDIA_PACKET_ERROR_NONE              Successful
+ * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
+ */
+int media_packet_get_codec_data(media_packet_h packet, void** codec_data, unsigned int* codec_data_size);
+
+/**
  * @brief Destroys the media packet handle.
  * @details  The registered finalize_callback() function will be invoked to destroy the media packet handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] packet  The handle to media packet to be destroyed
  *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #MEDIA_PACKET_ERROR_NONE              Successful
  * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
@@ -700,6 +915,7 @@ int media_packet_has_tbm_surface_buffer(media_packet_h packet, bool* has_tbm_sur
  * @see media_packet_create()
  * @see media_packet_copy()
  * @see media_packet_create_from_tbm_surface()
+ * @see media_packet_create_from_external_memory()
  */
 int media_packet_destroy(media_packet_h packet);
 
diff --git a/include/media_packet_internal.h b/include/media_packet_internal.h
new file mode 100755 (executable)
index 0000000..65ab7e6
--- /dev/null
@@ -0,0 +1,63 @@
+/*
+* Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+#ifndef __TIZEN_MEDIA_PACKET_INTERNAL_H__
+#define __TIZEN_MEDIA_PACKET_INTERNAL_H__
+
+#include <media_packet.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @file media_packet_internal.h
+ * @brief This file contains the capi media tool internal API.
+ */
+
+/**
+ * @addtogroup CAPI_MEDIA_TOOL_MODULE
+ * @{
+ */
+
+
+/**
+ * @internal
+ * @brief Sets codec data and the codec data size of media packet.
+ * @since_tizen 2.4
+ *
+ * @param[in] packet   The media packet handle
+ * @param[in] codec_data    The codec data to set
+ * @param[in] codec_data_size    The codec data size to set
+ *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #MEDIA_PACKET_ERROR_NONE              Successful
+ * @retval #MEDIA_PACKET_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MEDIA_PACKET_ERROR_INVALID_OPERATION Invalid operation
+ */
+int media_packet_set_codec_data(media_packet_h packet, void* codec_data, unsigned int codec_data_size);
+
+
+/**
+ * @}
+ */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __TIZEN_MEDIA_PACKET_INTERNAL_H__ */
index e9d9176..332a571 100755 (executable)
@@ -41,61 +41,61 @@ extern "C" {
 
 /**
  * @brief Gets pts of media_packet_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_PTS(arg) (MEDIA_PACKET_CAST(arg)->pts)
 
 /**
  * @brief Gets dts of media_packet_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_DTS(arg) (MEDIA_PACKET_CAST(arg)->dts)
 
 /**
  * @brief Gets duration of media_packet_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_DURATION(arg) (MEDIA_PACKET_CAST(arg)->duration)
 
 /**
  * @brief Gets size of media_packet_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_SIZE(arg) (MEDIA_PACKET_CAST(arg)->size)
 
 /**
  * @brief Gets data of media_packet_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_DATA(arg) (MEDIA_PACKET_CAST(arg)->data)
 
 /**
  * @brief Gets the buffer flags of media_packet_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_FLAGS(arg) (MEDIA_PACKET_CAST(arg)->flags)
 
 /**
  * @brief Gets the buffer config flag of media_packet_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_CODEC_CONFIG_DATA(arg) (((MEDIA_PACKET_CAST(arg)->flags) >> 0) & 0x001)
 
 /**
  * @brief Gets the buffer eos flag of media_packet_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_CODEC_END_OF_STREAM(arg) (((MEDIA_PACKET_CAST(arg)->flags) >> 1) & 0x001)
 
 /**
  * @brief Gets the buffer sync flag of media_packet_h
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_CODEC_SYNC_FRAME(arg) (((MEDIA_PACKET_CAST(arg)->flags) >> 2) & 0x001)
 
 /**
  * @brief Casting to media_packet_s
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  */
 #define MEDIA_PACKET_CAST(obj) ((media_packet_s*)(obj))
 
@@ -105,6 +105,7 @@ typedef enum {
     MEDIA_BUFFER_TYPE_EXTERNAL_TBM_SURFACE,
     MEDIA_BUFFER_TYPE_NORMAL,
     MEDIA_BUFFER_TYPE_AUTO,
+    MEDIA_BUFFER_TYPE_EXTERNAL_MEMORY,
     MEDIA_BUFFER_TYPE_MAX
 } media_buffer_type_e;
 
@@ -119,7 +120,9 @@ typedef struct _media_packet_s{
     media_packet_finalize_cb finalizecb_func;
     void* userdata;
     bool is_allocated;
-    void *extradata;
+    void* extradata;
+    void* codec_data;
+    unsigned int codec_data_size;
 
     media_format_s* format;
     media_buffer_type_e type;
index c78819f..dac37f3 100755 (executable)
@@ -47,8 +47,7 @@ make %{?jobs:-j%jobs}
 rm -rf %{buildroot}
 mkdir -p %{buildroot}/usr/share/license
 mkdir -p %{buildroot}/usr/bin
-mkdir -p %{buildroot}/opt/usr/devel
-cp test/media_packet_test %{buildroot}/opt/usr/devel
+cp test/media_packet_test %{buildroot}/usr/bin/
 cp LICENSE.APLv2 %{buildroot}/usr/share/license/%{name}
 
 %make_install
@@ -63,7 +62,7 @@ cp LICENSE.APLv2 %{buildroot}/usr/share/license/%{name}
 %manifest capi-media-tool.manifest
 %{_libdir}/libcapi-media-tool.so.*
 %{_datadir}/license/%{name}
-/opt/usr/devel/*
+/usr/bin/*
 #%{_bindir}/*
 
 %files devel
index e7a7fe8..41a4b37 100755 (executable)
@@ -111,6 +111,26 @@ int media_format_get_audio_info(media_format_h fmt, media_format_mimetype_e* mim
     return ret;
 }
 
+int media_format_get_audio_aac_type(media_format_h fmt, bool* is_adts)
+{
+    int ret = MEDIA_FORMAT_ERROR_NONE;
+    MEDIA_FORMAT_INSTANCE_CHECK(fmt);
+
+    media_format_s* fmt_handle;
+    fmt_handle = (media_format_s*)fmt;
+
+    if (!(fmt_handle->mimetype == MEDIA_FORMAT_AAC_LC || fmt_handle->mimetype == MEDIA_FORMAT_AAC_HE || fmt_handle->mimetype == MEDIA_FORMAT_AAC_HE_PS))
+    {
+        LOGE("The format handle is not aac format..\n");
+        return MEDIA_FORMAT_ERROR_INVALID_OPERATION;
+    }
+
+    if (is_adts)
+        *is_adts = fmt_handle->detail.audio.is_adts;
+
+    return ret;
+}
+
 int media_format_set_video_mime(media_format_h fmt, media_format_mimetype_e mimetype)
 {
     int ret = MEDIA_FORMAT_ERROR_NONE;
@@ -366,6 +386,32 @@ int media_format_set_audio_avg_bps(media_format_h fmt, int avg_bps)
     return ret;
 }
 
+int media_format_set_audio_aac_type(media_format_h fmt, bool is_adts)
+{
+
+    int ret = MEDIA_FORMAT_ERROR_NONE;
+    MEDIA_FORMAT_INSTANCE_CHECK(fmt);
+
+    if (!MEDIA_FORMAT_IS_WRITABLE(fmt))
+    {
+        LOGE("the format can not be changed..\n", __FUNCTION__);
+        return MEDIA_FORMAT_ERROR_INVALID_OPERATION;
+    }
+
+    media_format_s* fmt_handle;
+    fmt_handle = (media_format_s*)fmt;
+
+    if (!(fmt_handle->mimetype & MEDIA_FORMAT_AUDIO))
+    {
+        LOGE("The format handle is not for MEDIA_FORMAT_AUDIO..\n");
+        return MEDIA_FORMAT_ERROR_INVALID_PARAMETER;
+    }
+
+    fmt_handle->detail.audio.is_adts = is_adts;
+
+    return ret;
+}
+
 int media_format_ref(media_format_h fmt)
 {
     int ret = MEDIA_FORMAT_ERROR_NONE;
index 9487a00..92c10fa 100755 (executable)
@@ -53,7 +53,6 @@ int media_packet_create_alloc(media_format_h fmt, media_packet_finalize_cb fcb,
         LOGE("The media format handle is not specified. set video info or audio info...");
         return MEDIA_PACKET_ERROR_INVALID_OPERATION;
     }
-    /* TODO : need more validation on fmt */
 
     handle = (media_packet_s*)malloc(sizeof(media_packet_s));
     if (handle != NULL)
@@ -377,6 +376,7 @@ int _pkt_alloc_buffer(media_packet_s* pkt)
     return MEDIA_PACKET_ERROR_NONE;
 }
 
+/* TODO : contact Kim Young Hun to make below api as a common */
 /* TODO : rename below macro or make it able to use original from mm_transform */
 #define _ROUND_UP_16(num) (((num)+15)&~15)
 #define _GEN_MASK(x) ((1<<(x))-1)
@@ -478,13 +478,25 @@ static uint64_t _pkt_calculate_video_buffer_size(media_packet_s* pkt)
     return buffersize;
 }
 
-
-#define PCM_MAX_FRM_SIZE      (2048)
-#define PCM_MIN_FRM_SIZE      (1024)
+#define PCM_MAX_FRM_SIZE        (4608)      /* FLAC PCM have max 4608*/
+#define PCM_MIN_FRM_SIZE          (1024)
 #define AAC_MAX_SAMPLE_SIZE   (1024)
 #define MP3_MAX_SAMPLE_SIZE   (1152)
-#define MPEG_MAX_FRM_SIZE     (6144/4)      /* 1536 */
-#define MPEG_MIN_NCH          (2)
+#define AMR_MAX_SAMPLE_SIZE    (320)       /* AMR-NB(160), WB (320) */
+#define OGG_MAX_SAMPLE_SIZE   (2048)
+#define FLAC_MAX_SAMPLE_SIZE   (65536)  /* FIXME - full size = sample * ch * resolution */
+#define WMA_MAX_SAMPLE_SIZE   (10240)  /* FIXME - full size = sample * ch * resolution */
+
+#define MPEG_MAX_FRM_SIZE      (6144/4)      /* 1536 */
+#define AMR_MAX_FRM_SIZE             (96)       /* AMR-NB(32), WB (96) */
+#define OGG_MAX_FRM_SIZE   (2048)          /* FIXME - Need */
+#define FLAC_MAX_FRM_SIZE   (4096)          /* FIXME - Need */
+#define WMA_MAX_FRM_SIZE   (2048)          /* FIXME - Need */
+
+#define PCM_MAX_NCH                  (2)
+#define MPEG_MIN_NCH                  (2)
+#define AMR_MAX_NCH                  (1)
+#define WMA_MAX_NCH                  (2)
 
 static uint64_t _pkt_calculate_audio_buffer_size(media_packet_s* pkt)
 {
@@ -500,13 +512,31 @@ static uint64_t _pkt_calculate_audio_buffer_size(media_packet_s* pkt)
     switch (pkt->format->mimetype)
     {
         case MEDIA_FORMAT_PCM:
-            buffersize = (PCM_MAX_FRM_SIZE * channel) * (uint64_t)(bit /8);
+            buffersize = (PCM_MAX_FRM_SIZE * PCM_MAX_NCH) * (uint64_t)(bit /8);
             break;
-        case MEDIA_FORMAT_AAC:
+        case MEDIA_FORMAT_AAC_LC:
+        case MEDIA_FORMAT_AAC_HE:
+        case MEDIA_FORMAT_AAC_HE_PS:
         case MEDIA_FORMAT_MP3:
             buffersize = (MPEG_MAX_FRM_SIZE * MPEG_MIN_NCH) * (uint64_t)(2);      /* 2 = (16bit/8)*/
             break;
         /* TODO : extenstion format */
+        case MEDIA_FORMAT_AMR_NB:
+        case MEDIA_FORMAT_AMR_WB:
+            buffersize = (AMR_MAX_FRM_SIZE * AMR_MAX_NCH) * (uint64_t)(2);      /* 2 = (16bit/8)*/
+            break;
+        case MEDIA_FORMAT_VORBIS:
+            buffersize = (OGG_MAX_FRM_SIZE * MPEG_MIN_NCH) * (uint64_t)(2);      /* 2 = (16bit/8)*/
+            break;
+        case MEDIA_FORMAT_FLAC:
+            buffersize = (FLAC_MAX_FRM_SIZE * MPEG_MIN_NCH) * (uint64_t)(2);      /* 2 = (16bit/8)*/
+            break;
+        case MEDIA_FORMAT_WMAV1:
+        case MEDIA_FORMAT_WMAV2:
+        case MEDIA_FORMAT_WMAPRO:
+        case MEDIA_FORMAT_WMALSL:
+            buffersize = (WMA_MAX_FRM_SIZE * WMA_MAX_NCH) * (uint64_t)(2);      /* 2 = (16bit/8)*/
+            break;
         default:
             LOGE("Not supported format\n");
             return 0;
@@ -528,7 +558,11 @@ int media_packet_create_from_tbm_surface(media_format_h fmt, tbm_surface_h surfa
     MEDIA_PACKET_INSTANCE_CHECK(fmt);
     MEDIA_PACKET_INSTANCE_CHECK(surface);
     MEDIA_PACKET_NULL_ARG_CHECK(packet);
-    /* TODO : need more validation on fmt */
+    if (!MEDIA_FORMAT_IS_VIDEO(fmt) && !MEDIA_FORMAT_IS_AUDIO(fmt))
+    {
+        LOGE("The media format handle is not specified. set video info or audio info...");
+        return MEDIA_PACKET_ERROR_INVALID_OPERATION;
+    }
 
     handle = (media_packet_s*)malloc( sizeof(media_packet_s));
     if (handle != NULL)
@@ -589,6 +623,69 @@ fail:
     return ret;
 }
 
+int media_packet_create_from_external_memory(media_format_h fmt, void *mem_ptr, uint64_t size, media_packet_finalize_cb fcb, void *fcb_data, media_packet_h *packet)
+{
+    media_packet_s* handle;
+    int ret = MEDIA_PACKET_ERROR_NONE;
+
+    if (mem_ptr == NULL)
+        return MEDIA_PACKET_ERROR_INVALID_PARAMETER;
+
+    if (!(size > 0))
+        return MEDIA_PACKET_ERROR_INVALID_PARAMETER;
+
+    MEDIA_PACKET_INSTANCE_CHECK(fmt);
+    MEDIA_PACKET_NULL_ARG_CHECK(packet);
+
+    if (!MEDIA_FORMAT_IS_VIDEO(fmt) && !MEDIA_FORMAT_IS_AUDIO(fmt))
+    {
+        LOGE("The media format handle is not specified. set video info or audio info...");
+        return MEDIA_PACKET_ERROR_INVALID_OPERATION;
+    }
+
+    if (MEDIA_FORMAT_IS_RAW(fmt) && MEDIA_FORMAT_IS_VIDEO(fmt))
+    {
+        LOGE("failed!. it supports only 'MEDIA_FORMAT_ENCODED' type.");
+        return MEDIA_PACKET_ERROR_INVALID_PARAMETER;
+    }
+
+    handle = (media_packet_s*)malloc( sizeof(media_packet_s));
+    if (handle != NULL)
+    {
+        memset(handle, 0 , sizeof(media_packet_s));
+    }
+    else
+    {
+        LOGE("[%s] MEDIA_PACKET_ERROR_OUT_OF_MEMORY(0x%08x)" ,__FUNCTION__,MEDIA_PACKET_ERROR_OUT_OF_MEMORY);
+        return MEDIA_PACKET_ERROR_OUT_OF_MEMORY;
+    }
+
+    handle->type = MEDIA_BUFFER_TYPE_EXTERNAL_MEMORY;
+
+    /* alloc handle->format */
+    handle->format = MEDIA_FORMAT_CAST(fmt);
+
+    /* set external allocated memory & external memory size */
+    handle->size = size;
+    handle->data = mem_ptr;
+
+    /* allocated buffer */
+    handle->is_allocated = true;
+
+    /* set finalized callback and user data */
+    handle->finalizecb_func = fcb;
+    handle->userdata = fcb_data;
+
+    /* increase format reference count */
+    ret = media_format_ref((media_format_h)handle->format);
+
+    /* take handle */
+    *packet = (media_packet_h)handle;
+    LOGI("[%s] new handle : %p", __FUNCTION__, *packet);
+    return ret;
+
+}
+
 int media_packet_get_buffer_data_ptr(media_packet_h packet, void **data)
 {
     media_packet_s* handle;
@@ -602,7 +699,6 @@ int media_packet_get_buffer_data_ptr(media_packet_h packet, void **data)
     *data = handle->data;
 
     return ret;
-
 }
 
 int media_packet_get_tbm_surface(media_packet_h packet, tbm_surface_h *surface)
@@ -988,6 +1084,236 @@ int media_packet_has_tbm_surface_buffer(media_packet_h packet, bool* has_tbm_sur
     return ret;
 }
 
+int media_packet_get_number_of_video_planes(media_packet_h packet, uint32_t* num)
+{
+    media_packet_s* handle;
+    int ret = MEDIA_PACKET_ERROR_NONE;
+    bool has_tbm;
+
+    MEDIA_PACKET_INSTANCE_CHECK(packet);
+    MEDIA_PACKET_NULL_ARG_CHECK(num);
+
+    handle = (media_packet_s*) packet;
+
+    media_packet_has_tbm_surface_buffer(packet, &has_tbm);
+
+    if (has_tbm)
+    {
+        tbm_surface_info_s surface_info;
+        int err = tbm_surface_get_info((tbm_surface_h)handle->surface_data, &surface_info);
+        if (err == TBM_SURFACE_ERROR_NONE)
+        {
+            *num = surface_info.num_planes;
+            LOGD(" surface_info the number of planes = %d\n", (int)surface_info.num_planes);
+        }
+        else
+        {
+            *num = 0;
+            LOGE("tbm_surface_get_info() is failed.. 0x%08x \n", err);
+            ret = MEDIA_PACKET_ERROR_INVALID_OPERATION;
+        }
+    }
+    else
+    {
+        *num = 0;
+        LOGE("The packet handle doesn't have tbm_surface buffer type...\n");
+        ret = MEDIA_PACKET_ERROR_INVALID_OPERATION;
+
+    }
+
+    return ret;
+}
+
+int media_packet_get_video_stride_width(media_packet_h packet, int plane_idx, int *stride_width)
+{
+    media_packet_s* handle;
+    int ret = MEDIA_PACKET_ERROR_NONE;
+    bool has_tbm;
+
+    MEDIA_PACKET_INSTANCE_CHECK(packet);
+    MEDIA_PACKET_NULL_ARG_CHECK(stride_width);
+    if (plane_idx < 0)
+    {
+        LOGE("Invalid plane_idx : %d, must not be negative number\n", plane_idx);
+        return MEDIA_PACKET_ERROR_INVALID_PARAMETER;
+    }
+
+    handle = (media_packet_s*) packet;
+
+    media_packet_has_tbm_surface_buffer(packet, &has_tbm);
+
+    if (has_tbm)
+    {
+        tbm_surface_info_s surface_info;
+        int err = tbm_surface_get_info((tbm_surface_h)handle->surface_data, &surface_info);
+        if (err == TBM_SURFACE_ERROR_NONE)
+        {
+
+            if (surface_info.num_planes > plane_idx)
+            {
+                *stride_width = surface_info.planes[plane_idx].stride;
+            }
+            else
+            {
+                LOGE("the plane_idx is invalid, The number of planes = %lu\n", surface_info.num_planes);
+                *stride_width = 0;
+                ret = MEDIA_PACKET_ERROR_INVALID_PARAMETER;
+            }
+        }
+        else
+        {
+            *stride_width = 0;
+            LOGE("tbm_surface_get_info() is failed.. 0x%08x \n", err);
+            ret = MEDIA_PACKET_ERROR_INVALID_OPERATION;
+        }
+    }
+    else
+    {
+        LOGE("The packet handle doesn't have tbm_surface buffer type...\n");
+        *stride_width = 0;
+        ret = MEDIA_PACKET_ERROR_INVALID_OPERATION;
+    }
+
+    return ret;
+}
+
+int media_packet_get_video_stride_height(media_packet_h packet, int plane_idx, int *stride_height)
+{
+    media_packet_s* handle;
+    int ret = MEDIA_PACKET_ERROR_NONE;
+    bool has_tbm;
+
+    MEDIA_PACKET_INSTANCE_CHECK(packet);
+    MEDIA_PACKET_NULL_ARG_CHECK(stride_height);
+    if (plane_idx < 0)
+    {
+        LOGE("Invalid plane_idx : %d, must not be negative number\n", plane_idx);
+        return MEDIA_PACKET_ERROR_INVALID_PARAMETER;
+    }
+
+
+    handle = (media_packet_s*) packet;
+
+    media_packet_has_tbm_surface_buffer(packet, &has_tbm);
+
+    if (has_tbm)
+    {
+        tbm_surface_info_s surface_info;
+        int err = tbm_surface_get_info((tbm_surface_h)handle->surface_data, &surface_info);
+        if (err == TBM_SURFACE_ERROR_NONE)
+        {
+            if (surface_info.num_planes > plane_idx)
+            {
+                *stride_height = surface_info.planes[plane_idx].size/surface_info.planes[plane_idx].stride;
+            }
+            else
+            {
+                LOGE("the plane_idx is invalid, The number of planes = %lu\n", surface_info.num_planes);
+                *stride_height = 0;
+                ret = MEDIA_PACKET_ERROR_INVALID_PARAMETER;
+            }
+        }
+        else
+        {
+            *stride_height = 0;
+            LOGE("tbm_surface_get_info() is failed.. 0x%08x \n", err);
+            ret = MEDIA_PACKET_ERROR_INVALID_OPERATION;
+        }
+    }
+    else
+    {
+        LOGE("The packet handle doesn't have tbm_surface buffer type...\n");
+        *stride_height = 0;
+        ret = MEDIA_PACKET_ERROR_INVALID_OPERATION;
+    }
+
+    return ret;
+
+}
+
+int media_packet_get_video_plane_data_ptr(media_packet_h packet, int plane_idx, void **plane_data_ptr)
+{
+    media_packet_s* handle;
+    int ret = MEDIA_PACKET_ERROR_NONE;
+    bool has_tbm;
+
+    MEDIA_PACKET_INSTANCE_CHECK(packet);
+    MEDIA_PACKET_NULL_ARG_CHECK(plane_data_ptr);
+    if (plane_idx < 0)
+    {
+        LOGE("Invalid plane_idx : %d, must not be negative number\n", plane_idx);
+        return MEDIA_PACKET_ERROR_INVALID_PARAMETER;
+    }
+
+    handle = (media_packet_s*) packet;
+
+    media_packet_has_tbm_surface_buffer(packet, &has_tbm);
+
+    if (has_tbm)
+    {
+        tbm_surface_info_s surface_info;
+        int err = tbm_surface_get_info((tbm_surface_h)handle->surface_data, &surface_info);
+        if (err == TBM_SURFACE_ERROR_NONE)
+        {
+            if (surface_info.num_planes > plane_idx)
+            {
+                *plane_data_ptr = surface_info.planes[plane_idx].ptr;
+                LOGD("the tbm_surface_info.planes[%d].ptr = %p\n", plane_idx, surface_info.planes[plane_idx].ptr);
+            }
+            else
+            {
+                LOGE("the plane_idx is invalid, The number of planes = %lu\n", surface_info.num_planes);
+                *plane_data_ptr = NULL;
+                ret = MEDIA_PACKET_ERROR_INVALID_PARAMETER;
+            }
+        }
+        else
+        {
+            LOGE("tbm_surface_get_info() is failed.. 0x%08x \n", err);
+            *plane_data_ptr = NULL;
+            ret = MEDIA_PACKET_ERROR_INVALID_OPERATION;
+        }
+    }
+    else
+    {
+        LOGI("The packet handle doesn't have tbm_surface buffer type...\n");
+        *plane_data_ptr = NULL;
+        ret = MEDIA_PACKET_ERROR_INVALID_OPERATION;
+    }
+
+    return ret;
+}
+
+int media_packet_get_codec_data(media_packet_h packet, void** codec_data, unsigned int* codec_data_size)
+{
+    media_packet_s* handle;
+    int ret = MEDIA_PACKET_ERROR_NONE;
+
+    MEDIA_PACKET_INSTANCE_CHECK(packet);
+    MEDIA_PACKET_NULL_ARG_CHECK(codec_data);
+    MEDIA_PACKET_NULL_ARG_CHECK(codec_data_size);
+
+    handle = (media_packet_s*) packet;
+
+    LOGI("Get: codec data = %p, codec_data_size = %u\n", handle->codec_data, handle->codec_data_size);
+
+    if (handle->codec_data)
+    {
+        *codec_data_size = handle->codec_data_size;
+        *codec_data = handle->codec_data;
+    }
+    else
+    {
+        *codec_data = NULL;
+        *codec_data_size = 0;
+
+        LOGE("There is no codec data..\n");
+        ret = MEDIA_PACKET_ERROR_INVALID_OPERATION;
+    }
+
+    return ret;
+}
+
 int media_packet_destroy(media_packet_h packet)
 {
     media_packet_s* handle;
@@ -1026,9 +1352,17 @@ int media_packet_destroy(media_packet_h packet)
             handle->data = NULL;
         }
     }
-    else if (handle->type == MEDIA_BUFFER_TYPE_EXTERNAL_TBM_SURFACE)
+    else if (handle->type == MEDIA_BUFFER_TYPE_EXTERNAL_TBM_SURFACE || handle->type == MEDIA_BUFFER_TYPE_EXTERNAL_MEMORY)
     {
-        // there is nothing to do
+        // there is nothing to do, Do not free the buffer which is created by external module.
+    }
+
+    /* free codec_data if it is allocated */
+    if (handle->codec_data)
+    {
+        free(handle->codec_data);
+        handle->codec_data = NULL;
+        handle->codec_data_size = 0;
     }
 
     /* unreference media_format */
@@ -1132,181 +1466,3 @@ static void _aligned_free_normal_buffer_type (void* buffer_ptr)
     ptr = NULL;
 }
 
-#if 0
-int media_tool_create(mediatool_h *mediatool)
-{
-    MediaTool_s *handle;
-    int ret;
-    handle = (MediaTool_s*)malloc(sizeof(MediaTool_s));
-
-    if (handle != NULL)
-            memset(handle, 0, sizeof(MediaTool_s));
-    else
-            return MEDIA_TOOL_ERROR_OUT_OF_MEMORY;
-
-    //TODO : make _media_tool_create function
-    //ret = _media_tool_create(&handle->mediatool_handle);
-    if(ret != MEDIA_TOOL_ERROR_NONE)
-        {
-            free(handle);
-            handle = NULL;
-            return MEDIA_TOOL_ERROR_INVALID_OPERATION;
-        }
-    else
-        {
-            *mediatool = (mediatool_h*)handle;
-            handle->refcount = 1;
-            return MEDIA_TOOL_ERROR_NONE;
-        }
-}
-
-int media_tool_destroy(mediatool_h mediatool)
-{
-    MediaTool_s* handle = (MediaTool_s *) mediatool;
-    int ret;
-
-    if (handle == NULL)
-        return MEDIA_TOOL_ERROR_INVALID_PARAMETER;
-
-    //TODO : make _media_tool_create function
-    ret = _media_tool_destroy(handle->mediatool_handle);
-    if (ret != MEDIA_TOOL_ERROR_NONE)
-        {
-            return MEDIA_TOOL_ERROR_INVALID_OPERATION;
-        }
-    else
-        {
-            free(handle);
-            handle = NULL;
-            return MEDIA_TOOL_ERROR_NONE;
-        }
-}
-
-int media_tool_is_Iframe(mediatool_h mediatool, bool *isIFrame)
-{
-    MediaTool_s *handle = (MediaTool_s *) mediatool;
-    int ret;
-    if (handle == NULL)
-        return MEDIA_TOOL_ERROR_INVALID_PARAMETER;
-
-    *isIFrame  = handle->videocodecformat->isIFrame;
-
-    return MEDIA_TOOL_ERROR_NONE;
-}
-
-int media_tool_set_buffer(mediatool_h mediatool, MediaToolBufferPrivate_s* privBuffer)
-{
-    MediaTool_s *handle = (MediaTool_s *) mediatool;
-    int ret;
-    handle->bufferpriv = (MediaToolBufferPrivate_s *)malloc(sizeof(MediaToolBufferPrivate_s));
-
-    if (handle->bufferpriv != NULL)
-        memset(handle->bufferpriv, 0, sizeof(MediaToolBufferPrivate_s));
-    else
-        return MEDIA_TOOL_ERROR_OUT_OF_MEMORY;
-
-    return MEDIA_TOOL_ERROR_NONE;
-}
-
-int media_tool_get_buffer(mediatool_h mediatool, MediaToolBufferPrivate_s** privBuffer)
-{
-    MediaTool_s *handle = (MediaTool_s *) mediatool;
-    int ret;
-    if (handle->bufferpriv == NULL)
-        return MEDIA_TOOL_ERROR_INVALID_OPERATION;
-
-    memcpy(*privBuffer, handle->bufferpriv, sizeof(handle->bufferpriv));
-
-    return MEDIA_TOOL_ERROR_NONE;
-}
-
-int media_tool_set_video_codec_format(mediatool_h mediatool, VideoCodecFormat_s* videoCodecFormat)
-{
-    MediaTool_s *handle = (MediaTool_s *) mediatool;
-    int ret;
-    handle->videocodecformat = (VideoCodecFormat_s *)malloc(sizeof(VideoCodecFormat_s));
-
-    if (handle->videocodecformat != NULL)
-        memset(handle->videocodecformat, 0, sizeof(VideoCodecFormat_s));
-    else
-        return MEDIA_TOOL_ERROR_OUT_OF_MEMORY;
-
-    return MEDIA_TOOL_ERROR_NONE;
-}
-
-int media_tool_get_video_codec_format(mediatool_h mediatool, VideoCodecFormat_s** videoCodecFormat)
-{
-    MediaTool_s *handle = (MediaTool_s *) mediatool;
-    int ret;
-    if (handle->videocodecformat == NULL)
-        return MEDIA_TOOL_ERROR_INVALID_OPERATION;
-
-    memcpy(*videoCodecFormat, handle->videocodecformat, sizeof(handle->videocodecformat));
-
-    return MEDIA_TOOL_ERROR_NONE;
-}
-
-int media_tool_set_audio_codec_format(mediatool_h mediatool, AudioCodecFormat_s* audioCodecFormat)
-{
-    MediaTool_s *handle = (MediaTool_s *) mediatool;
-    int ret;
-    handle->audiocodecformat = (AudioCodecFormat_s *)malloc(sizeof(AudioCodecFormat_s));
-
-    if (handle->audiocodecformat != NULL)
-        memset(handle->audiocodecformat, 0, sizeof(AudioCodecFormat_s));
-    else
-        return MEDIA_TOOL_ERROR_OUT_OF_MEMORY;
-
-    return MEDIA_TOOL_ERROR_NONE;
-}
-
-int media_tool_get_audio_codec_format(mediatool_h mediatool, AudioCodecFormat_s** audioCodecFormat)
-{
-    MediaTool_s *handle = (MediaTool_s *) mediatool;
-    int ret;
-    if (handle->audiocodecformat == NULL)
-        return MEDIA_TOOL_ERROR_INVALID_OPERATION;
-
-    memcpy(*audioCodecFormat, handle->audiocodecformat, sizeof(handle->audiocodecformat));
-
-    return MEDIA_TOOL_ERROR_NONE;
-}
-
-int media_tool_ref(mediatool_h mediatool)
-{
-    MediaTool_s *handle = (MediaTool_s *) mediatool;
-
-    if (handle == NULL)
-        return MEDIA_TOOL_ERROR_INVALID_PARAMETER;
-
-    if (!(handle->refcount> 0))
-        return MEDIA_TOOL_ERROR_INVALID_OPERATION;
-
-    g_atomic_int_inc (&handle->refcount);
-
-    return MEDIA_TOOL_ERROR_NONE;
-}
-
-int media_tool_unref(mediatool_h mediatool)
-{
-    MediaTool_s *handle = (MediaTool_s *) mediatool;
-
-    if (handle == NULL)
-        return MEDIA_TOOL_ERROR_INVALID_PARAMETER;
-
-    if (!(handle->refcount> 0))
-        return MEDIA_TOOL_ERROR_INVALID_OPERATION;
-
-    int zero;
-
-    zero = g_atomic_int_dec_and_test (&handle->refcount);
-    if (zero)
-        {
-            free(handle);
-            handle = NULL;
-        }
-    return MEDIA_TOOL_ERROR_NONE;
-}
-
-#endif
-
diff --git a/src/media_packet_internal.c b/src/media_packet_internal.c
new file mode 100755 (executable)
index 0000000..402e9d4
--- /dev/null
@@ -0,0 +1,55 @@
+/*
+* Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include <dlog.h>
+#include <media_format.h>
+#include <media_packet.h>
+#include <media_packet_internal.h>
+#include <media_packet_private.h>
+#include <media_format_private.h>
+
+int media_packet_set_codec_data(media_packet_h packet, void* codec_data, unsigned int codec_data_size)
+{
+    media_packet_s* handle;
+    int ret = MEDIA_PACKET_ERROR_NONE;
+
+    MEDIA_PACKET_INSTANCE_CHECK(packet);
+
+    handle = (media_packet_s*) packet;
+
+    LOGI("Set: codec data = %p, codec_data_size = %u\n", codec_data, codec_data_size);
+
+    handle->codec_data = (void*)malloc(codec_data_size);
+    if (handle->codec_data != NULL)
+    {
+        memset(handle->codec_data, 0 , codec_data_size);
+    }
+    else
+    {
+        LOGE("[%s] MEDIA_PACKET_ERROR_OUT_OF_MEMORY(0x%08x)" ,__FUNCTION__,MEDIA_PACKET_ERROR_OUT_OF_MEMORY);
+        return MEDIA_PACKET_ERROR_OUT_OF_MEMORY;
+    }
+
+    memcpy(handle->codec_data, codec_data, codec_data_size);
+    handle->codec_data_size = codec_data_size;
+
+    return ret;
+}
+
index ade3cde..e460bff 100755 (executable)
@@ -20,7 +20,7 @@
 #include <media_packet_private.h>
 #include <media_format.h>
 #include <media_format_private.h>
-
+#include <media_packet_internal.h>
 
 #include <appcore-efl.h>
 
@@ -45,6 +45,7 @@ enum
     CURRENT_STATUS_FORMAT_SET_AUDIO_SAMPLERATE,
     CURRENT_STATUS_FORMAT_SET_AUDIO_BIT,
     CURRENT_STATUS_FORMAT_SET_AUDIO_AVG_BPS,
+    CURRENT_STATUS_FORMAT_SET_AUDIO_AAC_TYPE,
 };
 
 
@@ -57,6 +58,11 @@ int media_format_idx = -1;
 bool is_only_created_handle;
 bool is_excute_create;
 
+unsigned char codec_data[0x04] = {0x00, 0x01, 0x02, 0x03};
+unsigned int codec_data_size = 4;
+unsigned char* codec_data_ptr = codec_data;
+
+
 /***********************************************/
 /***  Test API part
 /***********************************************/
@@ -232,6 +238,17 @@ static void _media_format_set_audio_avg_bps(int avg_bps)
         g_print("media_format_set_audio_avg_bps is failed...!!\n");
 }
 
+static void _media_format_set_audio_aac_type(bool is_adts)
+{
+    int ret;
+    ret = media_format_set_audio_aac_type(g_media_format[media_format_idx], is_adts);
+
+    if (ret == MEDIA_FORMAT_ERROR_NONE)
+        g_print("media_format_set_audio_aac_type is succeeded!!\n");
+    else
+        g_print("media_format_set_audio_aac_type is failed...!!\n");
+}
+
 static void _create_format_320_240_es(void)
 {
 
@@ -538,7 +555,7 @@ static void _media_packet_get_buffer_size(void)
     if (media_packet_get_buffer_size(g_media_packet[0],&size) == MEDIA_PACKET_ERROR_NONE)
     {
         g_print("media_packet_get_buffer_size is sucess!!");
-        g_print("\t\t[media_packet]===> size = %llu", size);
+        g_print("\t\t[media_packet]===> size = %llu\n", size);
     }
     else
     {
@@ -553,7 +570,7 @@ static void _media_packet_get_duration(void)
     if (media_packet_get_duration(g_media_packet[0], &duration) == MEDIA_PACKET_ERROR_NONE)
     {
         g_print("media_packet_get_duration is sucess!!");
-        g_print("\t\t[media_packet]===> duration = %llu", duration);
+        g_print("\t\t[media_packet]===> duration = %llu\n", duration);
     }
     else
     {
@@ -575,7 +592,7 @@ static void _media_packet_get_buffer_data_ptr(void)
     if (media_packet_get_buffer_data_ptr(g_media_packet[0], &ptr) == MEDIA_PACKET_ERROR_NONE)
     {
         g_print("media_packet_get_buffer_data_ptr is sucess!!");
-        g_print("\t\t[media_packet]===> buffer_data_ptr = %p", ptr);
+        g_print("\t\t[media_packet]===> buffer_data_ptr = %p\n", ptr);
     }
     else
     {
@@ -591,7 +608,7 @@ static void _media_packet_get_tbm_surface()
     if (media_packet_get_tbm_surface(g_media_packet[0], &tbm_surface) == MEDIA_PACKET_ERROR_NONE)
     {
         g_print("media_packet_get_tbm_surface is sucess!!");
-        g_print("\t\t[media_packet]===> tbm_surface = %p", (void*)tbm_surface);
+        g_print("\t\t[media_packet]===> tbm_surface = %p\n", (void*)tbm_surface);
     }
     else
     {
@@ -599,6 +616,104 @@ static void _media_packet_get_tbm_surface()
     }
 }
 
+static void _media_packet_get_number_of_video_planes()
+{
+    uint32_t num = 0;
+    if (media_packet_get_number_of_video_planes(g_media_packet[0], &num)== MEDIA_PACKET_ERROR_NONE)
+    {
+        g_print("media_packet_get_number_of_video_planes is sucess!!\n");
+        g_print("\t\t[media_packet]===> number of planes = %ld\n", num);
+
+    }
+    else
+    {
+        g_print("media_packet_get_number_of_video_planes is failed...");
+    }
+}
+
+static void _media_packet_get_video_stride_width()
+{
+    int stride_w;
+    if (media_packet_get_video_stride_width(g_media_packet[0], 0, &stride_w)== MEDIA_PACKET_ERROR_NONE)
+    {
+        g_print("media_packet_get_video_stride_width is sucess!!\n");
+        g_print("\t\t[media_packet]===> stride width = %d\n", stride_w);
+
+    }
+    else
+    {
+        g_print("media_packet_get_video_stride_width is failed...");
+    }
+}
+
+static void _media_packet_get_video_stride_height()
+{
+    int stride_h;
+    if (media_packet_get_video_stride_height(g_media_packet[0], 0, &stride_h)== MEDIA_PACKET_ERROR_NONE)
+    {
+        g_print("media_packet_get_video_stride_height is sucess!!\n");
+        g_print("\t\t[media_packet]===> stride height = %d\n", stride_h);
+
+    }
+    else
+    {
+        g_print("media_packet_get_video_stride_height is failed...");
+    }
+}
+
+static void _media_packet_get_video_plane_data_ptr()
+{
+    void* ptr;
+    if (media_packet_get_video_plane_data_ptr(g_media_packet[0], 0, &ptr)== MEDIA_PACKET_ERROR_NONE)
+    {
+        g_print("media_packet_get_video_plane_data_ptr is sucess!!\n");
+        g_print("\t\t[media_packet]===> ptr = %p\n", ptr);
+
+    }
+    else
+    {
+        g_print("_media_packet_get_plane_data_ptr is failed...");
+    }
+}
+
+static void _media_packet_set_codec_data()
+{
+    if (media_packet_set_codec_data(g_media_packet[0], (void*)codec_data_ptr, codec_data_size) == MEDIA_PACKET_ERROR_NONE)
+    {
+        g_print("media_packet_set_codec_data is sucess..!\n");
+    }
+    else
+    {
+        g_print("media_packet_set_codec_data is failed...\n");
+    }
+}
+
+static void _media_packet_get_codec_data()
+{
+    unsigned char* get_codec_data;
+    unsigned int get_codec_data_size;
+
+    if (media_packet_get_codec_data(g_media_packet[0], &get_codec_data, &get_codec_data_size) == MEDIA_PACKET_ERROR_NONE)
+    {
+        g_print("media_packet_get_codec_data is sucess ... !\n");
+        g_print("codec_data_size = %u\n", get_codec_data_size);
+
+        if (get_codec_data_size == 0)
+            return;
+
+        int i;
+        for (i=0 ; i < get_codec_data_size; i++)
+        {
+            g_print("codec_data[%d] ", i);
+            g_print(" = 0x%x\n", get_codec_data[i]);
+        }
+    }
+    else
+    {
+        g_print("media_packet_get_codec_data is failed...\n");
+    }
+}
+
 static void _media_packet_set_duration(uint64_t duration)
 {
     if (media_packet_set_duration(g_media_packet[0], duration) == MEDIA_PACKET_ERROR_NONE)
@@ -806,7 +921,7 @@ static void _media_format_get_audio_info(void)
     if (media_format_get_audio_info(g_media_format[0], &mime, &channel, &samplerate, &bit, &avg_bps)== MEDIA_FORMAT_ERROR_NONE)
     {
         g_print("media_format_get_audio_info is sucess!\n");
-        g_print("\t\t[media_format_get_audio_info]mime:0x%x, channel :%d, samplerate :%d, bit: %d, avg_bps:%d \n", mime, channel, samplerate, bit, avg_bps);
+        g_print("\t\t[media_format_get_audio_info]mime:0x%x, channel :%d, samplerate :%d, bit: %d, avg_bps:%d, is_adts:%d \n", mime, channel, samplerate, bit, avg_bps);
         g_print("packet format ref_count: %d", MEDIA_FORMAT_GET_REFCOUNT(g_media_format[0]));
     }
     else
@@ -1032,6 +1147,31 @@ void _interpret_main_menu(char *cmd)
         {
             g_menu_state = CURRENT_STATUS_FORMAT_SET_AUDIO_BIT;
         }
+        else if (strncmp(cmd, "gnp", 3) == 0)
+        {
+            _media_packet_get_number_of_video_planes();
+        }
+        else if (strncmp(cmd, "gsw", 3) == 0)
+        {
+            _media_packet_get_video_stride_width();
+        }
+        else if (strncmp(cmd, "gsh", 3) == 0)
+        {
+            _media_packet_get_video_stride_height();
+        }
+        else if (strncmp(cmd, "gpp", 3) == 0)
+        {
+            _media_packet_get_video_plane_data_ptr();
+        }
+        else if (strncmp(cmd, "scd", 3) == 0)
+        {
+            _media_packet_set_codec_data();
+        }
+        else if (strncmp(cmd, "gcd", 3) == 0)
+        {
+            _media_packet_get_codec_data();
+        }
+
     }
     else if (len == 4)
     {
@@ -1055,6 +1195,10 @@ void _interpret_main_menu(char *cmd)
         {
             g_menu_state = CURRENT_STATUS_FORMAT_SET_AUDIO_AVG_BPS;
         }
+        else if (strncmp(cmd, "saat", 4) == 0)
+        {
+            g_menu_state = CURRENT_STATUS_FORMAT_SET_AUDIO_AAC_TYPE;
+        }
     }
 
 
@@ -1122,6 +1266,10 @@ static void displaymenu(void)
     {
         g_print("input audio average bps:\n");
     }
+    else if (g_menu_state == CURRENT_STATUS_FORMAT_SET_AUDIO_AAC_TYPE)
+    {
+        g_print("input audio aac type (0 or 1):\n");
+    }
     else
     {
         g_print("*** unknown status.\n");
@@ -1251,6 +1399,13 @@ static void interpret (char *cmd)
                 reset_menu_state();
             }
             break;
+        case CURRENT_STATUS_FORMAT_SET_AUDIO_AAC_TYPE:
+            {
+                bool is_ats = atoi(cmd);
+                _media_format_set_audio_aac_type(is_ats);
+                reset_menu_state();
+            }
+            break;
         case CURRENT_STATUS_DURATION:
             {
                 uint64_t duration = atoi(cmd);
@@ -1288,6 +1443,7 @@ void display_sub_basic()
     g_print("sas. media_format_set_audio_samplerate\t");
     g_print("sab. media_format_set_audio_bit \t");
     g_print("saab. media_format_set_audio_avg_bps\t");
+    g_print("saat. media_format_set_audio_aac_type\t");
     g_print("\n");
     g_print("fgv. media_format_get_video_info \t");
     g_print("fga. media_format_get_audio_info \t\t");
@@ -1318,6 +1474,13 @@ void display_sub_basic()
     g_print("\n");
     g_print("gs. media_packet_get_buffer_size\t");
     g_print("\n");
+    g_print("gnp. media_packet_get_number_of_video_planes\t");
+    g_print("gsw. media_packet_get_video_stride_width\t");
+    g_print("gsh. media_packet_get_video_stride_height\t");
+    g_print("gpp. media_packet_get_video_plane_data_ptr\t");
+    g_print("\n");
+    g_print("scd. media_packet_set_codec_data\t");
+    g_print("gcd. media_packet_get_codec_data\t");
     g_print("\n");
     g_print("d. media_packet_destroy \n");
     g_print("q. quit test suite(if exist alive media_format, do media_format_unref)");