vlc_thumbnailer.h File Reference

Include dependency graph for vlc_thumbnailer.h:

Go to the source code of this file.

Typedefs
typedef struct vlc_thumbnailer_t	vlc_thumbnailer_t
typedef struct vlc_thumbnailer_request_t	vlc_thumbnailer_request_t
typedef void(*	vlc_thumbnailer_cb) (void *data, picture_t *thumbnail)
	vlc_thumbnailer_cb defines a callback invoked on thumbnailing completion or error

Enumerations
enum	vlc_thumbnailer_seek_speed { VLC_THUMBNAILER_SEEK_PRECISE , VLC_THUMBNAILER_SEEK_FAST }

Functions
vlc_thumbnailer_t *	vlc_thumbnailer_Create (vlc_object_t *parent)
	vlc_thumbnailer_Create Creates a thumbnailer object
vlc_thumbnailer_request_t *	vlc_thumbnailer_RequestByTime (vlc_thumbnailer_t *thumbnailer, vlc_tick_t time, enum vlc_thumbnailer_seek_speed speed, input_item_t *input_item, vlc_tick_t timeout, vlc_thumbnailer_cb cb, void *user_data)
	vlc_thumbnailer_RequestByTime Requests a thumbnailer at a given time
vlc_thumbnailer_request_t *	vlc_thumbnailer_RequestByPos (vlc_thumbnailer_t *thumbnailer, double pos, enum vlc_thumbnailer_seek_speed speed, input_item_t *input_item, vlc_tick_t timeout, vlc_thumbnailer_cb cb, void *user_data)
	vlc_thumbnailer_RequestByTime Requests a thumbnailer at a given time
void	vlc_thumbnailer_DestroyRequest (vlc_thumbnailer_t *thumbnailer, vlc_thumbnailer_request_t *request)
	vlc_thumbnailer_DestroyRequest Destroy a thumbnail request
void	vlc_thumbnailer_Release (vlc_thumbnailer_t *thumbnailer)
	vlc_thumbnailer_Release releases a thumbnailer and cancel all pending requests

Typedef Documentation

vlc_thumbnailer_cb

typedef void(* vlc_thumbnailer_cb) (void *data, picture_t *thumbnail)

vlc_thumbnailer_cb defines a callback invoked on thumbnailing completion or error

This callback will always be called, provided vlc_thumbnailer_Request returned a non NULL request, and provided the request is not cancelled before its completion. In case of failure, p_thumbnail will be NULL. The picture, if any, is owned by the thumbnailer, and must be acquired by using picture_Hold to use it pass the callback's scope.

Parameters

data	Is the opaque pointer passed as vlc_thumbnailer_Request last parameter
thumbnail	The generated thumbnail, or NULL in case of failure or timeout

vlc_thumbnailer_request_t

typedef struct vlc_thumbnailer_request_t vlc_thumbnailer_request_t

vlc_thumbnailer_t

typedef struct vlc_thumbnailer_t vlc_thumbnailer_t

Enumeration Type Documentation

vlc_thumbnailer_seek_speed

enum vlc_thumbnailer_seek_speed

Enumerator
VLC_THUMBNAILER_SEEK_PRECISE	Precise, but potentially slow.
VLC_THUMBNAILER_SEEK_FAST	Fast, but potentially imprecise.

Function Documentation

vlc_thumbnailer_Create()

vlc_thumbnailer_t * vlc_thumbnailer_Create

(

vlc_object_t *

parent

)

vlc_thumbnailer_Create Creates a thumbnailer object

Parameters

parent

A VLC object

Returns

A thumbnailer object, or NULL in case of failure

References vlc_thumbnailer_t::executor, vlc_thumbnailer_t::parent, unlikely, and vlc_executor_New().

Referenced by libvlc_InternalInit().

vlc_thumbnailer_DestroyRequest()

void vlc_thumbnailer_DestroyRequest	(	vlc_thumbnailer_t *	thumbnailer,
		vlc_thumbnailer_request_t *	request
	)

vlc_thumbnailer_DestroyRequest Destroy a thumbnail request

Parameters

thumbnailer	A thumbnailer object
request	An opaque thumbnail request object

The request can be destroyed before receiving a callback (in that case, the callback won't be called) or after (to release resources).

References vlc_thumbnailer_t::executor, Interrupt(), task::runnable, TaskRelease(), vlc_atomic_rc_dec(), and vlc_executor_Cancel().

vlc_thumbnailer_Release()

void vlc_thumbnailer_Release

(

vlc_thumbnailer_t *

thumbnailer

)

vlc_thumbnailer_Release releases a thumbnailer and cancel all pending requests

Parameters

thumbnailer

A thumbnailer object

References vlc_thumbnailer_t::executor, and vlc_executor_Delete().

Referenced by libvlc_InternalCleanup().

vlc_thumbnailer_RequestByPos()

vlc_thumbnailer_request_t * vlc_thumbnailer_RequestByPos	(	vlc_thumbnailer_t *	thumbnailer,
		double	pos,
		enum vlc_thumbnailer_seek_speed	speed,
		input_item_t *	input_item,
		vlc_tick_t	timeout,
		vlc_thumbnailer_cb	cb,
		void *	user_data
	)

vlc_thumbnailer_RequestByTime Requests a thumbnailer at a given time

Parameters

thumbnailer	A thumbnailer object
pos	The position at which the thumbnail should be taken
speed	The seeking speed

See also

{enum vlc_thumbnailer_seek_speed}

Parameters

input_item	The input item to generate the thumbnail for
timeout	A timeout value, or VLC_TICK_INVALID to disable timeout
cb	A user callback to be called on completion (success & error)
user_data	An opaque value, provided as pf_cb's first parameter

Returns

An opaque request object, or NULL in case of failure

If this function returns a valid request object, the callback is guaranteed to be called, even in case of later failure (except if destroyed early by the user). The returned request object must be freed with vlc_thumbnailer_DestroyRequest(). The provided input_item will be held by the thumbnailer and can safely be released after calling this function.

References seek_target::pos, RequestCommon(), seek_target::type, and seek_target::VLC_THUMBNAILER_SEEK_POS.

vlc_thumbnailer_RequestByTime()

vlc_thumbnailer_request_t * vlc_thumbnailer_RequestByTime	(	vlc_thumbnailer_t *	thumbnailer,
		vlc_tick_t	time,
		enum vlc_thumbnailer_seek_speed	speed,
		input_item_t *	input_item,
		vlc_tick_t	timeout,
		vlc_thumbnailer_cb	cb,
		void *	user_data
	)

vlc_thumbnailer_RequestByTime Requests a thumbnailer at a given time

Parameters

thumbnailer	A thumbnailer object
time	The time at which the thumbnail should be taken
speed	The seeking speed

See also

{enum vlc_thumbnailer_seek_speed}

Parameters

input_item	The input item to generate the thumbnail for
timeout	A timeout value, or VLC_TICK_INVALID to disable timeout
cb	A user callback to be called on completion (success & error)
user_data	An opaque value, provided as pf_cb's first parameter

Returns

An opaque request object, or NULL in case of failure

If this function returns a valid request object, the callback is guaranteed to be called, even in case of later failure (except if destroyed early by the user). The returned request object must be freed with vlc_thumbnailer_DestroyRequest(). The provided input_item will be held by the thumbnailer and can safely be released safely after calling this function.

References RequestCommon(), seek_target::time, seek_target::type, and seek_target::VLC_THUMBNAILER_SEEK_TIME.