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