From: Jeongmo Yang Date: Wed, 6 Dec 2023 05:52:05 +0000 (+0900) Subject: media_format.h,media_packet.h: Remove profile check for supported platform version X-Git-Tag: accepted/tizen/unified/20231211.095351^0 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=295cf2dc21171c399ee8427a743f54c4f8bf223e;p=platform%2Fcore%2Fapi%2Fmediatool.git media_format.h,media_packet.h: Remove profile check for supported platform version [Version] 0.1.61 [Issue Type] Doxygen Change-Id: If6c00b4f8a694d86d0ae4f61f1a3193b8a946a15 Signed-off-by: Jeongmo Yang --- diff --git a/include/media_format.h b/include/media_format.h index 3198203..f215bc5 100644 --- a/include/media_format.h +++ b/include/media_format.h @@ -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 diff --git a/include/media_packet.h b/include/media_packet.h index 27a681c..fb7b7a3 100644 --- a/include/media_packet.h +++ b/include/media_packet.h @@ -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, diff --git a/packaging/capi-media-tool.spec b/packaging/capi-media-tool.spec index 765189e..c3bbb9f 100644 --- a/packaging/capi-media-tool.spec +++ b/packaging/capi-media-tool.spec @@ -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