[ACR-1635] Support ebook format

[platform/core/api/media-content.git] / include / media_content_type.h

diff --git a/include/media_content_type.h b/include/media_content_type.h
index bd6702c..263a8b1 100755 (executable)
--- a/include/media_content_type.h
+++ b/include/media_content_type.h
@@ -43,19 +43,20 @@ extern "C" {
  * @brief Enumeration for the media file format.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks Since 4.0, #MEDIA_CONTENT_TYPE_OTHERS is related to the following feature:\n
- *              %http://tizen.org/feature/content.scanning.others\n
- *              If this feature is not supported on the device, #MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
+ *          %http://tizen.org/feature/content.scanning.others\n
+ *          If this feature is not supported on the device, #MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  */
 typedef enum {
-       MEDIA_CONTENT_TYPE_IMAGE                = 0,    /**<The type of an image */
-       MEDIA_CONTENT_TYPE_VIDEO                = 1,    /**<The type of a video */
+       MEDIA_CONTENT_TYPE_IMAGE        = 0,    /**<The type of an image */
+       MEDIA_CONTENT_TYPE_VIDEO        = 1,    /**<The type of a video */
        MEDIA_CONTENT_TYPE_SOUND        = 2,    /**<The type of sound */
-       MEDIA_CONTENT_TYPE_MUSIC                = 3,    /**<The type of music */
+       MEDIA_CONTENT_TYPE_MUSIC        = 3,    /**<The type of music */
        MEDIA_CONTENT_TYPE_OTHERS       = 4,    /**<The type of other */
+       MEDIA_CONTENT_TYPE_BOOK         = 5,    /**<The type of book (Since 6.5)*/
 } media_content_type_e;
 
 /**
- * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
+ * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @deprecated Deprecated since 5.0.
  * @brief Enumeration for the storage type.
  * @details This information is used to establish where the folder is.
@@ -227,7 +228,7 @@ typedef struct media_bookmark_s *media_bookmark_h;
 typedef struct media_album_s *media_album_h;
 
 /**
- * @ingroup CAPI_CONTENT_MEDIA_IMAGE_MODULE
+ * @ingroup CAPI_CONTENT_MEDIA_IMAGE_META_MODULE
  * @brief The structure type for the Image metadata handle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  */
@@ -248,6 +249,13 @@ typedef struct video_meta_s *video_meta_h;
 typedef struct audio_meta_s *audio_meta_h;
 
 /**
+ * @ingroup CAPI_CONTENT_MEDIA_BOOK_META_MODULE
+ * @brief The structure type for the Book metadata handle.
+ * @since_tizen 6.5
+ */
+typedef struct book_meta_s *book_meta_h;
+
+/**
  * @ingroup CAPI_CONTENT_MEDIA_FILTER_MODULE
  * @brief The structure type for the Media filter handle.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -270,7 +278,7 @@ typedef void *media_storage_h;
 typedef void *media_face_h;
 
 /**
- * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
+ * @ingroup CAPI_MEDIA_CONTENT_MODULE
  * @brief The structure type for the Media content noti handle.
  * @since_tizen 3.0
  */
@@ -796,6 +804,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media copyright.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -812,6 +821,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media description.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -820,6 +830,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_DESCRIPTION "MEDIA_DESCRIPTION"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media bitrate.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -828,6 +839,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_BITRATE "MEDIA_BITRATE"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media bit per sample.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -836,6 +848,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media sample rate.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -844,6 +857,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_SAMPLERATE "MEDIA_SAMPLERATE"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media channel.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -908,6 +922,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media orientation.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -916,6 +931,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media rating.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -944,8 +960,8 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 /**
  * @deprecated Deprecated since 5.0.
  * @brief Media storage.
- * @details There are 2 types:\n
- *               0-internal storage, 1-external storage\n
+ * @details There are 3 types:\n
+ *               0-internal storage, 1-SD card, 2-USB storage\n
  *               You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -953,6 +969,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media exposure time.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -961,6 +978,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media fnumber.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -969,6 +987,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_FNUMBER "MEDIA_FNUMBER"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media ISO.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -977,6 +996,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_ISO "MEDIA_ISO"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media model.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
@@ -1062,6 +1082,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media copyright pinyin.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -1073,6 +1094,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
 
 /**
+ * @deprecated Deprecated since 5.5.
  * @brief Media description pinyin.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif