media_format.h,media_packet.h: Remove profile check for supported platform version 86/302386/1 accepted/tizen/unified/20231211.095351 accepted/tizen/unified/riscv/20231226.211752
authorJeongmo Yang <jm80.yang@samsung.com>
Wed, 6 Dec 2023 05:52:05 +0000 (14:52 +0900)
committerJeongmo Yang <jm80.yang@samsung.com>
Wed, 6 Dec 2023 05:52:38 +0000 (14:52 +0900)
[Version] 0.1.61
[Issue Type] Doxygen

Change-Id: If6c00b4f8a694d86d0ae4f61f1a3193b8a946a15
Signed-off-by: Jeongmo Yang <jm80.yang@samsung.com>
include/media_format.h
include/media_packet.h
packaging/capi-media-tool.spec

index 3198203ae4b25d67e10d175ff9b28470825a390a..f215bc5444a6b28a91034be1ca7706e41b4a5886 100644 (file)
@@ -37,13 +37,13 @@ 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 {
        MEDIA_FORMAT_ERROR_NONE = TIZEN_ERROR_NONE,                                     /**< Successful */
@@ -55,7 +55,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 */
@@ -68,7 +68,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 */
@@ -77,29 +77,29 @@ 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
  */
 typedef enum {
        /* 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,  indicates #MEDIA_FORMAT_AMR_NB (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_AMR_NB = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1040),                /**< media format mime type is AMR_NB,  AUDIO , (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_AMR_WB = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1041),                /**< media format mime type is AMR_WB,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
+       MEDIA_FORMAT_AMR = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1040),                   /**< media format mime type is AMR,  AUDIO,  indicates #MEDIA_FORMAT_AMR_NB (Since 2.4) */
+       MEDIA_FORMAT_AMR_NB = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1040),                /**< media format mime type is AMR_NB,  AUDIO , (Since 2.4) */
+       MEDIA_FORMAT_AMR_WB = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1041),                /**< media format mime type is AMR_WB,  AUDIO, (Since 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, indicates #MEDIA_FORMAT_AAC_LC (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_AAC_LC = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1060),                /**< media format mime type is AAC_LC,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_AAC_HE = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1061),                /**< media format mime type is AAC_HE,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_AAC_HE_PS = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1062),     /**< media format mime type is AAC_HE_PS,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
+       MEDIA_FORMAT_AAC = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1060),                   /**< media format mime type is AAC,  AUDIO, indicates #MEDIA_FORMAT_AAC_LC (Since 2.4) */
+       MEDIA_FORMAT_AAC_LC = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1060),                /**< media format mime type is AAC_LC,  AUDIO, (Since 2.4) */
+       MEDIA_FORMAT_AAC_HE = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1061),                /**< media format mime type is AAC_HE,  AUDIO, (Since 2.4) */
+       MEDIA_FORMAT_AAC_HE_PS = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1062),     /**< media format mime type is AAC_HE_PS,  AUDIO, (Since 2.4) */
        MEDIA_FORMAT_MP3 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1070),                   /**< media format mime type is MP3,  AUDIO*/
        MEDIA_FORMAT_MP2 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1071),                        /**< media format mime type is MP23, AUDIO, (Since 4.0) */
-       MEDIA_FORMAT_VORBIS = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1080),                /**< media format mime type is VORBIS,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_FLAC = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1090),                  /**< media format mime type is FLAC,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_WMAV1 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A0),                 /**< media format mime type is WMAV1,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_WMAV2 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A1),                 /**< media format mime type is WMAV2,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_WMAPRO = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A2),                /**< media format mime type is WMAVPRO,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_WMALSL = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A3),                /**< media format mime type is WMAVLSL,  AUDIO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
+       MEDIA_FORMAT_VORBIS = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1080),                /**< media format mime type is VORBIS,  AUDIO, (Since 2.4) */
+       MEDIA_FORMAT_FLAC = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x1090),                  /**< media format mime type is FLAC,  AUDIO, (Since 2.4) */
+       MEDIA_FORMAT_WMAV1 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A0),                 /**< media format mime type is WMAV1,  AUDIO, (Since 2.4) */
+       MEDIA_FORMAT_WMAV2 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A1),                 /**< media format mime type is WMAV2,  AUDIO, (Since 2.4) */
+       MEDIA_FORMAT_WMAPRO = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A2),                /**< media format mime type is WMAVPRO,  AUDIO, (Since 2.4) */
+       MEDIA_FORMAT_WMALSL = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10A3),                /**< media format mime type is WMAVLSL,  AUDIO, (Since 2.4) */
        MEDIA_FORMAT_AC3 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10B1),                        /**< media format mime type is AC3, AUDIO, (Since 4.0) */
        MEDIA_FORMAT_EAC3 = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10B2),                       /**< media format mime type is EAC3, AUDIO, (Since 4.0) */
        MEDIA_FORMAT_DTS = (MEDIA_FORMAT_AUDIO | MEDIA_FORMAT_ENCODED | 0x10C1),                        /**< media format mime type is DTS, AUDIO, (Since 4.0) */
@@ -151,12 +151,12 @@ typedef enum {
        MEDIA_FORMAT_MPEG2_HP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2062),      /**< media format mime type is MPEG2 high profile, VIDEO */
        MEDIA_FORMAT_MPEG4_SP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2070),      /**< media format mime type is MPEG4 simple profile, VIDEO */
        MEDIA_FORMAT_MPEG4_ASP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2071),     /**< media format mime type is MPEG4 advanced simple profile, VIDEO */
-       MEDIA_FORMAT_HEVC = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2080),                  /**< media format mime type is HEVC, VIDEO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
+       MEDIA_FORMAT_HEVC = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2080),                  /**< media format mime type is HEVC, VIDEO, (Since 2.4) */
        MEDIA_FORMAT_HEVC_MP = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2081),              /**< media format mime type is HEVC Main Profile, VIDEO, (Since 3.0) */
        MEDIA_FORMAT_HEVC_M10P = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2082),                  /**< media format mime type is HEVC Main10 Profile, VIDEO, (Since 3.0) */
-       MEDIA_FORMAT_VP8 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2090),                   /**< media format mime type is VP8, VIDEO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_VP9 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x20A0),                   /**< media format mime type is VP9, VIDEO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
-       MEDIA_FORMAT_VC1 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x20B0),                   /**< media format mime type is VC1, VIDEO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
+       MEDIA_FORMAT_VP8 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x2090),                   /**< media format mime type is VP8, VIDEO, (Since 2.4) */
+       MEDIA_FORMAT_VP9 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x20A0),                   /**< media format mime type is VP9, VIDEO, (Since 2.4) */
+       MEDIA_FORMAT_VC1 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x20B0),                   /**< media format mime type is VC1, VIDEO, (Since 2.4) */
        MEDIA_FORMAT_DIVX4 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x20C4),                      /**< media format mime type is DIVX4, VIDEO, (Since 4.0) */
        MEDIA_FORMAT_DIVX5 = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x20C5),                      /**< media format mime type is DIVX5, VIDEO, (Since 4.0) */
        MEDIA_FORMAT_XVID = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_ENCODED | 0x20d0),                       /**< media format mime type is XVID, VIDEO, (Since 4.0) */
@@ -193,7 +193,7 @@ typedef enum {
        MEDIA_FORMAT_CONTAINER_AAC_ADTS = (MEDIA_FORMAT_CONTAINER | 0x4030),                       /**< media format mime type is AAC_ADTS container, AUDIO, (Since 3.0) */
        MEDIA_FORMAT_CONTAINER_AAC_ADIF = (MEDIA_FORMAT_CONTAINER | 0x4031),                       /**< media format mime type is AAC_ADIF container, AUDIO, (Since 3.0) */
 
-       MEDIA_FORMAT_NATIVE_VIDEO = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x7000),      /**< media format mime type is HW dependent, VIDEO, (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
+       MEDIA_FORMAT_NATIVE_VIDEO = (MEDIA_FORMAT_VIDEO | MEDIA_FORMAT_RAW | 0x7000),      /**< media format mime type is HW dependent, VIDEO, (Since 2.4) */
        /* Text */
        MEDIA_FORMAT_TEXT_MP4 = (MEDIA_FORMAT_TEXT | MEDIA_FORMAT_ENCODED | 0x8010),            /**< media format mime type is MP4, TEXT, (Since 3.0) */
        MEDIA_FORMAT_TEXT_3GP = (MEDIA_FORMAT_TEXT | MEDIA_FORMAT_ENCODED | 0x8020),            /**< media format mime type is 3GP, TEXT, (Since 3.0) */
@@ -203,7 +203,7 @@ typedef enum {
 
 /**
  * @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 */
@@ -275,7 +275,7 @@ 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
@@ -342,7 +342,7 @@ int media_format_get_text_info(media_format_h fmt, media_format_mimetype_e *mime
 
 /**
  * @brief Gets video information of media format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks Since 6.5, #MEDIA_FORMAT_ERROR_INVALID_OPERATION is removed.
  * @details   returns mimetype, width, height, average bps, max bps of this media format.
  * @param[in] fmt #media_format_h to get video information
@@ -366,7 +366,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
  * @remarks Since 6.5, #MEDIA_FORMAT_ERROR_INVALID_OPERATION is removed.
  * @details   returns mimetype, channels, height, samplerate bps, max bps of this media format.
  * @param[in] fmt #media_format_h to get audio information
@@ -390,7 +390,7 @@ int media_format_get_audio_info(media_format_h fmt, media_format_mimetype_e *mim
 
 /**
  * @brief Gets audio aac type of media format.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
  * @remarks Since 6.5, #MEDIA_FORMAT_ERROR_INVALID_OPERATION is removed.
  * @param[in] fmt #media_format_h to get audio information
  * @param[out] is_adts AAC ADTS flag of the audio
@@ -477,7 +477,7 @@ int media_format_set_text_type(media_format_h fmt, media_format_text_type_e type
 
 /**
  * @brief Sets video MIME type of media format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] fmt #media_format_h to set
  * @param[in] mimetype #media_format_mimetype_e , ex) #MEDIA_FORMAT_H264_HP
  *
@@ -492,7 +492,7 @@ 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
  * @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()
@@ -508,7 +508,7 @@ 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
  * @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()
@@ -524,7 +524,7 @@ 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
  * @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()
@@ -540,7 +540,7 @@ 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
  * @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()
@@ -571,7 +571,7 @@ int media_format_set_video_frame_rate(media_format_h fmt, int frame_rate);
 
 /**
  * @brief Sets audio MIME type of media format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] fmt #media_format_h to set audio information
  * @param[in] mimetype #media_format_mimetype_e , ex) #MEDIA_FORMAT_PCM
  *
@@ -586,7 +586,7 @@ 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
  * @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()
@@ -602,7 +602,7 @@ 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
  * @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()
@@ -618,7 +618,7 @@ 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
@@ -635,7 +635,7 @@ 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
  * @param[in] fmt #media_format_h to set
  * @param[in] avg_bps average bit per second of the audio
  * @pre must set audio MIME type by media_format_set_audio_mime()
@@ -651,7 +651,7 @@ int media_format_set_audio_avg_bps(media_format_h fmt, int avg_bps);
 
  /**
  * @brief Sets audio aac type of media format.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @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
@@ -684,7 +684,7 @@ int media_format_set_audio_aac_header_type(media_format_h fmt, media_format_aac_
 
 /**
  * @brief Increases 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
  *
@@ -700,7 +700,7 @@ int media_format_ref(media_format_h fmt);
 
 /**
  * @brief Decreases reference count of #media_format_h object.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @param[in] fmt exist #media_format_h
  *
  * @return @c 0 on success,
@@ -715,7 +715,7 @@ int media_format_unref(media_format_h fmt);
 
 /**
  * @brief Checks 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
  * @param[in] fmt exist #media_format_h
  * @param[out] is_writable if ref_count is 1, return true. if not, return false
  *
@@ -737,7 +737,7 @@ int media_format_is_writable(media_format_h fmt, bool *is_writable);
  *              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.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  * @remarks If a new object is returned, it will not have its own copy of extra data.
  *          The new object's extra data object will be the original object's extra data.
  * @param[in] fmt exist #media_format_h , don't access it after calling this function
index 27a681c8c665247ff530ae6b5a28fe0883fca6da..fb7b7a3717d7aa078d512eb3dfcdcc3da21835f2 100644 (file)
@@ -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 {
        MEDIA_PACKET_ERROR_NONE = TIZEN_ERROR_NONE,                                                                                     /**< Successful */
@@ -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 {
        MEDIA_PACKET_CODEC_CONFIG = 0x1,   /**< The buffer marked as such contains codec initialization/codec specific data instead of media data */
@@ -71,7 +71,7 @@ typedef enum {
 /**
  * @deprecated Deprecated since 6.5.
  * @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 {
@@ -97,7 +97,7 @@ typedef enum {
  * @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
@@ -135,7 +135,7 @@ typedef void (*media_packet_dispose_cb)(media_packet_h packet, void *user_data);
  * @deprecated Deprecated since 6.5. Use media_packet_new_alloc() instead.
  * @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 @a packet should be released using media_packet_destroy().
  * @param[in]  fmt       The allocated #media_format_h by caller
  * @param[in]  fcb       The media_packet_finalize_cb() to register
@@ -192,7 +192,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
@@ -365,7 +365,7 @@ int media_packet_unref(media_packet_h packet);
  * @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().
  * @remarks It will return #MEDIA_PACKET_ERROR_INVALID_OPERATION \n
@@ -393,7 +393,7 @@ 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
  *
@@ -413,7 +413,7 @@ int media_packet_alloc(media_packet_h packet);
  * @deprecated Deprecated since 6.5. Use media_packet_new_from_tbm_surface() instead.
  * @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
@@ -472,7 +472,7 @@ int media_packet_create_from_tbm_surface(media_format_h fmt, tbm_surface_h surfa
  * @brief    Creates media packet handle with already allocated external buffer.
  * @details It does not support video's #MEDIA_FORMAT_RAW type.
  *
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @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
@@ -529,7 +529,7 @@ int media_packet_create_from_external_memory(media_format_h fmt, void *mem_ptr,
 
 /**
  * @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
@@ -560,7 +560,7 @@ 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
@@ -591,7 +591,7 @@ int media_packet_set_format(media_packet_h packet, media_format_h fmt);
 
 /**
  * @brief Sets presentation timestamp(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 in nanoseconds to set
@@ -606,7 +606,7 @@ int media_packet_set_pts(media_packet_h packet, uint64_t pts);
 
 /**
  * @brief Sets decoding timestamp(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 in nanoseconds to set
@@ -621,7 +621,7 @@ int media_packet_set_dts(media_packet_h packet, uint64_t dts);
 
 /**
  * @brief Sets 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[in] duration  The duration in nanoseconds to set
@@ -636,7 +636,7 @@ 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[in] size     The buffer size value to set
@@ -651,7 +651,7 @@ int media_packet_set_buffer_size(media_packet_h packet, uint64_t size);
 
 /**
  * @brief Gets presentation timestamp(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 in nanoseconds to get
@@ -666,7 +666,7 @@ int media_packet_get_pts(media_packet_h packet, uint64_t * pts);
 
 /**
  * @brief Gets decoding timestamp(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 in nanoseconds to get
@@ -681,7 +681,7 @@ 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 in nanoseconds to get
@@ -696,7 +696,7 @@ 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
@@ -711,7 +711,7 @@ 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
@@ -726,7 +726,7 @@ 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
@@ -741,7 +741,7 @@ 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
@@ -756,7 +756,7 @@ 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
@@ -771,7 +771,7 @@ 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,
@@ -790,7 +790,7 @@ 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,
@@ -826,7 +826,7 @@ int media_packet_is_text(media_packet_h packet, bool * is_text);
 
 /**
  * @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,
@@ -845,7 +845,7 @@ 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,
@@ -882,7 +882,7 @@ int media_packet_get_flags(media_packet_h packet, media_buffer_flags_e * flags);
 
 /**
  * @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
@@ -900,7 +900,7 @@ 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
@@ -918,7 +918,7 @@ 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,
@@ -937,7 +937,7 @@ 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,
@@ -956,7 +956,7 @@ 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,
@@ -975,7 +975,7 @@ 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,
@@ -995,7 +995,7 @@ int media_packet_has_tbm_surface_buffer(media_packet_h packet, bool * has_tbm_su
  *          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 @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
  *
  * @param[in]  packet   The media packet handle
  * @param[out] num  The number of planes from tbm_surface
@@ -1014,7 +1014,7 @@ int media_packet_get_number_of_video_planes(media_packet_h packet, uint32_t * nu
  *          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 @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
  *
  * @param[in]  packet   The media packet handle
  * @param[in]  plane_idx   The plane index value
@@ -1034,7 +1034,7 @@ int media_packet_get_video_stride_width(media_packet_h packet, int plane_idx, in
  *          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 @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
  *
  * @param[in]  packet   The media packet handle
  * @param[in]  plane_idx   The plane index value
@@ -1054,7 +1054,7 @@ int media_packet_get_video_stride_height(media_packet_h packet, int plane_idx, i
  *          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 @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @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_destroy() or tbm_surface_destroy().
  * @param[in]  packet   The media packet handle
@@ -1071,7 +1071,7 @@ int media_packet_get_video_plane_data_ptr(media_packet_h packet, int plane_idx,
 
 /**
  * @brief Gets codec data and the codec data size of media packet.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
  * @remarks The @a codec_data should be released using free().
  * @param[in] packet   The media packet handle
  * @param[out] codec_data    The codec data to get
@@ -1090,7 +1090,7 @@ int media_packet_get_codec_data(media_packet_h packet, void **codec_data, unsign
  * @brief Destroys the media packet handle.
  * @details The registered media_packet_finalize_cb() or media_packet_dispose_cb() \n
  *          will be invoked when @a packet is released. (since 6.5)
- * @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,
index 765189e7a69fcf046076e92f4416212cb112223f..c3bbb9ff5b43a92dc0fd96c4622707d7ee5852a0 100644 (file)
@@ -1,6 +1,6 @@
 Name:       capi-media-tool
 Summary:    A Core API media tool library in Tizen Native API
-Version:    0.1.60
+Version:    0.1.61
 Release:    0
 Group:      Multimedia/API
 License:    Apache-2.0