From: Minje Ahn Date: Thu, 22 Oct 2015 09:14:39 +0000 (+0900) Subject: [ACR-441] Modify thumbnail creation policy X-Git-Tag: accepted/tizen/mobile/20151102.055333^0 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=refs%2Fchanges%2F84%2F49984%2F7;p=platform%2Fcore%2Fapi%2Fmedia-content.git [ACR-441] Modify thumbnail creation policy Change-Id: I4ef731dad3bb8a57ab3b4bc0e35d186699995b52 Signed-off-by: Minje Ahn --- 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