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 #ifndef DEPRECATED_API
  30 #define DEPRECATED_API __attribute__ ((deprecated))
  31 #endif
  32
  33 /**
  34  * @file media_content_type.h
  35  * @brief This file contains API related to media-content enumerations for media data types, groups, orientations, \n
  36  *        classes of errors and definitions of media-data. \n
  37  *        Listed APIs are called when iterating over lists of album, group, bookmark and other media,  \n
  38  *        when media items and burst shot are inserted completely and when notification of media DB change is subscribed.
  39  */
  40
  41 /**
  42 * @addtogroup CAPI_MEDIA_CONTENT_MODULE
  43  * @{
  44  */
  45
  46 /**
  47  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  48  * @brief Enumeration for the media file format.
  49  */
  50 typedef enum
  51 {
  52     MEDIA_CONTENT_TYPE_IMAGE   = 0,  /**<The type of an image */
  53     MEDIA_CONTENT_TYPE_VIDEO   = 1,  /**<The type of a video */
  54     MEDIA_CONTENT_TYPE_SOUND   = 2,  /**<The type of sound */
  55     MEDIA_CONTENT_TYPE_MUSIC   = 3,  /**<The type of music */
  56     MEDIA_CONTENT_TYPE_OTHERS  = 4,  /**<The type of other */
  57 } media_content_type_e;
  58
  59 /**
  60  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
  61  * @brief Enumeration for the storage type.
  62  * @details This information is used to establish where the folder is.
  63  */
  64 typedef enum
  65 {
  66         MEDIA_CONTENT_STORAGE_INTERNAL  = 0,  /**< The device's internal storage */
  67         MEDIA_CONTENT_STORAGE_EXTERNAL  = 1,  /**< The device's external storage */
  68         MEDIA_CONTENT_STORAGE_CLOUD     = 100,  /**< The Cloud storage */
  69 } media_content_storage_e;
  70
  71 /**
  72  * @ingroup CAPI_MEDIA_CONTENT_MODULE
  73  * @brief Enumeration for media content DB update items.
  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  */
  84 typedef enum {
  85     MEDIA_CONTENT_INSERT  = 0,              /**< Insert, the type of DB update */
  86     MEDIA_CONTENT_DELETE  = 1,              /**< Delete, The type of DB update */
  87     MEDIA_CONTENT_UPDATE  = 2,              /**< Update, The type of DB update */
  88 } media_content_db_update_type_e;
  89
  90 /**
  91  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  92  * @brief Enumeration for orientation types.
  93  */
  94 typedef enum {
  95     MEDIA_CONTENT_ORIENTATION_NOT_AVAILABLE  = 0,       /**< Not available*/
  96     MEDIA_CONTENT_ORIENTATION_NORMAL         = 1,       /**< Normal*/
  97     MEDIA_CONTENT_ORIENTATION_HFLIP          = 2,       /**< Flip horizontal*/
  98     MEDIA_CONTENT_ORIENTATION_ROT_180        = 3,       /**< Rotate 180 degrees*/
  99     MEDIA_CONTENT_ORIENTATION_VFLIP          = 4,       /**< Flip vertical*/
 100     MEDIA_CONTENT_ORIENTATION_TRANSPOSE      = 5,       /**< Transpose*/
 101     MEDIA_CONTENT_ORIENTATION_ROT_90         = 6,       /**< Rotate 90 degrees*/
 102     MEDIA_CONTENT_ORIENTATION_TRANSVERSE     = 7,       /**< Transverse*/
 103     MEDIA_CONTENT_ORIENTATION_ROT_270        = 8,       /**< Rotate 270 degrees*/
 104 } media_content_orientation_e;
 105
 106 /**
 107  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 108  * @brief Enumeration for ordering.
 109  */
 110 typedef enum
 111 {
 112     MEDIA_CONTENT_ORDER_ASC   = 0,      /**< Ascending order*/
 113     MEDIA_CONTENT_ORDER_DESC  = 1,      /**< Descending order*/
 114 } media_content_order_e;
 115
 116 /**
 117  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 118  * @brief Enumeration for collations.
 119  */
 120 typedef enum
 121 {
 122     MEDIA_CONTENT_COLLATE_DEFAULT   = 0,        /**< Default collation BINARY */
 123     MEDIA_CONTENT_COLLATE_NOCASE    = 1,        /**< Collation NOCASE, not case sensitive */
 124     MEDIA_CONTENT_COLLATE_RTRIM     = 2,        /**< Collation RTRIM, trailing space characters are ignored */
 125     MEDIA_CONTENT_COLLATE_LOCALIZED = 3,        /**< Collation LOCALIZATION, NOCASE also applied */
 126 } media_content_collation_e;
 127
 128 #define MEDIA_CONTENT_ERROR_CLASS                               TIZEN_ERROR_MEDIA_CONTENT
 129
 130 /**
 131  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 132  * @brief Enumeration for a media content error.
 133  */
 134  typedef enum
 135 {
 136     MEDIA_CONTENT_ERROR_NONE                    = TIZEN_ERROR_NONE,                    /**< Successful */
 137     MEDIA_CONTENT_ERROR_INVALID_PARAMETER       = TIZEN_ERROR_INVALID_PARAMETER,       /**< Invalid parameter */
 138     MEDIA_CONTENT_ERROR_OUT_OF_MEMORY           = TIZEN_ERROR_OUT_OF_MEMORY,           /**< Out of memory */
 139     MEDIA_CONTENT_ERROR_INVALID_OPERATION       = TIZEN_ERROR_INVALID_OPERATION,       /**< Invalid Operation */
 140     MEDIA_CONTENT_FILE_NO_SPACE_ON_DEVICE       = TIZEN_ERROR_FILE_NO_SPACE_ON_DEVICE, /**< No space left on device */
 141     MEDIA_CONTENT_ERROR_PERMISSION_DENIED                 = TIZEN_ERROR_PERMISSION_DENIED,                /**< Permission denied */
 142     MEDIA_CONTENT_ERROR_DB_FAILED               = MEDIA_CONTENT_ERROR_CLASS | 0x01,    /**< DB operation failed */
 143     MEDIA_CONTENT_ERROR_DB_BUSY                 = MEDIA_CONTENT_ERROR_CLASS | 0x02,    /**< DB operation BUSY */
 144     MEDIA_CONTENT_ERROR_NETWORK                 = MEDIA_CONTENT_ERROR_CLASS | 0x03,    /**< Network Fail */
 145     MEDIA_CONTENT_ERROR_UNSUPPORTED_CONTENT     = MEDIA_CONTENT_ERROR_CLASS | 0x04,    /**< Unsupported Content */
 146 } media_content_error_e;
 147
 148 /**
 149  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 150  * @brief Enumeration for a media group.
 151  */
 152 typedef enum {
 153     MEDIA_CONTENT_GROUP_DISPLAY_NAME = 0,    /**< Media group ID for display name */
 154     MEDIA_CONTENT_GROUP_TYPE,                /**< Media group ID for a media type */
 155     MEDIA_CONTENT_GROUP_MIME_TYPE,           /**< Media group ID for a mime type */
 156     MEDIA_CONTENT_GROUP_SIZE,                /**< Media group ID for content size */
 157     MEDIA_CONTENT_GROUP_ADDED_TIME,          /**< Media group ID for the added time */
 158     MEDIA_CONTENT_GROUP_MODIFIED_TIME,       /**< Media group ID for the modified time */
 159     MEDIA_CONTENT_GROUP_TITLE,               /**< Media group ID for a content title */
 160     MEDIA_CONTENT_GROUP_ARTIST,              /**< Media group ID for an artist*/
 161     MEDIA_CONTENT_GROUP_ALBUM_ARTIST,        /**< Media group ID for an album artist */
 162     MEDIA_CONTENT_GROUP_GENRE,               /**< Media group ID for a genre*/
 163     MEDIA_CONTENT_GROUP_COMPOSER,            /**< Media group ID for a composer*/
 164     MEDIA_CONTENT_GROUP_YEAR,                /**< Media group ID for a year*/
 165     MEDIA_CONTENT_GROUP_RECORDED_DATE,       /**< Media group ID for the recorded date*/
 166     MEDIA_CONTENT_GROUP_COPYRIGHT,           /**< Media group ID for the copyright*/
 167     MEDIA_CONTENT_GROUP_TRACK_NUM,           /**< Media group ID for a track number*/
 168     MEDIA_CONTENT_GROUP_DESCRIPTION,         /**< Media group ID for a description */
 169     MEDIA_CONTENT_GROUP_LONGITUDE,           /**< Media group ID for the longitude*/
 170     MEDIA_CONTENT_GROUP_LATITUDE,            /**< Media group ID for the latitude*/
 171     MEDIA_CONTENT_GROUP_ALTITUDE,            /**< Media group ID for the altitude*/
 172     MEDIA_CONTENT_GROUP_BURST_IMAGE,         /**< Media group ID for the burst shot*/
 173     MEDIA_CONTENT_GROUP_RATING,              /**< Media group ID for a rating*/
 174     MEDIA_CONTENT_GROUP_AUTHOR,              /**< Media group ID for an author*/
 175     MEDIA_CONTENT_GROUP_PROVIDER,            /**< Media group ID for a provider*/
 176     MEDIA_CONTENT_GROUP_CONTENT_NAME,        /**< Media group ID for the content name*/
 177     MEDIA_CONTENT_GROUP_CATEGORY,            /**< Media group ID for a category*/
 178     MEDIA_CONTENT_GROUP_LOCATION_TAG,        /**< Media group ID for a location tag*/
 179     MEDIA_CONTENT_GROUP_AGE_RATING,          /**< Media group ID for an age rating*/
 180     MEDIA_CONTENT_GROUP_KEYWORD,             /**< Media group ID for a keyword*/
 181     MEDIA_CONTENT_GROUP_WEATHER,             /**< Media group ID for the weather*/
 182     MEDIA_CONTENT_GROUP_MAX                  /**< Max count of the media group ID */
 183 } media_group_e;
 184
 185 /**
 186  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 187  * @brief The structure type for the Media info handle.
 188  */
 189 typedef struct media_info_s *media_info_h;
 190
 191 /**
 192  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 193  * @brief The structure type for the Media folder handle.
 194  */
 195 typedef struct media_folder_s *media_folder_h;
 196
 197 /**
 198  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 199  * @brief The structure type for the Media playlist handle.
 200  */
 201 typedef struct media_playlist_s *media_playlist_h;
 202
 203 /**
 204  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 205  * @brief The structure type for the Media tag handle.
 206  */
 207 typedef struct media_tag_s *media_tag_h;
 208
 209 /**
 210  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 211  * @brief The structure type for the Media bookmark handle.
 212  */
 213 typedef struct media_bookmark_s *media_bookmark_h;
 214
 215 /**
 216  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 217  * @brief The structure type for the Media album handle.
 218  */
 219 typedef struct media_album_s *media_album_h;
 220
 221 /**
 222  * @ingroup CAPI_CONTENT_MEDIA_IMAGE_MODULE
 223  * @brief The structure type for the Image metadata handle.
 224  */
 225 typedef struct image_meta_s *image_meta_h;
 226
 227 /**
 228  * @ingroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE
 229  * @brief The structure type for the Video metadata handle.
 230  */
 231 typedef struct video_meta_s *video_meta_h;
 232
 233 /**
 234  * @ingroup CAPI_CONTENT_MEDIA_AUDIO_META_MODULE
 235  * @brief The structure type for the Audio metadata handle.
 236  */
 237 typedef struct audio_meta_s *audio_meta_h;
 238
 239 /**
 240  * @ingroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 241  * @brief The structure type for the Media filter handle.
 242  */
 243 typedef struct filter_s *filter_h;
 244
 245 /**
 246  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 247  * @brief The structure type for the Media storage handle.
 248  * @since_tizen 2.4
 249  */
 250 typedef void *media_storage_h;
 251
 252 /**
 253  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 254  * @brief Called when the media scanning is finished.
 255  *
 256  * @param[in] error     The error code
 257  * @param[in] user_data The user data passed from the foreach function
 258  *
 259  * @pre media_content_scan().
 260  *
 261  * @see media_content_scan()
 262  *
 263  */
 264 typedef void (*media_scan_completed_cb)(media_content_error_e error, void * user_data);
 265
 266 /**
 267  * @ingroup CAPI_MEDIA_CONTENT_MODULE
 268  * @brief Called when the notification of the media DB change is subscribed.
 269  *
 270  * @param[in] error       The error code
 271  * @param[in] pid         The PID which publishes notification
 272  * @param[in] update_item The update item of notification
 273  * @param[in] update_type The update type of notification
 274  * @param[in] media_type  The type of the media content (#media_content_type_e)
 275  * @param[in] uuid        The UUID of media or directory, which is updated
 276  * @param[in] path        The path of the media or directory
 277  * @param[in] mime_type   The mime type of the media info
 278  * @param[in] user_data   The user data passed from the foreach function
 279  *
 280  * @pre media_content_db_update_subscribe().
 281  * @see media_content_db_update_subscribe()
 282  */
 283 typedef void (*media_content_db_update_cb)(
 284                                     media_content_error_e error,
 285                                     int pid,
 286                                     media_content_db_update_item_type_e update_item,
 287                                     media_content_db_update_type_e update_type,
 288                                     media_content_type_e media_type,
 289                                     char *uuid,
 290                                     char *path,
 291                                     char *mime_type,
 292                                     void *user_data);
 293
 294
 295 /**
 296  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 297  * @brief Called for every available media info.
 298  *
 299  * @details Iterates over a list of media info.
 300  *
 301  * @remarks To use the @a media outside this function, copy the handle with media_info_clone() function.
 302  *
 303  * @param[in] media     The handle to the media info
 304  * @param[in] user_data The user data passed from the foreach function
 305  *
 306  * @return @c true to continue with the next iteration of the loop,
 307  *         otherwise @c false to break out of the loop
 308  *
 309  * @pre media_tag_foreach_media_from_db(), media_playlist_foreach_media_from_db(), media_genre_foreach_media_from_db(),
 310  *      media_info_foreach_media_from_db(), media_folder_foreach_media_from_db() will invoke this function.
 311  *
 312  * @see media_info_clone()
 313  * @see media_album_foreach_media_from_db()
 314  * @see media_playlist_foreach_media_from_db()
 315  * @see media_tag_foreach_media_from_db()
 316  * @see media_info_foreach_media_from_db()
 317  * @see media_folder_foreach_media_from_db()
 318  */
 319 typedef bool (*media_info_cb)(media_info_h media, void *user_data);
 320
 321
 322 /**
 323  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 324  * @brief Called when media items are inserted completely.
 325  *
 326  * @param[in] media     The handle to the media info
 327  * @param[in] user_data The user data passed from the foreach function
 328  *
 329  * @pre media_info_insert_batch_to_db()
 330  *
 331  * @see media_info_insert_batch_to_db()
 332  */
 333 typedef void (*media_insert_completed_cb)(media_content_error_e error, void * user_data);
 334
 335
 336 /**
 337  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 338  * @brief Called when the burst shot is inserted completely.
 339  *
 340  * @param[in] media     The handle to the media info
 341  * @param[in] user_data The user data passed from the foreach function
 342  *
 343  * @pre media_info_insert_burst_shot_to_db()
 344  *
 345  * @see media_info_insert_burst_shot_to_db()
 346  *
 347  */
 348 typedef void (*media_insert_burst_shot_completed_cb)(media_content_error_e error, void * user_data);
 349
 350
 351 /**
 352  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
 353  * @brief Called when creating a thumbnail image.
 354  *
 355  * @details This callback is called for completion of generating the thumbnail image.
 356  *
 357  * @param[in] error     The error code
 358  * @param[in] path      The path of the thumbnail which is generated
 359  * @param[in] user_data The user data passed from the foreach function
 360  *
 361  * @pre media_info_create_thumbnail()
 362  *
 363  * @see media_info_create_thumbnail()
 364  */
 365 typedef void (*media_thumbnail_completed_cb)(media_content_error_e error, const char *path, void *user_data);
 366
 367
 368 /**
 369  * @ingroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 370  * @brief Called for every available media folder.
 371  *
 372  * @details Iterates over a list of folders.
 373  *
 374  * @remarks To use the @a folder outside this function, copy the handle with the media_folder_clone() function.
 375  *
 376  * @param[in] folder    The handle to the media folder
 377  * @param[in] user_data The user data passed from the foreach function
 378  *
 379  * @return @c true to continue with the next iteration of the loop,
 380  *         otherwise @c false to break out of the loop
 381  *
 382  * @pre media_folder_foreach_folder_from_db() will invoke this function.
 383  * @see media_folder_clone()
 384  * @see media_folder_foreach_folder_from_db()
 385  */
 386 typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 387
 388 /**
 389  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 390  * @brief Called for every playlist in the obtained list of playlists.
 391  *
 392  * @details Iterates over a playlist list.
 393  *
 394  * @remarks To use the @a playlist outside this function, copy the handle with the media_playlist_clone() function.
 395  *
 396  * @param[in] playlist  The handle to the media playlist
 397  * @param[in] user_data The user data passed from the foreach function
 398  *
 399  * @return @c true to continue with the next iteration of the loop,
 400  *         otherwise @c false to break out of the loop
 401  *
 402  * @pre media_playlist_foreach_playlist_from_db() will invoke this function.
 403  *
 404  * @see media_playlist_clone()
 405  * @see media_playlist_foreach_playlist_from_db()
 406  */
 407 typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 408
 409 /**
 410  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 411  * @brief Called for every media info with playlist member ID in the obtained list of media info.
 412  *
 413  * @details Iterates over playlist members.
 414  *
 415  * @remarks To use the @a media outside this function, copy the handle with the media_info_clone() function.
 416  *
 417  * @param[in] playlist_member_id The ID to member of the playlist
 418  * @param[in] media              The handle to the media info
 419  * @param[in] user_data          The user data passed from the foreach function
 420  *
 421  * @return @c true to continue with the next iteration of the loop,
 422  *         otherwise @c false to break out of the loop
 423  *
 424  * @pre media_playlist_foreach_media_from_db() will invoke this function.
 425  *
 426  * @see media_info_clone()
 427  * @see media_playlist_foreach_media_from_db()
 428  */
 429 typedef bool(* playlist_member_cb)(int playlist_member_id, media_info_h media, void *user_data);
 430
 431 /**
 432  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
 433  * @brief Called for every tag in the obtained list of tags.
 434  *
 435  * @details Iterates over a list of tags.
 436  *
 437  * @remarks To use the @a tag outside this function, copy the handle with the media_tag_clone() function.
 438  *
 439  * @param[in] tag       The handle to the media tag
 440  * @param[in] user_data The user data passed from the foreach function
 441  *
 442  * @return @c true to continue with the next iteration of the loop,
 443  *         otherwise @c false to break out of the loop
 444  *
 445  * @pre media_tag_foreach_tag_from_db(), media_info_foreach_tag_from_db() will invoke this function.
 446  *
 447  * @see media_tag_clone()
 448  * @see media_tag_foreach_tag_from_db()
 449  * @see media_info_foreach_tag_from_db()
 450  */
 451 typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
 452
 453 /**
 454  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 455  * @brief Called for every bookmark in the obtained list of bookmarks.
 456  *
 457  * @details Iterates over a bookmark list.
 458  *
 459  * @remarks To use the @a bookmark outside this function, copy the handle with the media_bookmark_clone() function.
 460  *
 461  * @param[in] bookmark  The handle to the video bookmark
 462  * @param[in] user_data The user data passed from the foreach function
 463  *
 464  * @return @c true to continue with the next iteration of the loop,
 465  *         otherwise @c false to break out of the loop
 466  *
 467  * @pre media_info_foreach_bookmark_from_db() will invoke this function.
 468  *
 469  * @see media_info_foreach_bookmark_from_db()
 470  */
 471 typedef bool (*media_bookmark_cb)(media_bookmark_h bookmark, void *user_data);
 472
 473 /**
 474  * @ingroup CAPI_CONTENT_MEDIA_ALBUM_MODULE
 475  * @brief Called for every album in the obtained list of groups.
 476  *
 477  * @details Iterates over an album list.
 478  *
 479  * @remarks To use the @a album outside this function, copy the handle with the media_album_clone() function.
 480  *
 481  * @param[in] album     The handle to the media album
 482  * @param[in] user_data The user data passed from the foreach function
 483  *
 484  * @return @c true to continue with the next iteration of the loop,
 485  *         otherwise @c false to break out of the loop
 486  *
 487  * @pre media_album_foreach_album_from_db() will invoke this function.
 488  *
 489  * @see media_album_clone()
 490  * @see media_album_foreach_album_from_db()
 491  */
 492 typedef bool (*media_album_cb)(media_album_h album, void *user_data);
 493
 494 /**
 495  * @ingroup CAPI_CONTENT_MEDIA_GROUP_MODULE
 496  * @brief Called for every group in the obtained list of groups.
 497  *
 498  * @details Iterates over a media group list.
 499  *
 500  * @remarks You should not free @a group_name returned by this function.
 501  *
 502  * @param[in] group_name The name of the media group
 503  * @param[in] user_data  The user data passed from the foreach function
 504  *
 505  * @return @c true to continue with the next iteration of the loop,
 506  *         otherwise @c false to break out of the loop
 507  *
 508  * @pre media_group_foreach_group_from_db() will invoke this function.
 509  *
 510  * @see media_group_foreach_group_from_db()
 511  */
 512 typedef bool (*media_group_cb)(const char *group_name, void *user_data);
 513
 514 /**
 515  * @ingroup CAPI_CONTENT_MEDIA_STORAGE_MODULE
 516  * @brief Called for every storage in the obtained list of storages.
 517  * @since_tizen 2.4
 518  *
 519  * @details Iterates over a media storage list.
 520  *
 521  * @remarks You should not destroy @a storage returned by this function.
 522  *
 523  * @param[in] storage     The handle of the media storage
 524  * @param[in] user_data  The user data passed from the foreach function
 525  *
 526  * @return @c true to continue with the next iteration of the loop,
 527  *         otherwise @c false to break out of the loop
 528  *
 529  * @pre media_storage_foreach_storage_from_db() will invoke this function.
 530  *
 531  * @see media_storage_foreach_storage_from_db()
 532  */
 533 typedef bool (*media_storage_cb)(media_storage_h storage, void *user_data);
 534
 535 /**
 536  * @}
 537  */
 538
 539 /**
 540  * @addtogroup CAPI_CONTENT_MEDIA_FILTER_MODULE
 541  * @{
 542  * @brief You can use above defines to set the condition of media filter and order keyword.
 543  *
 544  */
 545 #define MEDIA_ID "MEDIA_ID" /**< Media ID */
 546 #define MEDIA_PATH "MEDIA_PATH"  /**< Media full path */
 547 #define MEDIA_DISPLAY_NAME "MEDIA_DISPLAY_NAME"  /**< Media base name */
 548 #define MEDIA_TYPE "MEDIA_TYPE"  /**< Media type: 0-image, 1-video, 2-sound, 3-music, 4-other*/
 549 #define MEDIA_MIME_TYPE "MEDIA_MIME_TYPE"  /**< Media MIME type */
 550 #define MEDIA_SIZE "MEDIA_SIZE"  /**< Media MIME size */
 551 #define MEDIA_ADDED_TIME "MEDIA_ADDED_TIME"  /**< Media added time */
 552 #define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"  /**< Media modified time */
 553 #define MEDIA_TIMELINE "MEDIA_TIMELINE"  /**< Media modified time */
 554 #define MEDIA_THUMBNAIL_PATH "MEDIA_THUMBNAIL_PATH"  /**< Media thumbnail path */
 555 #define MEDIA_TITLE "MEDIA_TITLE"  /**< Media title get from tag or file name */
 556 #define MEDIA_ALBUM "MEDIA_ALBUM"  /**< Media album name*/
 557 #define MEDIA_ARTIST "MEDIA_ARTIST"  /**< Media artist*/
 558 #define MEDIA_ALBUM_ARTIST "MEDIA_ALBUM_ARTIST"  /**< Media album_artist*/
 559 #define MEDIA_GENRE "MEDIA_GENRE"  /**< Media genre*/
 560 #define MEDIA_COMPOSER "MEDIA_COMPOSER"  /**< Media composer*/
 561 #define MEDIA_YEAR "MEDIA_YEAR"  /**< Media year*/
 562 #define MEDIA_RECORDED_DATE "MEDIA_RECORDED_DATE"  /**< Media recorded date*/
 563 #define MEDIA_COPYRIGHT "MEDIA_COPYRIGHT"  /**< Media copyright*/
 564 #define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"  /**< Media track number*/
 565 #define MEDIA_DESCRIPTION "MEDIA_DESCRIPTION"  /**< Media description*/
 566 #define MEDIA_BITRATE "MEDIA_BITRATE"  /**< Media bitrate*/
 567 #define MEDIA_BITPERSAMPLE "MEDIA_BITPERSAMPLE"  /**< Media bit per sample*/
 568 #define MEDIA_SAMPLERATE "MEDIA_SAMPLERATE"  /**< Media sample rate*/
 569 #define MEDIA_CHANNEL "MEDIA_CHANNEL"  /**< Media channel*/
 570 #define MEDIA_DURATION "MEDIA_DURATION"  /**< Media duration */
 571 #define MEDIA_LONGITUDE "MEDIA_LONGITUDE"  /**< Media longitude */
 572 #define MEDIA_LATITUDE "MEDIA_LATITUDE"  /**< Media latitude */
 573 #define MEDIA_ALTITUDE "MEDIA_ALTITUDE"  /**< Media altitude */
 574 #define MEDIA_WIDTH "MEDIA_WIDTH"  /**< Media width*/
 575 #define MEDIA_HEIGHT "MEDIA_HEIGHT"  /**< Media height*/
 576 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"  /**< Media datetaken*/
 577 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"  /**< Media orientation*/
 578 #define MEDIA_BURST_ID "BURST_ID"  /**< Media burst ID*/
 579 #define MEDIA_PLAYED_COUNT "MEDIA_PLAYED_COUNT"  /**< Media playedcount*/
 580 #define MEDIA_LAST_PLAYED_TIME "MEDIA_LAST_PLAYED_TIME"  /**< Media last played time*/
 581 #define MEDIA_LAST_PLAYED_POSITION "MEDIA_LAST_PLAYED_POSITION"  /**< Media last played position of file*/
 582 #define MEDIA_RATING "MEDIA_RATING"  /**< Media rating*/
 583 #define MEDIA_FAVOURITE "MEDIA_FAVOURITE"  /**< 0-not favourite, 1-favourite*/
 584 #define MEDIA_AUTHOR "MEDIA_AUTHOR"  /**< Media authore*/
 585 #define MEDIA_PROVIDER "MEDIA_PROVIDER"  /**< Media provider*/
 586 #define MEDIA_CONTENT_NAME "MEDIA_CONTENT_NAME"  /**< Media content name*/
 587 #define MEDIA_CATEGORY "MEDIA_CATEGORY"  /**< Media category*/
 588 #define MEDIA_LOCATION_TAG "MEDIA_LOCATION_TAG"  /**< Media location tag*/
 589 #define MEDIA_AGE_RATING "MEDIA_AGE_RATING"  /**< Media age rating*/
 590 #define MEDIA_KEYWORD "MEDIA_KEYWORD"  /**< Media keyword*/
 591 #define MEDIA_WEATHER "MEDIA_WEATHER"  /**< Media weather*/
 592 #define MEDIA_IS_DRM "MEDIA_IS_DRM"  /**< Is DRM. 0-not drm, 1-drm*/
 593 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"  /**< Media storage. 0-internal storage, 1-external storage*/
 594 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"       /**< media exposure_time*/
 595 #define MEDIA_FNUMBER "MEDIA_FNUMBER"   /**< media fnumber*/
 596 #define MEDIA_ISO "MEDIA_ISO"   /**< media iso*/
 597 #define MEDIA_MODEL "MEDIA_MODEL"       /**< media model*/
 598
 599 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"  /**< Media file name pinyin */
 600 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"  /**< Media title pinyin */
 601 #define MEDIA_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"  /**< Media album pinyin*/
 602 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"  /**< Media artist pinyin*/
 603 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"  /**< Media album_artist pinyin*/
 604 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"  /**< Media genre pinyin*/
 605 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"  /**< Media composer pinyin*/
 606 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"  /**< Media copyright pinyin*/
 607 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"  /**< Media description pinyin*/
 608 #define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"  /**< Media authore pinyin*/
 609 #define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"  /**< Media provider pinyin*/
 610 #define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"  /**< Media content name pinyin*/
 611 #define MEDIA_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"  /**< Media category pinyin*/
 612 #define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"  /**< Media location tag pinyin*/
 613 #define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"  /**< Media age rating pinyin*/
 614 #define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"  /**< Media keyword pinyin*/
 615
 616 /**
 617  * @}
 618  */
 619
 620
 621 /**
 622
 623  * @addtogroup CAPI_CONTENT_MEDIA_FOLDER_MODULE
 624  * @{
 625  */
 626 #define FOLDER_ID "FOLDER_ID"  /**< Folder ID */
 627 #define FOLDER_PATH "FOLDER_PATH"  /**< Folder full path */
 628 #define FOLDER_NAME "FOLDER_NAME"  /**< Folder base name */
 629 #define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"  /**< Folder modified time */
 630 #define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"  /**< Folder storage. 0-internal storage, 1-external storage*/
 631 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"  /**< Folder base name pinyin*/
 632 #define FOLDER_ORDER "FOLDER_ORDER"  /**< Folder order info */
 633
 634 /**
 635  * @}
 636  */
 637
 638 /**
 639  * @addtogroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
 640  * @{
 641  */
 642 #define PLAYLIST_NAME "PLAYLIST_NAME"  /**< Playlist name */
 643 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"  /**< Playlist name */
 644 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"  /**< Media count in playlist view */
 645
 646 /**
 647  * @}
 648  */
 649
 650 /**
 651  * @addtogroup CAPI_CONTENT_MEDIA_TAG_MODULE
 652  * @{
 653  */
 654 #define TAG_NAME "TAG_NAME"  /**< Tag name */
 655 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"  /**< Media count in tag view */
 656
 657 /**
 658  * @}
 659  */
 660
 661 /**
 662  * @addtogroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
 663  * @{
 664  */
 665 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"  /**< Bookmark marked time */
 666
 667 /**
 668  * @}
 669  */
 670
 671 #ifdef __cplusplus
 672 }
 673 #endif /* __cplusplus */
 674
 675
 676 #endif /*__TIZEN_MEDIA_CONTENT_TYPE_H__*/