Ethumb Basics

Functions that all users must know of to use Ethumb. More...

Typedefs
typedef struct _Ethumb	Ethumb
	thumbnailer handle. More...
typedef void(*	Ethumb_Generate_Cb) (void *data, Ethumb *e, Eina_Bool success)
	reports results of ethumb_generate(). More...

Functions
EAPI int	ethumb_init (void)
	Initialize ethumb. More...
EAPI int	ethumb_shutdown (void)
	Shutdown ethumb, unloading all currently-loaded modules. More...
EAPI Ethumb *	ethumb_new (void)
	Create a new ethumb object. More...
EAPI void	ethumb_free (Ethumb *e)
	Free an ethumb object.
EAPI Eina_Bool	ethumb_file_set (Ethumb *e, const char *path, const char *key)
	Set the file for which to generate thumbnails. More...
EAPI void	ethumb_file_get (const Ethumb *e, const char **path, const char **key)
	Get the file for which to generate thumbnails. More...
EAPI void	ethumb_file_free (Ethumb *e)
	Reset the source file information. More...
EAPI Eina_Bool	ethumb_generate (Ethumb *e, Ethumb_Generate_Cb finished_cb, const void *data, Eina_Free_Cb free_data)
	Generate the thumbnail. More...
EAPI Eina_Bool	ethumb_exists (Ethumb *e)
	test if the thumbnailer exists More...
EAPI Ethumb *	ethumb_dup (const Ethumb *e)
	Duplicate an thumbnailer. More...
EAPI Eina_Bool	ethumb_cmp (const Ethumb *e1, const Ethumb *e2)
	Compare two thumbnailers. More...
EAPI int	ethumb_hash (const void *key, int key_length)
EAPI int	ethumb_key_cmp (const void *key1, int key1_length, const void *key2, int key2_length)
EAPI unsigned int	ethumb_length (const void *key)

Detailed Description

Functions that all users must know of to use Ethumb.

Typedef Documentation

Ethumb

typedef struct _Ethumb Ethumb

thumbnailer handle.

The handle is returned by ethumb_new() and destroyed by ethumb_free().

Ethumb_Generate_Cb

typedef void(* Ethumb_Generate_Cb) (void *data, Ethumb *e, Eina_Bool success)

reports results of ethumb_generate().

Parameters

data	extra context given to ethumb_generate().
e	handle of the current thumbnailer.
success	EINA_TRUE if generated or EINA_FALSE on errors.

Function Documentation

ethumb_init()

EAPI int ethumb_init

(

void

)

Initialize ethumb.

Returns

1 or greater on success, 0 otherwise.

ethumb_shutdown()

EAPI int ethumb_shutdown

(

void

)

Shutdown ethumb, unloading all currently-loaded modules.

Returns

0 if ethumb shuts down, an integer greater than 0 otherwise.

Referenced by ethumb_client_shutdown().

ethumb_new()

EAPI Ethumb * ethumb_new

(

void

)

Create a new ethumb object.

return The newly-created ethumb object

References EINA_SAFETY_ON_NULL_RETURN_VAL.

Referenced by ethumb_client_connect().

ethumb_file_set()

EAPI Eina_Bool ethumb_file_set	(	Ethumb *	e,
		const char *	path,
		const char *	key
	)

Set the file for which to generate thumbnails.

Parameters

e	A pointer to an Ethumb object.
path	The file to use.
key	If path allows storing multiple resources in a single file (EET or Edje for instance), key is the key used to locate the right resource inside the file. NULL if not applicable.

References DBG, EINA_FALSE, eina_file_path_sanitize(), EINA_SAFETY_ON_NULL_RETURN_VAL, eina_stringshare_replace(), and EINA_TRUE.

Referenced by ethumb_client_file_set().

ethumb_file_get()

EAPI void ethumb_file_get	(	const Ethumb *	e,
		const char **	path,
		const char **	key
	)

Get the file for which to generate thumbnails.

Parameters

	e	A pointer to an Ethumb object.
[out]	path	The file being used.
[out]	key	The key used to locate the right resource in case the file can store several of them. NULL if not applicable.

See also

ethumb_file_set

References EINA_SAFETY_ON_NULL_RETURN.

Referenced by ethumb_client_file_get(), ethumb_client_generate(), and ethumb_client_thumb_exists().

ethumb_file_free()

EAPI void ethumb_file_free

(

Ethumb *

e

)

Reset the source file information.

Parameters

e	A pointer to an Ethumb object.

References DBG, EINA_SAFETY_ON_NULL_RETURN, and eina_stringshare_replace().

Referenced by ethumb_client_file_free().

ethumb_generate()

EAPI Eina_Bool ethumb_generate	(	Ethumb *	e,
		Ethumb_Generate_Cb	finished_cb,
		const void *	data,
		Eina_Free_Cb	free_data
	)

Generate the thumbnail.

Parameters

e	handle of the current thumbnailer.
finished_cb	The callback function to run on opertaion end
free_data	The callback function to run on free data.

Returns

EINA_TRUE on success and EINA_FALSE on failure

References DBG, EINA_FALSE, EINA_SAFETY_ON_NULL_RETURN_VAL, and ERR.

ethumb_exists()

EAPI Eina_Bool ethumb_exists

(

Ethumb *

e

)

test if the thumbnailer exists

Parameters

e	handle of the thumbnailer to test.

Returns

EINA_TRUE if thumbnailer exists and EINA_FALSE otherwise.

References DBG, EINA_FALSE, and EINA_SAFETY_ON_NULL_RETURN_VAL.

ethumb_dup()

EAPI Ethumb * ethumb_dup

(

const Ethumb *

e

)

Duplicate an thumbnailer.

Parameters

e	Handle of the thumbnailer to duplicate

Returns

a new allocated copy of the thumbnailer.

References ecore_evas_alpha_set(), ecore_evas_buffer_new(), ecore_evas_free(), ecore_evas_get(), ecore_evas_object_ecore_evas_get(), ecore_evas_object_evas_get(), ecore_evas_object_image_new(), eina_stringshare_ref(), EINA_TRUE, ERR, evas_font_cache_set(), evas_image_cache_set(), and evas_object_image_add().

Referenced by ethumb_client_aspect_set(), ethumb_client_category_set(), ethumb_client_crop_align_set(), ethumb_client_dir_path_set(), ethumb_client_document_page_set(), ethumb_client_fdo_set(), ethumb_client_format_set(), ethumb_client_frame_set(), ethumb_client_orientation_set(), ethumb_client_size_set(), ethumb_client_thumb_exists(), ethumb_client_video_fps_set(), ethumb_client_video_interval_set(), ethumb_client_video_ntimes_set(), ethumb_client_video_start_set(), and ethumb_client_video_time_set().

ethumb_cmp()

EAPI Eina_Bool ethumb_cmp	(	const Ethumb *	e1,
		const Ethumb *	e2
	)

Compare two thumbnailers.

Parameters

e1	First handle of thumbnailer to compare
e2	Second handle of thumbnailer to compare

Returns

EINA_TRUE if the thumbnailers are equal and EINA_FALSE otherwise