From 93f48c048a8ea5114c6fe51db89b83c3666a5125 Mon Sep 17 00:00:00 2001 From: Minje Ahn Date: Thu, 22 Oct 2015 18:14:39 +0900 Subject: [PATCH] [ACR-441] Modify thumbnail creation policy Change-Id: I4ef731dad3bb8a57ab3b4bc0e35d186699995b52 Signed-off-by: Minje Ahn --- doc/media_content_doc.h | 6 +++--- include/media_info.h | 7 +++++-- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/doc/media_content_doc.h b/doc/media_content_doc.h index 58424c4..9c0b155 100755 --- a/doc/media_content_doc.h +++ b/doc/media_content_doc.h @@ -31,9 +31,9 @@ * The Media Content API provides functions and enumerations used in the entire Content Service.\n * The information about media items i.e. image, audio and video, are managed in the content database and * operations that involve database requires an active connection with the media content service.\n - * During media scanning, Media Service extract media information automatically. media information include basic file info like - * path, size, modified time etc and some metadata like ID3tag, EXIF, thumbnail, face detection info, etc. (thumbnail extracted only in Internal and SD card storage. \n - * Also, face detection only works when the device supports face recignition feature (i.e., http://tizen.org/feature/vision.face_recognition)). \n + * During media scanning, Media Service extract media information automatically. media information include basic file info like + * path, size, modified time etc and some metadata like ID3tag, EXIF, thumbnail, etc. (thumbnail extracted only in Internal and SD card storage.) \n + * Since 3.0, a thumbnail is not automatically extracted during media scanning. A thumbnail will be created only when media_info_create_thumbnail() is called by any application. \n * Media content services do not manage hidden files. \n * The API provides functions for connecting (#media_content_connect()) and disconnecting (#media_content_disconnect()) from the media content service. * diff --git a/include/media_info.h b/include/media_info.h index 1d3f1e3..ed97e86 100755 --- a/include/media_info.h +++ b/include/media_info.h @@ -1569,14 +1569,17 @@ int media_info_move_to_db(media_info_h media, const char* dst_path); /** * @brief Creates a thumbnail image for the given media, asynchronously. * @details This function creates an thumbnail image for given media item and calls registered callback function for completion of creating the thumbnail. - * If a thumbnail already exists for the given media, then the path of thumbnail will be returned in callback function. + * If a thumbnail already exists for the given media, then the path of thumbnail will be returned in callback function. \n + * Since 3.0, a thumbnail is not automatically extracted during media scanning. \n + * Therefore, if there exists no thumbnail for the given media, you MUST call this function to create a thumbnail. * * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * * @privlevel public * @privilege %http://tizen.org/privilege/content.write * - * @remarks If you want to destory media handle before callback invoked, you must cancel thumbnail request by using media_info_cancel_thumbnail() + * @remarks If you want to destory media handle before callback invoked, you must cancel thumbnail request by using media_info_cancel_thumbnail() \n + * Since 3.0, if creation of a thumbnail is failed, empty string will be passed through media_thumbnail_completed_cb(). * * @param[in] media The media info handle * @param[in] callback The callback function to be invoked -- 2.7.4