Tizen Native API
5.0
|
![thumb_inheritance_tree.png](thumb_inheritance_tree.png)
A thumbnail object is used for displaying the thumbnail of an image or video. You must have compiled Elementary with Ethumb_Client
support. Also, Ethumb's DBus service must be present and auto-activated in order to have thumbnails generated. You must also have a session bus, not a system one.
Once the thumbnail object becomes visible, it will check if there is a previously generated thumbnail image for the file set on it. If not, it will start generating this thumbnail.
Different configuration settings will cause different thumbnails to be generated even on the same file.
Generated thumbnails are stored under $HOME/
.thumbnails/. Check Ethumb's documentation to change this path, and to see other configuration options.
If you set formatting features such as, aspect, size, format, orientation, crop, compression, or quality after the thumbnail has been shown, it needs to be reloaded with elm_thumb_reload.
This widget emits the following signals:
"clicked"
- This is called when a user has clicked the thumbnail object without dragging it around."clicked,double"
- This is called when a user has double-clicked the thumbnail object."press"
- This is called when a user has pressed down over the thumbnail object."generate,start"
- The thumbnail generation has started."generate,stop"
- The generation process has stopped."generate,error"
- The thumbnail generation failed."load,error"
- The thumbnail image loading failed.
Available styles:
"default"
"noframe"
An example of use of thumbnail:
Functions | |
Eina_Bool | elm_need_ethumb (void) |
void * | elm_thumb_ethumb_client_get (void) |
Eina_Bool | elm_thumb_ethumb_client_connected_get (void) |
Evas_Object * | elm_thumb_add (Evas_Object *parent) |
void | elm_thumb_file_set (Eo *obj, const char *file, const char *key) |
void | elm_thumb_file_get (const Eo *obj, const char **file, const char **key) |
Eina_Bool | elm_thumb_editable_set (Evas_Object *obj, Eina_Bool edit) |
Make the thumbnail 'editable'. | |
Eina_Bool | elm_thumb_editable_get (const Evas_Object *obj) |
Get whether the thumbnail is editable. | |
void | elm_thumb_compress_set (Evas_Object *obj, int compress) |
Set the compression for the thumb object. | |
void | elm_thumb_compress_get (const Evas_Object *obj, int *compress) |
Get the compression of the thumb object. | |
void | elm_thumb_format_set (Evas_Object *obj, Ethumb_Thumb_Format format) |
Set the format for the thumb object. | |
Ethumb_Thumb_Format | elm_thumb_format_get (const Evas_Object *obj) |
Get the format of the thumb object. | |
void | elm_thumb_animate_set (Evas_Object *obj, Elm_Thumb_Animation_Setting setting) |
Set the animation state for the thumb object. | |
Elm_Thumb_Animation_Setting | elm_thumb_animate_get (const Evas_Object *obj) |
Get the animation state for the thumb object. | |
void | elm_thumb_fdo_size_set (Evas_Object *obj, Ethumb_Thumb_FDO_Size size) |
Set the FDO size for the thumb object. | |
Ethumb_Thumb_FDO_Size | elm_thumb_fdo_size_get (const Evas_Object *obj) |
Get the fdo size of the thumb object. | |
void | elm_thumb_orientation_set (Evas_Object *obj, Ethumb_Thumb_Orientation orient) |
Set the orientation for the thumb object. | |
Ethumb_Thumb_Orientation | elm_thumb_orientation_get (const Evas_Object *obj) |
Get the orientation of the thumb object. | |
void | elm_thumb_aspect_set (Evas_Object *obj, Ethumb_Thumb_Aspect aspect) |
Set the aspect for the thumb object. | |
Ethumb_Thumb_Aspect | elm_thumb_aspect_get (const Evas_Object *obj) |
Get the aspect of the thumb object. | |
void | elm_thumb_quality_set (Evas_Object *obj, int quality) |
Set the quality for the thumb object. | |
void | elm_thumb_quality_get (const Evas_Object *obj, int *quality) |
Get the quality of the thumb object. | |
void | elm_thumb_size_set (Evas_Object *obj, int tw, int th) |
Set the size for the thumb object. | |
void | elm_thumb_size_get (const Evas_Object *obj, int *tw, int *th) |
Get the size of the thumb object. | |
void | elm_thumb_crop_align_set (Evas_Object *obj, double cropx, double cropy) |
Set the crop alignment for the thumb object. | |
void | elm_thumb_crop_align_get (const Evas_Object *obj, double *cropx, double *cropy) |
Get the crop alignment of the thumb object. | |
void | elm_thumb_path_get (const Evas_Object *obj, const char **file, const char **key) |
Get the path and key to the image or video thumbnail generated by ethumb. | |
void | elm_thumb_reload (Evas_Object *obj) |
Reload thumbnail if it was generated before. |
Enumeration Type Documentation
Function Documentation
Eina_Bool elm_need_ethumb | ( | void | ) |
Request that your elementary application needs ethumb
This initializes the Ethumb library when called and if support exists it returns EINA_TRUE
, otherwise returns EINA_FALSE
. This must be called before any other function that deals with elm_thumb objects or ethumb_client instances.
- Examples:
- fileselector_example.c, and thumb_example_01.c.
Evas_Object* elm_thumb_add | ( | Evas_Object * | parent | ) |
Add a new thumb object to the parent.
- Parameters:
-
parent The parent object.
- Returns:
- The new object or NULL if it cannot be created.
- Examples:
- thumb_example_01.c.
Elm_Thumb_Animation_Setting elm_thumb_animate_get | ( | const Evas_Object * | obj | ) |
Get the animation state for the thumb object.
- Returns:
- The animation setting or ELM_THUMB_ANIMATION_LAST
void elm_thumb_animate_set | ( | Evas_Object * | obj, |
Elm_Thumb_Animation_Setting | setting | ||
) |
Set the animation state for the thumb object.
If its content is an animated video, you may start/stop the animation or tell it o play continuously and looping.
- Parameters:
-
[in] setting The animation setting or ELM_THUMB_ANIMATION_LAST
Ethumb_Thumb_Aspect elm_thumb_aspect_get | ( | const Evas_Object * | obj | ) |
Get the aspect of the thumb object.
- Returns:
- The aspect setting.
- Since (EFL) :
- 1.8
void elm_thumb_aspect_set | ( | Evas_Object * | obj, |
Ethumb_Thumb_Aspect | aspect | ||
) |
Set the aspect for the thumb object.
- Parameters:
-
[in] aspect The aspect setting.
- Since (EFL) :
- 1.8
void elm_thumb_compress_get | ( | const Evas_Object * | obj, |
int * | compress | ||
) |
Get the compression of the thumb object.
- Parameters:
-
[out] compress The compression of the thumb.
- Returns:
- Force the return type to be sure the argument doesn't become the return
- Since (EFL) :
- 1.8
void elm_thumb_compress_set | ( | Evas_Object * | obj, |
int | compress | ||
) |
Set the compression for the thumb object.
- Parameters:
-
[in] compress The compression of the thumb.
- Since (EFL) :
- 1.8
void elm_thumb_crop_align_get | ( | const Evas_Object * | obj, |
double * | cropx, | ||
double * | cropy | ||
) |
Get the crop alignment of the thumb object.
- Parameters:
-
[out] cropx The x coordinate of the crop. [out] cropy The y coordinate of the crop.
- Since (EFL) :
- 1.8
void elm_thumb_crop_align_set | ( | Evas_Object * | obj, |
double | cropx, | ||
double | cropy | ||
) |
Set the crop alignment for the thumb object.
- Parameters:
-
[in] cropx The x coordinate of the crop. [in] cropy The y coordinate of the crop.
- Since (EFL) :
- 1.8
Eina_Bool elm_thumb_editable_get | ( | const Evas_Object * | obj | ) |
Get whether the thumbnail is editable.
This means the thumbnail is a valid drag target for drag and drop, and can be cut or pasted too.
- Returns:
- The editable state, default is
false
.
Eina_Bool elm_thumb_editable_set | ( | Evas_Object * | obj, |
Eina_Bool | edit | ||
) |
Make the thumbnail 'editable'.
This means the thumbnail is a valid drag target for drag and drop, and can be cut or pasted too.
- Parameters:
-
[in] edit The editable state, default is false
.
- Examples:
- thumb_example_01.c.
Get the ethumb_client connection state.
- Returns:
EINA_TRUE
if the client is connected to the server orEINA_FALSE
otherwise.
void* elm_thumb_ethumb_client_get | ( | void | ) |
Get the ethumb_client handle so custom configuration can be made.
- Returns:
- Ethumb_Client instance or NULL.
The ethumb client handle returned may or may not be NULL. It may or may not survive into the future (ethumbd may become disconnected). Do not use this unless you know what you are doing.
Ethumb_Thumb_FDO_Size elm_thumb_fdo_size_get | ( | const Evas_Object * | obj | ) |
Get the fdo size of the thumb object.
- Returns:
- The FDO size setting.
- Since (EFL) :
- 1.8
void elm_thumb_fdo_size_set | ( | Evas_Object * | obj, |
Ethumb_Thumb_FDO_Size | size | ||
) |
Set the FDO size for the thumb object.
- Parameters:
-
[in] size The FDO size setting.
- Since (EFL) :
- 1.8
void elm_thumb_file_get | ( | const Eo * | obj, |
const char ** | file, | ||
const char ** | key | ||
) |
Get the image or video path and key used to generate the thumbnail.
- See also:
- elm_thumb_file_set()
- elm_thumb_path_get()
- Parameters:
-
[out] file The path to file that will be used as thumbnail source. [out] key The key used in case of an EET file.
void elm_thumb_file_set | ( | Eo * | obj, |
const char * | file, | ||
const char * | key | ||
) |
Set the file that will be used as thumbnail source.
The file can be an image or a video (in that case, acceptable extensions are: avi, mp4, ogv, mov, mpg and wmv). To start the video animation, use the function elm_thumb_animate().
- See also:
- elm_thumb_file_get()
- elm_thumb_reload()
- elm_thumb_animate()
- Parameters:
-
[in] file The path to file that will be used as thumbnail source. [in] key The key used in case of an EET file.
- Examples:
- thumb_example_01.c.
Ethumb_Thumb_Format elm_thumb_format_get | ( | const Evas_Object * | obj | ) |
Get the format of the thumb object.
- Returns:
- The format setting.
- Since (EFL) :
- 1.8
void elm_thumb_format_set | ( | Evas_Object * | obj, |
Ethumb_Thumb_Format | format | ||
) |
Set the format for the thumb object.
- Parameters:
-
[in] format The format setting.
- Since (EFL) :
- 1.8
Ethumb_Thumb_Orientation elm_thumb_orientation_get | ( | const Evas_Object * | obj | ) |
Get the orientation of the thumb object.
- Returns:
- The orientation setting.
- Since (EFL) :
- 1.8
void elm_thumb_orientation_set | ( | Evas_Object * | obj, |
Ethumb_Thumb_Orientation | orient | ||
) |
Set the orientation for the thumb object.
- Parameters:
-
[in] orient The orientation setting.
- Since (EFL) :
- 1.8
void elm_thumb_path_get | ( | const Evas_Object * | obj, |
const char ** | file, | ||
const char ** | key | ||
) |
Get the path and key to the image or video thumbnail generated by ethumb.
One just needs to make sure that the thumbnail was generated before getting its path; otherwise, the path will be null
. One way to do that is by asking for the path when/after the "generate,stop" smart callback is called.
- Parameters:
-
[out] file Pointer to thumb path. [out] key Pointer to thumb key.
void elm_thumb_quality_get | ( | const Evas_Object * | obj, |
int * | quality | ||
) |
Get the quality of the thumb object.
- Parameters:
-
[out] quality The quality of the thumb.
- Since (EFL) :
- 1.8
void elm_thumb_quality_set | ( | Evas_Object * | obj, |
int | quality | ||
) |
Set the quality for the thumb object.
- Parameters:
-
[in] quality The quality of the thumb.
- Since (EFL) :
- 1.8
void elm_thumb_reload | ( | Evas_Object * | obj | ) |
Reload thumbnail if it was generated before.
This is useful if the ethumb client configuration changed, like its size, aspect or any other property one set in the handle returned by elm_thumb_ethumb_client_get().
If the options didn't change, the thumbnail won't be generated again, but the old one will still be used.
- Examples:
- thumb_example_01.c.
void elm_thumb_size_get | ( | const Evas_Object * | obj, |
int * | tw, | ||
int * | th | ||
) |
Get the size of the thumb object.
- Parameters:
-
[out] tw The width of the thumb. [out] th The height of the thumb.
- Since (EFL) :
- 1.8
void elm_thumb_size_set | ( | Evas_Object * | obj, |
int | tw, | ||
int | th | ||
) |
Set the size for the thumb object.
- Parameters:
-
[in] tw The width of the thumb. [in] th The height of the thumb.
- Since (EFL) :
- 1.8
- Examples:
- thumb_example_01.c.