libvlc_picture.h File Reference

Go to the source code of this file.

Typedefs
typedef struct libvlc_picture_t	libvlc_picture_t
typedef enum libvlc_picture_type_t	libvlc_picture_type_t

Enumerations
enum	libvlc_picture_type_t { libvlc_picture_Argb, libvlc_picture_Png, libvlc_picture_Jpg }

Functions
LIBVLC_API void	libvlc_picture_retain (libvlc_picture_t *pic)
	Increment the reference count of this picture. More...
LIBVLC_API void	libvlc_picture_release (libvlc_picture_t *pic)
	Decrement the reference count of this picture. More...
LIBVLC_API int	libvlc_picture_save (const libvlc_picture_t *pic, const char *path)
	Saves this picture to a file. More...
LIBVLC_API const unsigned char *	libvlc_picture_get_buffer (const libvlc_picture_t *pic, size_t *size)
	Returns the image internal buffer, including potential padding. More...
LIBVLC_API libvlc_picture_type_t	libvlc_picture_type (const libvlc_picture_t *pic)
	Returns the picture type. More...
LIBVLC_API unsigned int	libvlc_picture_get_stride (const libvlc_picture_t *pic)
	Returns the image stride, ie. More...
LIBVLC_API unsigned int	libvlc_picture_get_width (const libvlc_picture_t *pic)
	Returns the width of the image in pixels. More...
LIBVLC_API unsigned int	libvlc_picture_get_height (const libvlc_picture_t *pic)
	Returns the height of the image in pixels. More...
LIBVLC_API libvlc_time_t	libvlc_picture_get_time (const libvlc_picture_t *pic)
	Returns the time at which this picture was generated, in milliseconds. More...

Typedef Documentation

libvlc_picture_t

typedef struct libvlc_picture_t libvlc_picture_t

libvlc_picture_type_t

typedef enum libvlc_picture_type_t libvlc_picture_type_t

Enumeration Type Documentation

libvlc_picture_type_t

enum libvlc_picture_type_t

Enumerator
libvlc_picture_Argb
libvlc_picture_Png
libvlc_picture_Jpg

Function Documentation

libvlc_picture_get_buffer()

LIBVLC_API const unsigned char* libvlc_picture_get_buffer	(	const libvlc_picture_t *	pic,
		size_t *	size
	)

Returns the image internal buffer, including potential padding.

The libvlc_picture_t owns the returned buffer, which must not be modified nor freed.

Parameters

pic	A picture object
size	A pointer to a size_t that will hold the size of the buffer [required]

Returns

A pointer to the internal buffer.

libvlc_picture_get_height()

LIBVLC_API unsigned int libvlc_picture_get_height

(

const libvlc_picture_t *

pic

)

Returns the height of the image in pixels.

Parameters

pic	A picture object

libvlc_picture_get_stride()

LIBVLC_API unsigned int libvlc_picture_get_stride

(

const libvlc_picture_t *

pic

)

Returns the image stride, ie.

the number of bytes per line. This can only be called on images of type libvlc_picture_Argb

Parameters

pic	A picture object

libvlc_picture_get_time()

LIBVLC_API libvlc_time_t libvlc_picture_get_time

(

const libvlc_picture_t *

pic

)

Returns the time at which this picture was generated, in milliseconds.

Parameters

pic	A picture object

libvlc_picture_get_width()

LIBVLC_API unsigned int libvlc_picture_get_width

(

const libvlc_picture_t *

pic

)

Returns the width of the image in pixels.

Parameters

pic	A picture object

libvlc_picture_release()

LIBVLC_API void libvlc_picture_release

(

libvlc_picture_t *

pic

)

Decrement the reference count of this picture.

When the reference count reaches 0, the picture will be released. The picture must not be accessed after calling this function.

See also

libvlc_picture_retain

Parameters

pic	A picture object

libvlc_picture_retain()

LIBVLC_API void libvlc_picture_retain

(

libvlc_picture_t *

pic

)

Increment the reference count of this picture.

See also

libvlc_picture_release()

Parameters

pic	A picture object

libvlc_picture_save()

LIBVLC_API int libvlc_picture_save	(	const libvlc_picture_t *	pic,
		const char *	path
	)

Saves this picture to a file.

The image format is the same as the one returned by libvlc_picture_type

Parameters

pic	A picture object
path	The path to the generated file

Returns

0 in case of success, -1 otherwise

libvlc_picture_type()

LIBVLC_API libvlc_picture_type_t libvlc_picture_type

(

const libvlc_picture_t *

pic

)

Returns the picture type.

Parameters

pic	A picture object

See also

libvlc_picture_type_t