Tizen Native API
Thumbnail Util

Functions

int thumbnail_util_create (thumbnail_h *thumb)
 Creates thumbnail info handle.
int thumbnail_util_extract (thumbnail_h thumb, thumbnail_extracted_cb callback, void *user_data, char **request_id)
 Extracts the thumbnail for the given media, asynchronously.
int thumbnail_util_set_path (thumbnail_h thumb, const char *path)
 Sets the path of original media file.
int thumbnail_util_set_size (thumbnail_h thumb, int width, int height)
 Sets the size of thumbnail to be extracted.
int thumbnail_util_cancel (thumbnail_h thumb, const char *request_id)
 Cancels the thumbnail extraction request for the given media.
int thumbnail_util_cancel_all (thumbnail_h thumb)
 Cancels all thumbnail extraction requests associated with the given thumbnail info handle.
int thumbnail_util_destroy (thumbnail_h thumb)
 Destroys thumbnail info handle.

Typedefs

typedef struct thumbnail_s * thumbnail_h
 The structure type for the thumbnail info handle.
typedef void(* thumbnail_extracted_cb )(thumbnail_util_error_e error, const char *request_id, int thumb_width, int thumb_height, unsigned char *thumb_data, int thumb_size, void *user_data)
 Called when creating the thumbnail.

The Thumbnail Util API provides functions for creating the thumbnail from an input media file.

Required Header

#include <thumbnail_util.h>

Overview

The Thumbnail Util API allows you to create the thumbnail from a media file. To extract a thumbnail(thumbnail_util_extract()), create/destory the handle(thumbnail_util_create()/thumbnail_util_destroy). To set the path, width and height for extracting, and cancel thumbnail_util_cancel().


Typedef Documentation

typedef void(* thumbnail_extracted_cb)(thumbnail_util_error_e error, const char *request_id, int thumb_width, int thumb_height, unsigned char *thumb_data, int thumb_size, void *user_data)

Called when creating the thumbnail.

Since :
2.4
Remarks:
Color space of the generated thumbnail is BGRA.

This callback is called for completion of generating the thumbnail.

Parameters:
[in]errorThe error code
[in]request_idThe generated request id by thumbnail extraction request
[in]thumb_widthThe width of the thumbnail which is generated
[in]thumb_heightThe height of the thumbnail which is generated
[in]thumb_dataThe raw data of the thumbnail which is generated
[in]thumb_sizeThe size of the thumbnail which is generated
[in]user_dataThe user data passed from the thumbnail_util_extract() fuction
Precondition:
thumbnail_util_extract()
See also:
thumbnail_util_extract()
typedef struct thumbnail_s* thumbnail_h

The structure type for the thumbnail info handle.

Since :
2.4

Enumeration Type Documentation

Enumeration for a thumbnail util error.

Since :
2.4
Enumerator:
THUMBNAIL_UTIL_ERROR_NONE 

Successful

THUMBNAIL_UTIL_ERROR_INVALID_PARAMETER 

Invalid parameter

THUMBNAIL_UTIL_ERROR_OUT_OF_MEMORY 

Out of memory

THUMBNAIL_UTIL_ERROR_INVALID_OPERATION 

Invalid Operation

THUMBNAIL_UTIL_ERROR_FILE_NO_SPACE_ON_DEVICE 

No space left on device

THUMBNAIL_UTIL_ERROR_PERMISSION_DENIED 

Permission denied


Function Documentation

int thumbnail_util_cancel ( thumbnail_h  thumb,
const char *  request_id 
)

Cancels the thumbnail extraction request for the given media.

Since :
2.4
Remarks:
If there is no item you want to cancel, this API return MEDIA_CONTENT_ERROR_INVALID_OPERATION
Parameters:
[in]thumbThe media thumbnail info handle
[in]request_idThe generated request id by thumbnail extraction request
Returns:
0 on success, otherwise a negative error value
Return values:
THUMBNAIL_UTIL_ERROR_NONESuccessful
THUMBNAIL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
THUMBNAIL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Create a thumbnail info handle by calling thumbnail_util_create().
Postcondition:
thumbnail_util_extract()

Cancels all thumbnail extraction requests associated with the given thumbnail info handle.

Since :
2.4
Remarks:
If there is no item you want to cancel, this API return MEDIA_CONTENT_ERROR_INVALID_OPERATION
Parameters:
[in]thumbThe media thumbnail info handle
Returns:
0 on success, otherwise a negative error value
Return values:
THUMBNAIL_UTIL_ERROR_NONESuccessful
THUMBNAIL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
THUMBNAIL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Create a thumbnail info handle by calling thumbnail_util_create().
Postcondition:
thumbnail_util_extract()

Creates thumbnail info handle.

Since :
2.4
Remarks:
You must release thumb info using thumbnail_util_destroy().
Parameters:
[in]thumbThe handle to thumbnail info
Returns:
0 on success, otherwise a negative error value
Return values:
THUMBNAIL_UTIL_ERROR_NONESuccessful
THUMBNAIL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
THUMBNAIL_UTIL_ERROR_OUT_OF_MEMORYNot enough memory is available
THUMBNAIL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
See also:
thumbnail_util_destroy()

Destroys thumbnail info handle.

The function frees all resources related to the thumbnail info handle. This handle can no longer be used to perform any operation. New thumbnail info handle has to be created before the next usage.

Since :
2.4
Parameters:
[in]thumbThe thumbnail info handle
Returns:
0 on success, otherwise a negative error value
Return values:
THUMBNAIL_UTIL_ERROR_NONESuccessful
THUMBNAIL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
THUMBNAIL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Create a thumbnail info handle by calling thumbnail_util_create().
int thumbnail_util_extract ( thumbnail_h  thumb,
thumbnail_extracted_cb  callback,
void *  user_data,
char **  request_id 
)

Extracts the thumbnail for the given media, asynchronously.

This function extracts the thumbnail for given media item and calls registered callback function for completion of extracting the thumbnail.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/content.write
Remarks:
You must release request_id using free().
http://tizen.org/privilege/mediastorage is needed if input or output path are relevant to media storage.
http://tizen.org/privilege/externalstorage is needed if input or output path are relevant to external storage.
If you don't set the size, the thumbnail size will be set default size. Default size is 320x240.
Color space of the generated thumbnail is BGRA.
Parameters:
[in]thumbThe thumbnail info handle
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
[out]request_idThe request id for the thumbnail extraction request
Returns:
0 on success, otherwise a negative error value
Return values:
THUMBNAIL_UTIL_ERROR_NONESuccessful
THUMBNAIL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
THUMBNAIL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Create a thumbnail info handle by calling thumbnail_util_create().
See also:
thumbnail_util_create()
int thumbnail_util_set_path ( thumbnail_h  thumb,
const char *  path 
)

Sets the path of original media file.

Since :
2.4
Parameters:
[in]thumbThe thumbnail info handle
[in]pathThe path of the original media file
Returns:
0 on success, otherwise a negative error value
Return values:
THUMBNAIL_UTIL_ERROR_NONESuccessful
THUMBNAIL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
THUMBNAIL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
int thumbnail_util_set_size ( thumbnail_h  thumb,
int  width,
int  height 
)

Sets the size of thumbnail to be extracted.

Since :
2.4
Remarks:
If you don't set the size, the thumbnail size will be set default size. Default size is 320x240.
If the set width is not a multiple of 8, it can be changed by inner process. the width will be a multiple of 8 greater than the set value.
Parameters:
[in]thumbThe thumbnail info handle
[in]widthThe width of the thumbnail
[in]heightThe height of the thumbnail
Returns:
0 on success, otherwise a negative error value
Return values:
THUMBNAIL_UTIL_ERROR_NONESuccessful
THUMBNAIL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
THUMBNAIL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
Precondition:
Create a thumbnail info handle by calling thumbnail_util_create().
See also:
thumbnail_util_extract()