[ACR] Deprecate API that is paired with media_info_set_author
[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 (Deprecated since 4.0)*/
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  * @deprecated Deprecated since 4.0.
974  * @brief Media author
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_AUTHOR "MEDIA_AUTHOR"
980
981 /**
982  * @brief Media provider
983  * @details You can use above define to set the condition of media filter and order keyword.
984  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
985  *
986  */
987 #define MEDIA_PROVIDER "MEDIA_PROVIDER"
988
989 /**
990  * @deprecated Deprecated since 4.0.
991  * @brief Media content name
992  * @details You can use above define to set the condition of media filter and order keyword.
993  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
994  *
995  */
996 #define MEDIA_CONTENT_NAME "MEDIA_CONTENT_NAME"
997
998 /**
999  * @brief Media category
1000  * @details You can use above define to set the condition of media filter and order keyword.
1001  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1002  *
1003  */
1004 #define MEDIA_CATEGORY "MEDIA_CATEGORY"
1005
1006 /**
1007  * @brief Media location tag
1008  * @details You can use above define to set the condition of media filter and order keyword.
1009  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1010  *
1011  */
1012 #define MEDIA_LOCATION_TAG "MEDIA_LOCATION_TAG"
1013
1014 /**
1015  * @brief Media age rating
1016  * @details You can use above define to set the condition of media filter and order keyword.
1017  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1018  *
1019  */
1020 #define MEDIA_AGE_RATING "MEDIA_AGE_RATING"
1021
1022 /**
1023  * @deprecated Deprecated since 4.0.
1024  * @brief Media keyword
1025  * @details You can use above define to set the condition of media filter and order keyword.
1026  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1027  *
1028  */
1029 #define MEDIA_KEYWORD "MEDIA_KEYWORD"
1030
1031 /**
1032  * @brief Media weather
1033  * @details You can use above define to set the condition of media filter and order keyword.
1034  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1035  *
1036  */
1037 #define MEDIA_WEATHER "MEDIA_WEATHER"
1038
1039 /**
1040  * @brief Is DRM
1041  * @details There are 2 types:\n
1042  *               0-not drm, 1-drm\n
1043  *               You can use above define to set the condition of media filter and order keyword.
1044  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1045  *
1046  */
1047 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
1048
1049 /**
1050  * @brief Media storage
1051  * @details There are 2 types:\n
1052  *               0-internal storage, 1-external storage\n
1053  *               You can use above define to set the condition of media filter and order keyword.
1054  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1055  *
1056  */
1057 #define MEDIA_STORAGE_TYPE "MEDIA_STORAGE_TYPE"
1058
1059 /**
1060  * @brief Media exposure time
1061  * @details You can use above define to set the condition of media filter and order keyword.
1062  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1063  *
1064  */
1065 #define MEDIA_EXPOSURE_TIME "MEDIA_EXPOSURE_TIME"
1066
1067 /**
1068  * @brief Media fnumber
1069  * @details You can use above define to set the condition of media filter and order keyword.
1070  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1071  *
1072  */
1073 #define MEDIA_FNUMBER "MEDIA_FNUMBER"
1074
1075 /**
1076  * @brief Media ISO
1077  * @details You can use above define to set the condition of media filter and order keyword.
1078  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1079  *
1080  */
1081 #define MEDIA_ISO "MEDIA_ISO"
1082
1083 /**
1084  * @brief Media model
1085  * @details You can use above define to set the condition of media filter and order keyword.
1086  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1087  *
1088  */
1089 #define MEDIA_MODEL "MEDIA_MODEL"
1090
1091 /**
1092  * @brief Media file name pinyin
1093  * @details You can use above define to set the condition of media filter and order keyword.
1094  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1095  *
1096  */
1097 #define MEDIA_FILE_NAME_PINYIN "MEDIA_FILE_NAME_PINYIN"
1098
1099 /**
1100  * @brief Media title pinyin
1101  * @details You can use above define to set the condition of media filter and order keyword.
1102  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1103  *
1104  */
1105 #define MEDIA_TITLE_PINYIN "MEDIA_TITLE_PINYIN"
1106
1107 /**
1108  * @brief Media album pinyin
1109  * @details 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_ALBUM_PINYIN "MEDIA_ALBUM_PINYIN"
1114
1115 /**
1116  * @brief Media artist pinyin
1117  * @details You can use above define to set the condition of media filter and order keyword.
1118  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1119  *
1120  */
1121 #define MEDIA_ARTIST_PINYIN "MEDIA_ARTIST_PINYIN"
1122
1123 /**
1124  * @brief Media album artist pinyin
1125  * @details You can use above define to set the condition of media filter and order keyword.
1126  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1127  *
1128  */
1129 #define MEDIA_ALBUM_ARTIST_PINYIN "MEDIA_ALBUM_ARTIST_PINYIN"
1130
1131 /**
1132  * @brief Media genre pinyin
1133  * @details You can use above define to set the condition of media filter and order keyword.
1134  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1135  *
1136  */
1137 #define MEDIA_GENRE_PINYIN "MEDIA_GENRE_PINYIN"
1138
1139 /**
1140  * @brief Media composer pinyin
1141  * @details You can use above define to set the condition of media filter and order keyword.
1142  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1143  *
1144  */
1145 #define MEDIA_COMPOSER_PINYIN "MEDIA_COMPOSER_PINYIN"
1146
1147 /**
1148  * @brief Media copyright pinyin
1149  * @details You can use above define to set the condition of media filter and order keyword.
1150  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1151  *
1152  */
1153 #define MEDIA_COPYRIGHT_PINYIN "MEDIA_COPYRIGHT_PINYIN"
1154
1155 /**
1156  * @brief Media description pinyin
1157  * @details You can use above define to set the condition of media filter and order keyword.
1158  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1159  *
1160  */
1161 #define MEDIA_DESCRIPTION_PINYIN "MEDIA_DESCRIPTION_PINYIN"
1162
1163 /**
1164  * @deprecated Deprecated since 4.0.
1165  * @brief Media author pinyin
1166  * @details You can use above define to set the condition of media filter and order keyword.
1167  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1168  *
1169  */
1170 #define MEDIA_AUTHOR_PINYIN "MEDIA_AUTHOR_PINYIN"
1171
1172 /**
1173  * @brief Media provider pinyin
1174  * @details You can use above define to set the condition of media filter and order keyword.
1175  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1176  *
1177  */
1178 #define MEDIA_PROVIDER_PINYIN "MEDIA_PROVIDER_PINYIN"
1179
1180 /**
1181  * @deprecated Deprecated since 4.0.
1182  * @brief Media content name pinyin
1183  * @details You can use above define to set the condition of media filter and order keyword.
1184  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1185  *
1186  */
1187 #define MEDIA_CONTENT_NAME_PINYIN "MEDIA_CONTENT_NAME_PINYIN"
1188
1189 /**
1190  * @brief Media category pinyin
1191  * @details You can use above define to set the condition of media filter and order keyword.
1192  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1193  *
1194  */
1195 #define MEDIA_CATEGORY_PINYIN "MEDIA_CATEGORY_PINYIN"
1196
1197 /**
1198  * @brief Media location tag pinyin
1199  * @details You can use above define to set the condition of media filter and order keyword.
1200  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1201  *
1202  */
1203 #define MEDIA_LOCATION_TAG_PINYIN "MEDIA_LOCATION_TAG_PINYIN"
1204
1205 /**
1206  * @brief Media age rating pinyin
1207  * @details You can use above define to set the condition of media filter and order keyword.
1208  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1209  *
1210  */
1211 #define MEDIA_AGE_RATING_PINYIN "MEDIA_AGE_RATING_PINYIN"
1212
1213 /**
1214  * @deprecated Deprecated since 4.0.
1215  * @brief Media keyword pinyin
1216  * @details You can use above define to set the condition of media filter and order keyword.
1217  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1218  *
1219  */
1220 #define MEDIA_KEYWORD_PINYIN "MEDIA_KEYWORD_PINYIN"
1221
1222 /**
1223  * @brief Virtual Reality content
1224  * @details You can use above define to set the condition of media filter and order keyword.
1225  * @since_tizen 3.0
1226  *
1227  */
1228 #define MEDIA_360 "MEDIA_360"
1229
1230  /**
1231  * @brief Folder ID
1232  * @details You can use above define to set the condition of folder filter and order keyword.
1233  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1234  */
1235 #define FOLDER_ID "FOLDER_ID"
1236
1237 /**
1238  * @brief Folder full path
1239  * @details You can use above define to set the condition of folder filter and order keyword.
1240  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1241  */
1242 #define FOLDER_PATH "FOLDER_PATH"
1243
1244 /**
1245  * @brief Folder base name
1246  * @details You can use above define to set the condition of folder filter and order keyword.
1247  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1248  */
1249 #define FOLDER_NAME "FOLDER_NAME"
1250
1251 /**
1252  * @deprecated Deprecated since 4.0.
1253  * @brief Folder modified time
1254  * @details You can use above define to set the condition of folder filter and order keyword.
1255  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1256  */
1257 #define FOLDER_MODIFIED_TIME "FOLDER_MODIFIED_TIME"
1258
1259 /**
1260  * @brief Folder storage
1261  * @details There are 2 types:\n
1262  *               0-internal storage, 1-external storage\n
1263  *               You can use above define to set the condition of folder filter and order keyword.
1264  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1265  */
1266 #define FOLDER_STORAGE_TYPE "FOLDER_STORAGE_TYPE"
1267
1268 /**
1269  * @brief Folder base name pinyin
1270  * @details You can use above define to set the condition of folder filter and order keyword.
1271  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1272  */
1273 #define FOLDER_NAME_PINYIN "FOLDER_NAME_PINYIN"
1274
1275 /**
1276  * @deprecated Deprecated since 4.0.
1277  * @brief Folder order info
1278  * @details You can use above define to set the condition of folder filter and order keyword.
1279  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1280  */
1281 #define FOLDER_ORDER "FOLDER_ORDER"
1282
1283 /**
1284  * @deprecated Deprecated since 4.0.
1285  * @brief Parent folder id
1286  * @details You can use above define to set the condition of folder filter and order keyword.
1287  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1288  */
1289 #define FOLDER_PARENT_FOLDER_ID "FOLDER_PARENT_FOLDER_ID"
1290
1291 /**
1292  * @brief Playlist name
1293  * @details You can use above define to set the condition of playlist filter and order keyword.
1294  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1295  */
1296 #define PLAYLIST_NAME "PLAYLIST_NAME"
1297
1298 /**
1299  * @brief Playlist id
1300  * @details You can use above define to set the condition of playlist filter and order keyword.
1301  * @since_tizen 4.0
1302  */
1303 #define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
1304
1305 /**
1306  * @brief Playlist name
1307  * @details You can use above define to set the condition of playlist filter and order keyword.
1308  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1309  */
1310 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
1311
1312 /**
1313  * @brief Media count in playlist
1314  * @details You can use above define to set the condition of playlist filter and order keyword.
1315  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1316  */
1317 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
1318
1319 /**
1320  * @brief Tag name
1321  * @details You can use above define to set the condition of tag filter and order keyword.
1322  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1323  */
1324 #define TAG_NAME "TAG_NAME"
1325
1326 /**
1327  * @brief Tag id
1328  * @details You can use above define to set the condition of tag filter and order keyword.
1329  * @since_tizen 4.0
1330  */
1331 #define MEDIA_TAG_ID "TAG_ID"
1332
1333 /**
1334  * @brief Media count in tag
1335  * @details You can use above define to set the condition of tag filter and order keyword.
1336  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1337  */
1338 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
1339
1340 /**
1341  * @brief Bookmark marked time
1342  * @details You can use above define to set the condition of bookmark filter and order keyword.
1343  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1344  */
1345 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
1346
1347 /**
1348  * @brief Bookmark id
1349  * @details You can use above define to set the condition of bookmark filter and order keyword.
1350  * @since_tizen 4.0
1351  */
1352 #define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
1353
1354 /**
1355  * @brief Bookmark name
1356  * @details You can use above define to set the condition of bookmark filter and order keyword.
1357  * @since_tizen 4.0
1358  */
1359 #define BOOKMARK_NAME "BOOKMARK_NAME"
1360
1361 /**
1362  * @brief Storage ID
1363  * @details You can use above define to set the condition of storage filter and order keyword.
1364  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1365  */
1366 #define MEDIA_STORAGE_ID                                        "STORAGE_ID"
1367
1368 /**
1369  * @brief Storage path
1370  * @details You can use above define to set the condition of storage filter and order keyword.
1371  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1372  */
1373 #define MEDIA_STORAGE_PATH                              "STORAGE_PATH"
1374
1375 /**
1376  * @brief Face tag
1377  * @details You can use above define to set the condition of face filter and order keyword.
1378  * @since_tizen 3.0
1379  */
1380 #define MEDIA_FACE_TAG  "MEDIA_FACE_TAG"
1381
1382 /**
1383  * @brief Face id
1384  * @details You can use above define to set the condition of face filter and order keyword.
1385  * @since_tizen 4.0
1386  */
1387 #define MEDIA_FACE_ID   "MEDIA_FACE_ID"
1388
1389 /**
1390  * @}
1391  */
1392
1393
1394 #ifdef __cplusplus
1395 }
1396 #endif /* __cplusplus */
1397
1398
1399 #endif /*__TIZEN_MEDIA_CONTENT_TYPE_H__*/