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