include/media_content_type.h

   1 /*
   2 * Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved
   3 *
   4 * Licensed under the Apache License, Version 2.0 (the "License");
   5 * you may not use this file except in compliance with the License.
   6 * You may obtain a copy of the License at
   7 *
   8 * http://www.apache.org/licenses/LICENSE-2.0
   9 *
  10 * Unless required by applicable law or agreed to in writing, software
  11 * distributed under the License is distributed on an "AS IS" BASIS,
  12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 * See the License for the specific language governing permissions and
  14 * limitations under the License.
  15 */
  16
  17
  18 #ifndef __TIZEN_MEDIA_CONTENT_TYPE_H__
  19 #define __TIZEN_MEDIA_CONTENT_TYPE_H__
  20
  21 #include <time.h>
  22 #include <tizen.h>
  23
  24 #ifdef __cplusplus
  25 extern "C" {
  26 #endif /* __cplusplus */
  27
  28 /**
  29  * @file media_content_type.h
  30  * @brief This file contains API related to media-content enumerations for media data types, groups, orientations, \n
  31  *        classes of errors and definitions of media-data. \n
  32  *        Listed APIs are called when iterating over lists of album, group, bookmark and other media,  \n
  33  *        when media items and burst shot are inserted completely and when notification of media DB change is subscribed.
  34  */
  35
  36 /**
  37 * @addtogroup CAPI_MEDIA_CONTENT_MODULE
  38  * @{
  39  */
  40
  41 /**
  42  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  43  * @brief Enumeration for the media file format.
  44  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  45  * @remarks Since 4.0, #MEDIA_CONTENT_TYPE_OTHERS is related to the following feature:\n
  46  *              %http://tizen.org/feature/content.scanning.others\n
  47  *              If this feature is not suppported on the device, MEDIA_CONTENT_TYPE_OTHERS type file is not scanned.
  48  */
  49 typedef enum {
  50         MEDIA_CONTENT_TYPE_IMAGE                = 0,    /**<The type of an image */
  51         MEDIA_CONTENT_TYPE_VIDEO                = 1,    /**<The type of a video */
  52         MEDIA_CONTENT_TYPE_SOUND        = 2,    /**<The type of sound */
  53         MEDIA_CONTENT_TYPE_MUSIC                = 3,    /**<The type of music */
  54         MEDIA_CONTENT_TYPE_OTHERS       = 4,    /**<The type of other */
  55 } media_content_type_e;
  56
  57 /**
  58  * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
  59  * @brief Enumeration for the storage type.
  60  * @details This information is used to establish where the folder is.
  61  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  62  */
  63 typedef enum {
  64         MEDIA_CONTENT_STORAGE_INTERNAL  = 0,    /**< The device's internal storage */
  65         MEDIA_CONTENT_STORAGE_EXTERNAL  = 1,    /**< The device's external storage like sd card*/
  66         MEDIA_CONTENT_STORAGE_EXTERNAL_USB = 2, /**< The external USB storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif) */
  67         MEDIA_CONTENT_STORAGE_CLOUD     = 100,  /**< The Cloud storage (Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif, Deprecated since 4.0) */
  68 } media_content_storage_e;
  69
  70 /**
  71  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  72  * @brief Enumeration for media content DB update items.
  73  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  74  */
  75 typedef enum {
  76         MEDIA_ITEM_FILE         = 0,            /**< File type, an item updated to DB */
  77         MEDIA_ITEM_DIRECTORY    = 1,            /**< Directory type, an item updated to DB */
  78 } media_content_db_update_item_type_e;
  79
  80 /**
  81  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  82  * @brief Enumeration for media content DB update types.
  83  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  84  */
  85 typedef enum {
  86         MEDIA_CONTENT_INSERT            = 0,            /**< Insert, the type of DB update */
  87         MEDIA_CONTENT_DELETE            = 1,            /**< Delete, The type of DB update */
  88         MEDIA_CONTENT_UPDATE    = 2,            /**< Update, The type of DB update */
  89 } media_content_db_update_type_e;
  90
  91 /**
  92  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  93  * @brief Enumeration for orientation types.
  94  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  95  */
  96 typedef enum {
  97         MEDIA_CONTENT_ORIENTATION_NOT_AVAILABLE  = 0,       /**< Not available*/
  98         MEDIA_CONTENT_ORIENTATION_NORMAL         = 1,       /**< Normal*/
  99         MEDIA_CONTENT_ORIENTATION_HFLIP          = 2,       /**< Flip horizontal*/
 100         MEDIA_CONTENT_ORIENTATION_ROT_180        = 3,       /**< Rotate 180 degrees*/
 101         MEDIA_CONTENT_ORIENTATION_VFLIP          = 4,       /**< Flip vertical*/
 102         MEDIA_CONTENT_ORIENTATION_TRANSPOSE      = 5,       /**< Transpose*/
 103         MEDIA_CONTENT_ORIENTATION_ROT_90         = 6,       /**< Rotate 90 degrees*/
 104         MEDIA_CONTENT_ORIENTATION_TRANSVERSE     = 7,       /**< Transverse*/
 105         MEDIA_CONTENT_ORIENTATION_ROT_270        = 8,       /**< Rotate 270 degrees*/
 106 } media_content_orientation_e;
 107
 108 /**
 109  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 110  * @brief Enumeration for ordering.
 111  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 112  */
 113 typedef enum {
 114         MEDIA_CONTENT_ORDER_ASC   = 0,      /**< Ascending order*/
 115         MEDIA_CONTENT_ORDER_DESC  = 1,      /**< Descending order*/
 116         MEDIA_CONTENT_ORDER_OTHER = 2,          /** order by order key**/
 117 } media_content_order_e;
 118
 119 /**
 120  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 121  * @brief Enumeration for collations.
 122  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 123  */
 124 typedef enum {
 125         MEDIA_CONTENT_COLLATE_DEFAULT   = 0,        /**< Default collation BINARY */
 126         MEDIA_CONTENT_COLLATE_NOCASE    = 1,        /**< Collation NOCASE, not case sensitive */
 127         MEDIA_CONTENT_COLLATE_RTRIM     = 2,        /**< Collation RTRIM, trailing space characters are ignored */
 128         MEDIA_CONTENT_COLLATE_LOCALIZED = 3,        /**< Collation LOCALIZATION, NOCASE also applied */
 129 } media_content_collation_e;
 130
 131 #define MEDIA_CONTENT_ERROR_CLASS                               TIZEN_ERROR_MEDIA_CONTENT
 132
 133 /**
 134  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 135  * @brief Enumeration for a media content error.
 136  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 137  */
 138 typedef enum {
 139         MEDIA_CONTENT_ERROR_NONE                    = TIZEN_ERROR_NONE,                    /**< Successful */
 140         MEDIA_CONTENT_ERROR_INVALID_PARAMETER       = TIZEN_ERROR_INVALID_PARAMETER,       /**< Invalid parameter */
 141         MEDIA_CONTENT_ERROR_OUT_OF_MEMORY           = TIZEN_ERROR_OUT_OF_MEMORY,           /**< Out of memory */
 142         MEDIA_CONTENT_ERROR_INVALID_OPERATION       = TIZEN_ERROR_INVALID_OPERATION,       /**< Invalid Operation */
 143         MEDIA_CONTENT_FILE_NO_SPACE_ON_DEVICE       = TIZEN_ERROR_FILE_NO_SPACE_ON_DEVICE, /**< No space left on device */
 144         MEDIA_CONTENT_ERROR_PERMISSION_DENIED             = TIZEN_ERROR_PERMISSION_DENIED,                /**< Permission denied */
 145         MEDIA_CONTENT_ERROR_DB_FAILED               = MEDIA_CONTENT_ERROR_CLASS | 0x01,    /**< DB operation failed */
 146         MEDIA_CONTENT_ERROR_DB_BUSY                 = MEDIA_CONTENT_ERROR_CLASS | 0x02,    /**< DB operation BUSY */
 147         MEDIA_CONTENT_ERROR_NETWORK                 = MEDIA_CONTENT_ERROR_CLASS | 0x03,    /**< Network Fail */
 148         MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT     = MEDIA_CONTENT_ERROR_CLASS | 0x04,    /**< Unsupported Content */
 149         MEDIA_CONTENT_ERROR_NOT_SUPPORTED           = TIZEN_ERROR_NOT_SUPPORTED,           /**< Not supported */
 150 } media_content_error_e;
 151
 152 /**
 153  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 154  * @brief Enumeration for a media group.
 155  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 156  */
 157 typedef enum {
 158         MEDIA_CONTENT_GROUP_DISPLAY_NAME = 0,    /**< Media group ID for display name */
 159         MEDIA_CONTENT_GROUP_TYPE,                /**< Media group ID for a media type */
 160         MEDIA_CONTENT_GROUP_MIME_TYPE,           /**< Media group ID for a mime type */
 161         MEDIA_CONTENT_GROUP_SIZE,                /**< Media group ID for content size */
 162         MEDIA_CONTENT_GROUP_ADDED_TIME,          /**< Media group ID for the added time */
 163         MEDIA_CONTENT_GROUP_MODIFIED_TIME,       /**< Media group ID for the modified time */
 164         MEDIA_CONTENT_GROUP_TITLE,               /**< Media group ID for a content title */
 165         MEDIA_CONTENT_GROUP_ARTIST,              /**< Media group ID for an artist*/
 166         MEDIA_CONTENT_GROUP_ALBUM_ARTIST,        /**< Media group ID for an album artist */
 167         MEDIA_CONTENT_GROUP_GENRE,               /**< Media group ID for a genre*/
 168         MEDIA_CONTENT_GROUP_COMPOSER,            /**< Media group ID for a composer*/
 169         MEDIA_CONTENT_GROUP_YEAR,                /**< Media group ID for a year*/
 170         MEDIA_CONTENT_GROUP_RECORDED_DATE,       /**< Media group ID for the recorded date*/
 171         MEDIA_CONTENT_GROUP_COPYRIGHT,           /**< Media group ID for the copyright*/
 172         MEDIA_CONTENT_GROUP_TRACK_NUM,           /**< Media group ID for a track number*/
 173         MEDIA_CONTENT_GROUP_DESCRIPTION,         /**< Media group ID for a description */
 174         MEDIA_CONTENT_GROUP_LONGITUDE,           /**< Media group ID for the longitude*/
 175         MEDIA_CONTENT_GROUP_LATITUDE,            /**< Media group ID for the latitude*/
 176         MEDIA_CONTENT_GROUP_ALTITUDE,            /**< Media group ID for the altitude*/
 177         MEDIA_CONTENT_GROUP_BURST_IMAGE,         /**< Media group ID for the burst shot (Deprecated since 4.0)*/
 178         MEDIA_CONTENT_GROUP_RATING,              /**< Media group ID for a rating*/
 179         MEDIA_CONTENT_GROUP_AUTHOR,              /**< Media group ID for an author (Deprecated since 4.0)*/
 180         MEDIA_CONTENT_GROUP_PROVIDER,            /**< Media group ID for a provider (Deprecated since 4.0)*/
 181         MEDIA_CONTENT_GROUP_CONTENT_NAME,        /**< Media group ID for the content name (Deprecated since 4.0)*/
 182         MEDIA_CONTENT_GROUP_CATEGORY,            /**< Media group ID for a category (Deprecated since 4.0)*/
 183         MEDIA_CONTENT_GROUP_LOCATION_TAG,        /**< Media group ID for a location tag (Deprecated since 4.0)*/
 184         MEDIA_CONTENT_GROUP_AGE_RATING,          /**< Media group ID for an age rating (Deprecated since 4.0)*/
 185         MEDIA_CONTENT_GROUP_KEYWORD,             /**< Media group ID for a keyword (Deprecated since 4.0)*/
 186         MEDIA_CONTENT_GROUP_WEATHER,             /**< Media group ID for the weather (Deprecated since 4.0)*/
 187         MEDIA_CONTENT_GROUP_MAX                  /**< Invalid media group ID*/
 188 } media_group_e;
 189
 190 /**
 191  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 192  * @brief The structure type for the Media info handle.
 193  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 194  */
 195 typedef struct media_info_s *media_info_h;
 196
 197 /**
 198  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 199  * @brief The structure type for the Media folder handle.
 200  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 201  */
 202 typedef struct media_folder_s *media_folder_h;
 203
 204 /**
 205  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 206  * @brief The structure type for the Media playlist handle.
 207  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 208  */
 209 typedef struct media_playlist_s *media_playlist_h;
 210
 211 /**
 212  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 213  * @brief The structure type for the Media tag handle.
 214  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 215  */
 216 typedef struct media_tag_s *media_tag_h;
 217
 218 /**
 219  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 220  * @brief The structure type for the Media bookmark handle.
 221  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 222  */
 223 typedef struct media_bookmark_s *media_bookmark_h;
 224
 225 /**
 226  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 227  * @brief The structure type for the Media album handle.
 228  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 229  */
 230 typedef struct media_album_s *media_album_h;
 231
 232 /**
 233  * @ingroup CAPI_CONTENT_MEDIA_IMAGE_MODULE
 234  * @brief The structure type for the Image metadata handle.
 235  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 236  */
 237 typedef struct image_meta_s *image_meta_h;
 238
 239 /**
 240  * @ingroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE
 241  * @brief The structure type for the Video metadata handle.
 242  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 243  */
 244 typedef struct video_meta_s *video_meta_h;
 245
 246 /**
 247  * @ingroup CAPI_CONTENT_MEDIA_AUDIO_META_MODULE
 248  * @brief The structure type for the Audio metadata handle.
 249  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 250  */
 251 typedef struct audio_meta_s *audio_meta_h;
 252
 253 /**
 254  * @ingroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 255  * @brief The structure type for the Media filter handle.
 256  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 257  */
 258 typedef struct filter_s *filter_h;
 259
 260 /**
 261  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 262  * @brief The structure type for the Media storage handle.
 263  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 264  */
 265 typedef void *media_storage_h;
 266
 267 /**
 268  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
 269  * @brief The structure type for the Media face handle.
 270  * @since_tizen 3.0
 271  */
 272 typedef void *media_face_h;
 273
 274 /**
 275  * @ingroup CAPI_CONTENT_MEDIA_CONTENT_MODULE
 276  * @brief The structure type for the Media content noti handle.
 277  * @since_tizen 3.0
 278  */
 279 typedef void *media_content_noti_h;
 280
 281 /**
 282  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 283  * @brief Called when the media scanning is finished.
 284  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 285  * @remarks The callback is called in a separate thread(not in the main loop).
 286  *
 287  * @param[in] error     The error code
 288  * @param[in] user_data The user data passed from the foreach function
 289  *
 290  * @pre media_content_scan_folder().
 291  * @see media_content_scan_folder()
 292  */
 293 typedef void (*media_scan_completed_cb)(media_content_error_e error, void * user_data);
 294
 295 /**
 296  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 297  * @brief Called when the notification of the media DB change is subscribed.
 298  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 299  *
 300  * @remarks The callback is called in a separate thread(not in the main loop).
 301  *
 302  * @param[in] error       The error code
 303  * @param[in] pid         The PID which publishes notification
 304  * @param[in] update_item The update item of notification
 305  * @param[in] update_type The update type of notification
 306  * @param[in] media_type  The type of the media content (#media_content_type_e)
 307  * @param[in] uuid        The UUID of media or directory, which is updated
 308  * @param[in] path        The path of the media or directory
 309  * @param[in] mime_type   The mime type of the media info
 310  * @param[in] user_data   The user data passed from the foreach function
 311  *
 312  * @pre media_content_add_db_updated_cb().
 313  * @see media_content_add_db_updated_cb()
 314  */
 315 typedef void (*media_content_db_update_cb)(
 316                                 media_content_error_e error,
 317                                 int pid,
 318                                 media_content_db_update_item_type_e update_item,
 319                                 media_content_db_update_type_e update_type,
 320                                 media_content_type_e media_type,
 321                                 char *uuid,
 322                                 char *path,
 323                                 char *mime_type,
 324                                 void *user_data);
 325
 326
 327 /**
 328  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 329  * @brief Called for every available media info.
 330  * @details Iterates over a list of media info.
 331  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 332  *
 333  * @remarks To use the @a media outside this function, copy the handle with media_info_clone() function. \n
 334  *                  The callback is called in the main loop.
 335  *
 336  * @param[in] media     The handle to the media info
 337  * @param[in] user_data The user data passed from the foreach function
 338  *
 339  * @return @c true to continue with the next iteration of the loop,
 340  *         otherwise @c false to break out of the loop
 341  *
 342  * @pre media_tag_foreach_media_from_db(), media_playlist_foreach_media_from_db(), media_genre_foreach_media_from_db(),
 343  *      media_info_foreach_media_from_db(), media_folder_foreach_media_from_db() will invoke this function.
 344  *
 345  * @see media_info_clone()
 346  * @see media_album_foreach_media_from_db()
 347  * @see media_playlist_foreach_media_from_db()
 348  * @see media_tag_foreach_media_from_db()
 349  * @see media_info_foreach_media_from_db()
 350  * @see media_folder_foreach_media_from_db()
 351  */
 352 typedef bool (*media_info_cb)(media_info_h media, void *user_data);
 353
 354
 355 /**
 356  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 357  * @brief Called when media items are inserted completely.
 358  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 359  *
 360  * @remarks The callback is called in a separate thread(not in the main loop).
 361  *
 362  * @param[in] media     The handle to the media info
 363  * @param[in] user_data The user data passed from the foreach function
 364  *
 365  * @pre media_info_insert_batch_to_db()
 366  * @see media_info_insert_batch_to_db()
 367  */
 368 typedef void (*media_insert_completed_cb)(media_content_error_e error, void * user_data);
 369
 370
 371 /**
 372  * @deprecated Deprecated since 4.0.
 373  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 374  * @brief Called when the burst shot is inserted completely.
 375  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 376  *
 377  * @remarks The callback is called in a separate thread(not in the main loop).
 378  *
 379  * @param[in] media     The handle to the media info
 380  * @param[in] user_data The user data passed from the foreach function
 381  *
 382  * @pre media_info_insert_burst_shot_to_db()
 383  * @see media_info_insert_burst_shot_to_db()
 384  *
 385  */
 386 typedef void (*media_insert_burst_shot_completed_cb)(media_content_error_e error, void * user_data);
 387
 388
 389 /**
 390  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 391  * @brief Called when creating a thumbnail image.
 392  * @details This callback is called for completion of generating the thumbnail image.
 393  *         The following error codes can be delivered. \n
 394  *         #MEDIA_CONTENT_ERROR_NONE, \n
 395  *         #MEDIA_CONTENT_ERROR_INVALID_PARAMETER, \n
 396  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 397  *         #MEDIA_CONTENT_ERROR_PERMISSION_DENIED, \n
 398  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 399  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 400  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 401  *
 402  * @remarks The callback is called in a separate thread(not in the main loop).
 403  *
 404  * @param[in] error     The error code
 405  * @param[in] path      The path of the thumbnail which is generated
 406  * @param[in] user_data The user data passed from the foreach function
 407  *
 408  * @pre media_info_create_thumbnail()
 409  * @see media_info_create_thumbnail()
 410  */
 411 typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const char *path, void *user_data);
 412
 413 /**
 414  * @ingroup CAPI_CONTENT_MEDIA_FACE_DETECTION_MODULE
 415  * @brief Called when face detection on the image is completed.
 416  *
 417  * @details The following error codes can be delivered. \n
 418  *         #MEDIA_CONTENT_ERROR_NONE, \n
 419  *         #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY, \n
 420  *         #MEDIA_CONTENT_ERROR_INVALID_OPERATION, \n
 421  *         #MEDIA_CONTENT_ERROR_DB_FAILED, \n
 422  *         #MEDIA_CONTENT_ERROR_DB_BUSY, \n
 423  *         #MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT
 424  *
 425  * @since_tizen 3.0
 426  *
 427  * @remarks The callback is called in a separate thread(not in the main loop).
 428  *
 429  * @param[in] error     The error code
 430  * @param[in] face_count      The number of all detected faces
 431  * @param[in] user_data The user data passed from the foreach function
 432  *
 433  * @pre media_info_start_face_detection()
 434  * @see media_info_start_face_detection()
 435  */
 436 typedef void (*media_face_detection_completed_cb)(media_content_error_e error, const int face_count, void *user_data);
 437
 438
 439 /**
 440  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 441  * @brief Called for every available media folder.
 442  * @details Iterates over a list of folders.
 443  *
 444  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 445  *
 446  * @remarks To use the @a folder outside this function, copy the handle with the media_folder_clone() function. \n
 447  *                  The callback is called in the main loop.
 448  *
 449  * @param[in] folder    The handle to the media folder
 450  * @param[in] user_data The user data passed from the foreach function
 451  *
 452  * @return @c true to continue with the next iteration of the loop,
 453  *         otherwise @c false to break out of the loop
 454  *
 455  * @pre media_folder_foreach_folder_from_db() will invoke this function.
 456  * @see media_folder_clone()
 457  * @see media_folder_foreach_folder_from_db()
 458  */
 459 typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 460
 461 /**
 462  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 463  * @brief Called for every playlist in the obtained list of playlists.
 464  * @details Iterates over a playlist list.
 465  *
 466  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 467  *
 468  * @remarks To use the @a playlist outside this function, copy the handle with the media_playlist_clone() function. \n
 469  *                  The callback is called in the main loop.
 470  *
 471  * @param[in] playlist  The handle to the media playlist
 472  * @param[in] user_data The user data passed from the foreach function
 473  *
 474  * @return @c true to continue with the next iteration of the loop,
 475  *         otherwise @c false to break out of the loop
 476  *
 477  * @pre media_playlist_foreach_playlist_from_db() will invoke this function.
 478  *
 479  * @see media_playlist_clone()
 480  * @see media_playlist_foreach_playlist_from_db()
 481  */
 482 typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 483
 484 /**
 485  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 486  * @brief Called for every media info with playlist member ID in the obtained list of media info.
 487  * @details Iterates over playlist members.
 488  *
 489  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 490  *
 491  * @remarks To use the @a media outside this function, copy the handle with the media_info_clone() function. \n
 492  *                  The callback is called in the main loop.
 493  *
 494  * @param[in] playlist_member_id The ID to member of the playlist
 495  * @param[in] media              The handle to the media info
 496  * @param[in] user_data          The user data passed from the foreach function
 497  *
 498  * @return @c true to continue with the next iteration of the loop,
 499  *         otherwise @c false to break out of the loop
 500  *
 501  * @pre media_playlist_foreach_media_from_db() will invoke this function.
 502  *
 503  * @see media_info_clone()
 504  * @see media_playlist_foreach_media_from_db()
 505  */
 506 typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, void *user_data);
 507
 508 /**
 509  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 510  * @brief Called for every tag in the obtained list of tags.
 511  * @details Iterates over a list of tags.
 512  *
 513  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 514  *
 515  * @remarks To use the @a tag outside this function, copy the handle with the media_tag_clone() function. \n
 516  *                  The callback is called in the main loop.
 517  *
 518  * @param[in] tag       The handle to the media tag
 519  * @param[in] user_data The user data passed from the foreach function
 520  *
 521  * @return @c true to continue with the next iteration of the loop,
 522  *         otherwise @c false to break out of the loop
 523  *
 524  * @pre media_tag_foreach_tag_from_db(), media_info_foreach_tag_from_db() will invoke this function.
 525  *
 526  * @see media_tag_clone()
 527  * @see media_tag_foreach_tag_from_db()
 528  * @see media_info_foreach_tag_from_db()
 529  */
 530 typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
 531
 532 /**
 533  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 534  * @brief Called for every bookmark in the obtained list of bookmarks.
 535  * @details Iterates over a bookmark list.
 536  *
 537  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 538  *
 539  * @remarks To use the @a bookmark outside this function, copy the handle with the media_bookmark_clone() function. \n
 540  *                  The callback is called in the main loop.
 541  *
 542  * @param[in] bookmark  The handle to the video bookmark
 543  * @param[in] user_data The user data passed from the foreach function
 544  *
 545  * @return @c true to continue with the next iteration of the loop,
 546  *         otherwise @c false to break out of the loop
 547  *
 548  * @pre media_info_foreach_bookmark_from_db() will invoke this function.
 549  * @see media_info_foreach_bookmark_from_db()
 550  */
 551 typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
 552
 553 /**
 554  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 555  * @brief Called for every album in the obtained list of groups.
 556  * @details Iterates over an album list.
 557  *
 558  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 559  *
 560  * @remarks To use the @a album outside this function, copy the handle with the media_album_clone() function. \n
 561  *                  The callback is called in the main loop.
 562  *
 563  * @param[in] album     The handle to the media album
 564  * @param[in] user_data The user data passed from the foreach function
 565  *
 566  * @return @c true to continue with the next iteration of the loop,
 567  *         otherwise @c false to break out of the loop
 568  *
 569  * @pre media_album_foreach_album_from_db() will invoke this function.
 570  *
 571  * @see media_album_clone()
 572  * @see media_album_foreach_album_from_db()
 573  */
 574 typedef bool (*media_album_cb)(media_album_h album, void *user_data);
 575
 576 /**
 577  * @ingroup CAPI_CONTENT_MEDIA_GROUP_MODULE
 578  * @brief Called for every group in the obtained list of groups.
 579  * @details Iterates over a media group list.
 580  *
 581  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 582  *
 583  * @remarks You should not free @a group_name returned by this function. \n
 584  *                  The callback is called in the main loop.
 585  *
 586  * @param[in] group_name The name of the media group
 587  * @param[in] user_data  The user data passed from the foreach function
 588  *
 589  * @return @c true to continue with the next iteration of the loop,
 590  *         otherwise @c false to break out of the loop
 591  *
 592  * @pre media_group_foreach_group_from_db() will invoke this function.
 593  * @see media_group_foreach_group_from_db()
 594  */
 595 typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 596
 597 /**
 598  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 599  * @brief Called for every storage in the obtained list of storages.
 600  * @details Iterates over a media storage list.
 601  *
 602  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 603  *
 604  * @remarks You should not destroy @a storage returned by this function. \n
 605  *                  The callback is called in the main loop.
 606  *
 607  * @param[in] storage     The handle of the media storage
 608  * @param[in] user_data  The user data passed from the foreach function
 609  *
 610  * @return @c true to continue with the next iteration of the loop,
 611  *         otherwise @c false to break out of the loop
 612  *
 613  * @pre media_storage_foreach_storage_from_db() will invoke this function.
 614  * @see media_storage_foreach_storage_from_db()
 615  */
 616 typedef bool (*media_storage_cb)(media_storage_h storage, void *user_data);
 617
 618 /**
 619  * @ingroup CAPI_CONTENT_MEDIA_FACE_MODULE
 620  * @brief Called for every face in the obtained list of face.
 621  * @details Iterates over a media face list.
 622  *
 623  * @since_tizen 3.0
 624  *
 625  * @remarks You should not destroy @a face returned by this function. \n
 626  *                  The callback is called in the main loop.
 627  *
 628  * @param[in] face     The handle of the media face
 629  * @param[in] user_data  The user data passed from the foreach function
 630  *
 631  * @return @c true to continue with the next iteration of the loop,
 632  *         otherwise @c false to break out of the loop
 633  *
 634  * @pre media_info_foreach_face_from_db() will invoke this function.
 635  * @see media_info_foreach_face_from_db()
 636  */
 637 typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 638
 639 /**
 640  * @}
 641  */
 642
 643 /**
 644  * @addtogroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 645  * @{
 646  */
 647
 648  /**
 649  * @brief Media ID
 650  * @details You can use above define to set the condition of media filter and order keyword.
 651  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 652  *
 653  */
 654 #define MEDIA_ID "MEDIA_ID"
 655
 656 /**
 657  * @brief Media full path
 658  * @details You can use above define to set the condition of media filter and order keyword.
 659  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 660  *
 661  */
 662 #define MEDIA_PATH "MEDIA_PATH"
 663
 664 /**
 665  * @brief The file name including the extension
 666  * @details You can use above define to set the condition of media filter and order keyword.
 667  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 668  *
 669  */
 670 #define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"
 671
 672 /**
 673  * @brief Media type
 674  * @details There are 5 media types:\n
 675  *               0-image, 1-video, 2-sound, 3-music, 4-other\n
 676  *               You can use above define to set the condition of media filter and order keyword.
 677  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 678  *
 679  */
 680 #define MEDIA_TYPE "MEDIA_TYPE"
 681
 682 /**
 683  * @brief Media MIME type
 684  * @details You can use above define to set the condition of media filter and order keyword.
 685  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 686  *
 687  */
 688 #define MEDIA_MIME_TYPE "MEDIA_MIME_TYPE"
 689
 690
 691 /**
 692  * @brief Media file size
 693  * @details You can use above define to set the condition of media filter and order keyword.
 694  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 695  *
 696  */
 697 #define MEDIA_SIZE "MEDIA_SIZE"
 698
 699 /**
 700  * @brief The time that content file was first added to media database
 701  * @details You can use above define to set the condition of media filter and order keyword.
 702  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 703  *
 704  */
 705 #define MEDIA_ADDED_TIME "MEDIA_ADDED_TIME"
 706
 707 /**
 708  * @brief The last modification time provided by the file system
 709  * @details You can use above define to set the condition of media filter and order keyword.
 710  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 711  *
 712  */
 713 #define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
 714
 715 /**
 716  * @brief  Media created time
 717  * @details You can use above define to set the condition of media filter and order keyword.
 718  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 719  *
 720  */
 721 #define MEDIA_TIMELINE "MEDIA_TIMELINE"
 722
 723 /**
 724  * @brief Media thumbnail path
 725  * @details You can use above define to set the condition of media filter and order keyword.
 726  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 727  *
 728  */
 729 #define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"
 730
 731 /**
 732  * @brief Media title get from tag or file name
 733  * @details You can use above define to set the condition of media filter and order keyword.
 734  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 735  *
 736  */
 737 #define MEDIA_TITLE "MEDIA_TITLE"
 738
 739 /**
 740  * @brief Media album name
 741  * @details You can use above define to set the condition of media filter and order keyword.
 742  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 743  *
 744  */
 745 #define MEDIA_ALBUM "MEDIA_ALBUM"
 746
 747 /**
 748  * @brief Media artist
 749  * @details You can use above define to set the condition of media filter and order keyword.
 750  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 751  *
 752  */
 753 #define MEDIA_ARTIST "MEDIA_ARTIST"
 754
 755 /**
 756  * @brief Media album artist
 757  * @details You can use above define to set the condition of media filter and order keyword.
 758  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 759  *
 760  */
 761 #define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"
 762
 763 /**
 764  * @brief Media genre
 765  * @details You can use above define to set the condition of media filter and order keyword.
 766  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 767  *
 768  */
 769 #define MEDIA_GENRE "MEDIA_GENRE"
 770
 771 /**
 772  * @brief Media composer
 773  * @details You can use above define to set the condition of media filter and order keyword.
 774  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 775  *
 776  */
 777 #define MEDIA_COMPOSER "MEDIA_COMPOSER"
 778
 779 /**
 780  * @brief Media year
 781  * @details You can use above define to set the condition of media filter and order keyword.
 782  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 783  *
 784  */
 785 #define MEDIA_YEAR "MEDIA_YEAR"
 786
 787 /**
 788  * @brief Media recorded date
 789  * @details You can use above define to set the condition of media filter and order keyword.
 790  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 791  *
 792  */
 793 #define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"
 794
 795 /**
 796  * @brief Media copyright
 797  * @details You can use above define to set the condition of media filter and order keyword.
 798  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 799  *
 800  */
 801 #define MEDIA_COPYRIGHT "MEDIA_COPYRIGHT"
 802
 803 /**
 804  * @brief Media track number
 805  * @details You can use above define to set the condition of media filter and order keyword.
 806  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 807  *
 808  */
 809 #define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"
 810
 811 /**
 812  * @brief Media description
 813  * @details You can use above define to set the condition of media filter and order keyword.
 814  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 815  *
 816  */
 817 #define MEDIA_DESCRIPTION "MEDIA_DESCRIPTION"
 818
 819 /**
 820  * @brief Media bitrate
 821  * @details You can use above define to set the condition of media filter and order keyword.
 822  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 823  *
 824  */
 825 #define MEDIA_BITRATE "MEDIA_BITRATE"
 826
 827 /**
 828  * @brief Media bit per sample
 829  * @details You can use above define to set the condition of media filter and order keyword.
 830  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 831  *
 832  */
 833 #define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"
 834
 835 /**
 836  * @brief Media sample rate
 837  * @details You can use above define to set the condition of media filter and order keyword.
 838  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 839  *
 840  */
 841 #define MEDIA_SAMPLERATE "MEDIA_SAMPLERATE"
 842
 843 /**
 844  * @brief Media channel
 845  * @details You can use above define to set the condition of media filter and order keyword.
 846  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 847  *
 848  */
 849 #define MEDIA_CHANNEL "MEDIA_CHANNEL"
 850
 851 /**
 852  * @brief Media duration
 853  * @details You can use above define to set the condition of media filter and order keyword.
 854  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 855  *
 856  */
 857 #define MEDIA_DURATION "MEDIA_DURATION"
 858
 859 /**
 860  * @brief Media longitude
 861  * @details You can use above define to set the condition of media filter and order keyword.
 862  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 863  *
 864  */
 865 #define MEDIA_LONGITUDE "MEDIA_LONGITUDE"
 866
 867 /**
 868  * @brief Media latitude
 869  * @details You can use above define to set the condition of media filter and order keyword.
 870  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 871  *
 872  */
 873 #define MEDIA_LATITUDE "MEDIA_LATITUDE"
 874
 875 /**
 876  * @brief Media altitude
 877  * @details You can use above define to set the condition of media filter and order keyword.
 878  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 879  *
 880  */
 881 #define MEDIA_ALTITUDE "MEDIA_ALTITUDE"
 882
 883 /**
 884  * @brief Media width
 885  * @details You can use above define to set the condition of media filter and order keyword.
 886  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 887  *
 888  */
 889 #define MEDIA_WIDTH "MEDIA_WIDTH"
 890
 891 /**
 892  * @brief Media height
 893  * @details You can use above define to set the condition of media filter and order keyword.
 894  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 895  *
 896  */
 897 #define MEDIA_HEIGHT "MEDIA_HEIGHT"
 898
 899 /**
 900  * @brief Media datetaken
 901  * @details You can use above define to set the condition of media filter and order keyword.
 902  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 903  *
 904  */
 905 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
 906
 907 /**
 908  * @brief Media orientation
 909  * @details You can use above define to set the condition of media filter and order keyword.
 910  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 911  *
 912  */
 913 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
 914
 915 /**
 916  * @deprecated Deprecated since 4.0.
 917  * @brief Media burst ID
 918  * @details You can use above define to set the condition of media filter and order keyword.
 919  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 920  *
 921  */
 922 #define MEDIA_BURST_ID "BURST_ID"
 923
 924 /**
 925  * @deprecated Deprecated since 4.0.
 926  * @brief Media playedcount
 927  * @details You can use above define to set the condition of media filter and order keyword.
 928  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 929  *
 930  */
 931 #define MEDIA_PLAYED_COUNT "MEDIA_PLAYED_COUNT"
 932
 933 /**
 934  * @deprecated Deprecated since 4.0.
 935  * @brief Media last played time
 936  * @details You can use above define to set the condition of media filter and order keyword.
 937  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 938  *
 939  */
 940 #define MEDIA_LAST_PLAYED_TIME "MEDIA_LAST_PLAYED_TIME"
 941
 942 /**
 943  * @deprecated Deprecated since 4.0.
 944  * @brief Media last played position of file
 945  * @details You can use above define to set the condition of media filter and order keyword.
 946  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 947  *
 948  */
 949 #define MEDIA_LAST_PLAYED_POSITION "MEDIA_LAST_PLAYED_POSITION"
 950
 951 /**
 952  * @brief Media rating
 953  * @details You can use above define to set the condition of media filter and order keyword.
 954  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 955  *
 956  */
 957 #define MEDIA_RATING "MEDIA_RATING"
 958
 959 /**
 960  * @brief The time to register favourite
 961  * @details You can use above define to set the condition of media filter and order keyword.
 962  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 963  *
 964  */
 965 #define MEDIA_FAVOURITE "MEDIA_FAVOURITE"
 966
 967 /**
 968  * @deprecated Deprecated since 4.0.
 969  * @brief Media author
 970  * @details You can use above define to set the condition of media filter and order keyword.
 971  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 972  *
 973  */
 974 #define MEDIA_AUTHOR "MEDIA_AUTHOR"
 975
 976 /**
 977  * @deprecated Deprecated since 4.0.
 978  * @brief Media provider
 979  * @details You can use above define to set the condition of media filter and order keyword.
 980  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 981  *
 982  */
 983 #define MEDIA_PROVIDER "MEDIA_PROVIDER"
 984
 985 /**
 986  * @deprecated Deprecated since 4.0.
 987  * @brief Media content name
 988  * @details You can use above define to set the condition of media filter and order keyword.
 989  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 990  *
 991  */
 992 #define MEDIA_CONTENT_NAME "MEDIA_CONTENT_NAME"
 993
 994 /**
 995  * @deprecated Deprecated since 4.0.
 996  * @brief Media category
 997  * @details You can use above define to set the condition of media filter and order keyword.
 998  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 999  *
1000  */
1001 #define MEDIA_CATEGORY "MEDIA_CATEGORY"
1002
1003 /**
1004  * @deprecated Deprecated since 4.0.
1005  * @brief Media location tag
1006  * @details You can use above define to set the condition of media filter and order keyword.
1007  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1008  *
1009  */
1010 #define MEDIA_LOCATION_TAG "MEDIA_LOCATION_TAG"
1011
1012 /**
1013  * @deprecated Deprecated since 4.0.
1014  * @brief Media age rating
1015  * @details You can use above define to set the condition of media filter and order keyword.
1016  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1017  *
1018  */
1019 #define MEDIA_AGE_RATING "MEDIA_AGE_RATING"
1020
1021 /**
1022  * @deprecated Deprecated since 4.0.
1023  * @brief Media keyword
1024  * @details You can use above define to set the condition of media filter and order keyword.
1025  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1026  *
1027  */
1028 #define MEDIA_KEYWORD "MEDIA_KEYWORD"
1029
1030 /**
1031  * @deprecated Deprecated since 4.0.
1032  * @brief Media weather
1033  * @details You can use above define to set the condition of media filter and order keyword.
1034  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1035  *
1036  */
1037 #define MEDIA_WEATHER "MEDIA_WEATHER"
1038
1039 /**
1040  * @brief Is DRM
1041  * @details There are 2 types:\n
1042  *               0-not drm, 1-drm\n
1043  *               You can use above define to set the condition of media filter and order keyword.
1044  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1045  *
1046  */
1047 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
1048
1049 /**
1050  * @brief Media storage
1051  * @details There are 2 types:\n
1052  *               0-internal storage, 1-external storage\n
1053  *               You can use above define to set the condition of media filter and order keyword.
1054  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1055  *
1056  */
1057 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"
1058
1059 /**
1060  * @brief Media exposure time
1061  * @details You can use above define to set the condition of media filter and order keyword.
1062  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1063  *
1064  */
1065 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"
1066
1067 /**
1068  * @brief Media fnumber
1069  * @details You can use above define to set the condition of media filter and order keyword.
1070  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1071  *
1072  */
1073 #define MEDIA_FNUMBER "MEDIA_FNUMBER"
1074
1075 /**
1076  * @brief Media ISO
1077  * @details You can use above define to set the condition of media filter and order keyword.
1078  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1079  *
1080  */
1081 #define MEDIA_ISO "MEDIA_ISO"
1082
1083 /**
1084  * @brief Media model
1085  * @details You can use above define to set the condition of media filter and order keyword.
1086  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1087  *
1088  */
1089 #define MEDIA_MODEL "MEDIA_MODEL"
1090
1091 /**
1092  * @brief Media file name pinyin
1093  * @details You can use above define to set the condition of media filter and order keyword.
1094  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1095  * @remarks Since 4.0, this keyword is related to the following feature:\n
1096  *          - %http://tizen.org/feature/content.filter.pinyin\n
1097  *             If this feature is not supported on the device, PINYIN search does not work.
1098  *
1099  */
1100 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
1101
1102 /**
1103  * @brief Media title pinyin
1104  * @details You can use above define to set the condition of media filter and order keyword.
1105  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1106  * @remarks Since 4.0, this keyword is related to the following feature:\n
1107  *          - %http://tizen.org/feature/content.filter.pinyin\n
1108  *             If this feature is not supported on the device, PINYIN search does not work.
1109  *
1110  */
1111 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
1112
1113 /**
1114  * @brief Media album pinyin
1115  * @details You can use above define to set the condition of media filter and order keyword.
1116  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1117  * @remarks Since 4.0, this keyword is related to the following feature:\n
1118  *          - %http://tizen.org/feature/content.filter.pinyin\n
1119  *            If this feature is not supported on the device, PINYIN search does not work.
1120  *
1121  */
1122 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
1123
1124 /**
1125  * @brief Media artist pinyin
1126  * @details You can use above define to set the condition of media filter and order keyword.
1127  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1128  * @remarks Since 4.0, this keyword is related to the following feature:\n
1129  *          - %http://tizen.org/feature/content.filter.pinyin\n
1130  *             If this feature is not supported on the device, PINYIN search does not work.
1131  *
1132  */
1133 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
1134
1135 /**
1136  * @brief Media album artist pinyin
1137  * @details You can use above define to set the condition of media filter and order keyword.
1138  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1139  * @remarks Since 4.0, this keyword is related to the following feature:\n
1140  *          - %http://tizen.org/feature/content.filter.pinyin\n
1141  *            If this feature is not supported on the device, PINYIN search does not work.
1142  *
1143  */
1144 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
1145
1146 /**
1147  * @brief Media genre pinyin
1148  * @details You can use above define to set the condition of media filter and order keyword.
1149  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1150  * @remarks Since 4.0, this keyword is related to the following feature:\n
1151  *          - %http://tizen.org/feature/content.filter.pinyin\n
1152  *            If this feature is not supported on the device, PINYIN search does not work.
1153  *
1154  */
1155 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
1156
1157 /**
1158  * @brief Media composer pinyin
1159  * @details You can use above define to set the condition of media filter and order keyword.
1160  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1161  * @remarks Since 4.0, this keyword is related to the following feature:\n
1162  *          - %http://tizen.org/feature/content.filter.pinyin\n
1163  *            If this feature is not supported on the device, PINYIN search does not work.
1164  *
1165  */
1166 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
1167
1168 /**
1169  * @brief Media copyright pinyin
1170  * @details You can use above define to set the condition of media filter and order keyword.
1171  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1172  * @remarks Since 4.0, this keyword is related to the following feature:\n
1173  *          - %http://tizen.org/feature/content.filter.pinyin\n
1174  *            If this feature is not supported on the device, PINYIN search does not work.
1175  *
1176  */
1177 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
1178
1179 /**
1180  * @brief Media description pinyin
1181  * @details You can use above define to set the condition of media filter and order keyword.
1182  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1183  * @remarks Since 4.0, this keyword is related to the following feature:\n
1184  *          - %http://tizen.org/feature/content.filter.pinyin\n
1185  *            If this feature is not supported on the device, PINYIN search does not work.
1186  *
1187  */
1188 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
1189
1190 /**
1191  * @deprecated Deprecated since 4.0.
1192  * @brief Media author pinyin
1193  * @details You can use above define to set the condition of media filter and order keyword.
1194  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1195  * @remarks Since 4.0, this keyword is related to the following feature:\n
1196  *          - %http://tizen.org/feature/content.filter.pinyin\n
1197  *            If this feature is not supported on the device, PINYIN search does not work.
1198  *
1199  */
1200 #define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"
1201
1202 /**
1203  * @deprecated Deprecated since 4.0.
1204  * @brief Media provider pinyin
1205  * @details You can use above define to set the condition of media filter and order keyword.
1206  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1207  * @remarks Since 4.0, this keyword is related to the following feature:\n
1208  *          - %http://tizen.org/feature/content.filter.pinyin\n
1209  *            If this feature is not supported on the device, PINYIN search does not work.
1210  *
1211  */
1212 #define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"
1213
1214 /**
1215  * @deprecated Deprecated since 4.0.
1216  * @brief Media content name pinyin
1217  * @details You can use above define to set the condition of media filter and order keyword.
1218  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1219  * @remarks Since 4.0, this keyword is related to the following feature:\n
1220  *          - %http://tizen.org/feature/content.filter.pinyin\n
1221  *            If this feature is not supported on the device, PINYIN search does not work.
1222  *
1223  */
1224 #define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"
1225
1226 /**
1227  * @deprecated Deprecated since 4.0.
1228  * @brief Media category pinyin
1229  * @details You can use above define to set the condition of media filter and order keyword.
1230  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1231  * @remarks Since 4.0, this keyword is related to the following feature:\n
1232  *          - %http://tizen.org/feature/content.filter.pinyin\n
1233  *            If this feature is not supported on the device, PINYIN search does not work.
1234  *
1235  */
1236 #define MEDIA_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"
1237
1238 /**
1239  * @deprecated Deprecated since 4.0.
1240  * @brief Media location tag pinyin
1241  * @details You can use above define to set the condition of media filter and order keyword.
1242  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1243  * @remarks Since 4.0, this keyword is related to the following feature:\n
1244  *          - %http://tizen.org/feature/content.filter.pinyin\n
1245  *            If this feature is not supported on the device, PINYIN search does not work.
1246  *
1247  */
1248 #define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"
1249
1250 /**
1251  * @deprecated Deprecated since 4.0.
1252  * @brief Media age rating pinyin
1253  * @details You can use above define to set the condition of media filter and order keyword.
1254  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1255  * @remarks Since 4.0, this keyword is related to the following feature:\n
1256  *          - %http://tizen.org/feature/content.filter.pinyin\n
1257  *            If this feature is not supported on the device, PINYIN search does not work.
1258  *
1259  */
1260 #define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"
1261
1262 /**
1263  * @deprecated Deprecated since 4.0.
1264  * @brief Media keyword pinyin
1265  * @details You can use above define to set the condition of media filter and order keyword.
1266  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1267  * @remarks Since 4.0, this keyword is related to the following feature:\n
1268  *          - %http://tizen.org/feature/content.filter.pinyin\n
1269  *            If this feature is not supported on the device, PINYIN search does not work.
1270  *
1271  */
1272 #define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"
1273
1274 /**
1275  * @brief Virtual Reality content
1276  * @details You can use above define to set the condition of media filter and order keyword.
1277  * @since_tizen 3.0
1278  *
1279  */
1280 #define MEDIA_360 "MEDIA_360"
1281
1282  /**
1283  * @brief Folder ID
1284  * @details You can use above define to set the condition of folder filter and order keyword.
1285  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1286  */
1287 #define FOLDER_ID "FOLDER_ID"
1288
1289 /**
1290  * @brief Folder full path
1291  * @details You can use above define to set the condition of folder filter and order keyword.
1292  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1293  */
1294 #define FOLDER_PATH "FOLDER_PATH"
1295
1296 /**
1297  * @brief Folder base name
1298  * @details You can use above define to set the condition of folder filter and order keyword.
1299  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1300  */
1301 #define FOLDER_NAME "FOLDER_NAME"
1302
1303 /**
1304  * @deprecated Deprecated since 4.0.
1305  * @brief Folder modified time
1306  * @details You can use above define to set the condition of folder filter and order keyword.
1307  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1308  */
1309 #define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"
1310
1311 /**
1312  * @brief Folder storage
1313  * @details There are 2 types:\n
1314  *               0-internal storage, 1-external storage\n
1315  *               You can use above define to set the condition of folder filter and order keyword.
1316  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1317  */
1318 #define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"
1319
1320 /**
1321  * @brief Folder base name pinyin
1322  * @details You can use above define to set the condition of folder filter and order keyword.
1323  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1324  * @remarks Since 4.0, this keyword is related to the following feature:\n
1325  *          - %http://tizen.org/feature/content.filter.pinyin\n
1326  *            If this feature is not supported on the device, PINYIN search does not work.
1327  */
1328 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
1329
1330 /**
1331  * @deprecated Deprecated since 4.0.
1332  * @brief Folder order info
1333  * @details You can use above define to set the condition of folder filter and order keyword.
1334  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1335  */
1336 #define FOLDER_ORDER "FOLDER_ORDER"
1337
1338 /**
1339  * @deprecated Deprecated since 4.0.
1340  * @brief Parent folder id
1341  * @details You can use above define to set the condition of folder filter and order keyword.
1342  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1343  */
1344 #define FOLDER_PARENT_FOLDER_ID "FOLDER_PARENT_FOLDER_ID"
1345
1346 /**
1347  * @brief Playlist name
1348  * @details You can use above define to set the condition of playlist filter and order keyword.
1349  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1350  */
1351 #define PLAYLIST_NAME "PLAYLIST_NAME"
1352
1353 /**
1354  * @brief Playlist id
1355  * @details You can use above define to set the condition of playlist filter and order keyword.
1356  * @since_tizen 4.0
1357  */
1358 #define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
1359
1360 /**
1361  * @brief Playlist name
1362  * @details You can use above define to set the condition of playlist filter and order keyword.
1363  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1364  */
1365 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
1366
1367 /**
1368  * @brief Media count in playlist
1369  * @details You can use above define to set the condition of playlist filter and order keyword.
1370  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1371  */
1372 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
1373
1374 /**
1375  * @brief Tag name
1376  * @details You can use above define to set the condition of tag filter and order keyword.
1377  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1378  */
1379 #define TAG_NAME "TAG_NAME"
1380
1381 /**
1382  * @brief Tag id
1383  * @details You can use above define to set the condition of tag filter and order keyword.
1384  * @since_tizen 4.0
1385  */
1386 #define MEDIA_TAG_ID "TAG_ID"
1387
1388 /**
1389  * @brief Media count in tag
1390  * @details You can use above define to set the condition of tag filter and order keyword.
1391  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1392  */
1393 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
1394
1395 /**
1396  * @brief Bookmark marked time
1397  * @details You can use above define to set the condition of bookmark filter and order keyword.
1398  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1399  */
1400 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
1401
1402 /**
1403  * @brief Bookmark id
1404  * @details You can use above define to set the condition of bookmark filter and order keyword.
1405  * @since_tizen 4.0
1406  */
1407 #define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
1408
1409 /**
1410  * @brief Bookmark name
1411  * @details You can use above define to set the condition of bookmark filter and order keyword.
1412  * @since_tizen 4.0
1413  */
1414 #define BOOKMARK_NAME "BOOKMARK_NAME"
1415
1416 /**
1417  * @brief Storage ID
1418  * @details You can use above define to set the condition of storage filter and order keyword.
1419  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1420  */
1421 #define MEDIA_STORAGE_ID                                        "STORAGE_ID"
1422
1423 /**
1424  * @brief Storage path
1425  * @details You can use above define to set the condition of storage filter and order keyword.
1426  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1427  */
1428 #define MEDIA_STORAGE_PATH                              "STORAGE_PATH"
1429
1430 /**
1431  * @brief Face tag
1432  * @details You can use above define to set the condition of face filter and order keyword.
1433  * @since_tizen 3.0
1434  */
1435 #define MEDIA_FACE_TAG  "MEDIA_FACE_TAG"
1436
1437 /**
1438  * @brief Face id
1439  * @details You can use above define to set the condition of face filter and order keyword.
1440  * @since_tizen 4.0
1441  */
1442 #define MEDIA_FACE_ID   "MEDIA_FACE_ID"
1443
1444 /**
1445  * @}
1446  */
1447
1448
1449 #ifdef __cplusplus
1450 }
1451 #endif /* __cplusplus */
1452
1453
1454 #endif /*__TIZEN_MEDIA_CONTENT_TYPE_H__*/