vlc_filter.h File Reference

This file defines the structure and types used by video and audio filters. More...

Include dependency graph for vlc_filter.h:

Go to the source code of this file.

Data Structures

struct filter_t

Structure describing a filter. More...

Defines

#define VLC_FILTER_H 1

#define VIDEO_FILTER_WRAPPER(name)

Create a picture_t *(*)( filter_t *, picture_t * ) compatible wrapper using a void (*)( filter_t *, picture_t *, picture_t * ) function.

#define filter_chain_New(a, b, c, d, e, f) __filter_chain_New( VLC_OBJECT( a ), b, c, d, e, f )

Typedefs

typedef filter_owner_sys_t filter_owner_sys_t

typedef filter_chain_t filter_chain_t

Filter chain management API The filter chain management API is used to dynamically construct filters and add them in a chain.

Functions

static picture_t * filter_NewPicture (filter_t *p_filter)

This function will return a new picture usable by p_filter as an output buffer.

static void filter_DeletePicture (filter_t *p_filter, picture_t *p_picture)

This function will release a picture create by filter_NewPicture.

static subpicture_t * filter_NewSubpicture (filter_t *p_filter)

This function will return a new subpicture usable by p_filter as an output buffer.

static void filter_DeleteSubpicture (filter_t *p_filter, subpicture_t *p_subpicture)

This function will release a subpicture create by filter_NewSubicture.

static block_t * filter_NewAudioBuffer (filter_t *p_filter, int i_size)

This function will return a new audio buffer usable by p_filter as an output buffer.

filter_chain_t * __filter_chain_New (vlc_object_t *, const char *, bool, int(*)(filter_t *, void *), void(*)(filter_t *), void *)

Create new filter chain.

void filter_chain_Delete (filter_chain_t *)

Delete filter chain will delete all filters in the chain and free all allocated data.

void filter_chain_Reset (filter_chain_t *, const es_format_t *, const es_format_t *)

Reset filter chain will delete all filters in the chain and reset p_fmt_in and p_fmt_out to the new values.

filter_t * filter_chain_AppendFilter (filter_chain_t *, const char *, config_chain_t *, const es_format_t *, const es_format_t *)

Append filter to the end of the chain.

int filter_chain_AppendFromString (filter_chain_t *, const char *)

Append new filter to filter chain from string.

int filter_chain_DeleteFilter (filter_chain_t *, filter_t *)

Delete filter from filter chain.

filter_t * filter_chain_GetFilter (filter_chain_t *, int, const char *)

Get filter by name of position in the filter chain.

int filter_chain_GetLength (filter_chain_t *)

Get the number of filters in the filter chain.

const es_format_t * filter_chain_GetFmtOut (filter_chain_t *)

Get last p_fmt_out in the chain.

picture_t * filter_chain_VideoFilter (filter_chain_t *, picture_t *)

Apply the filter chain to a video picture.

block_t * filter_chain_AudioFilter (filter_chain_t *, block_t *)

Apply the filter chain to a audio block.

void filter_chain_SubFilter (filter_chain_t *, mtime_t)

Apply filter chain to subpictures.

Detailed Description

This file defines the structure and types used by video and audio filters.

Define Documentation

#define filter_chain_New	(	a,
		b,
		c,
		d,
		e,
		f	)	__filter_chain_New( VLC_OBJECT( a ), b, c, d, e, f )

#define VIDEO_FILTER_WRAPPER ( name )

Value:

static picture_t *name ## _Filter ( filter_t *p_filter,             \
                                        picture_t *p_pic )              \
    {                                                                   \
        picture_t *p_outpic = filter_NewPicture( p_filter );            \
        if( !p_outpic )                                                 \
        {                                                               \
            picture_Release( p_pic );                                   \
            return NULL;                                                \
        }                                                               \
                                                                        \
        name( p_filter, p_pic, p_outpic );                              \
                                                                        \
        picture_CopyProperties( p_outpic, p_pic );                      \
        picture_Release( p_pic );                                       \
                                                                        \
        return p_outpic;                                                \
    }

Create a picture_t *(*)( filter_t *, picture_t * ) compatible wrapper using a void (*)( filter_t *, picture_t *, picture_t * ) function.

Currently used by the chroma video filters

#define VLC_FILTER_H 1

Typedef Documentation

typedef struct filter_chain_t filter_chain_t

Filter chain management API The filter chain management API is used to dynamically construct filters and add them in a chain.

typedef struct filter_owner_sys_t filter_owner_sys_t

Function Documentation

filter_chain_t* __filter_chain_New	(	vlc_object_t *	,
		const char *	,
		bool	,
		int()(filter_t , void *)	,
		void()(filter_t )	,
		void *
	)

Create new filter chain.

Parameters:

	p_object	pointer to a vlc object
	psz_capability	vlc capability of filters in filter chain
	b_allow_format_fmt_change	allow changing of fmt
	pf_buffer_allocation_init	callback function to initialize buffer allocations
	pf_buffer_allocation_clear	callback function to clear buffer allocation initialization
	p_buffer_allocation_data	pointer to private allocation data

Returns:: pointer to a filter chain

filter_t* filter_chain_AppendFilter	(	filter_chain_t *	,
		const char *	,
		config_chain_t *	,
		const es_format_t *	,
		const es_format_t *
	)

Append filter to the end of the chain.

Parameters:

	p_chain	pointer to filter chain
	psz_name	name of filter
	p_cfg
	p_fmt_in	input es_format_t
	p_fmt_out	output es_format_t

Returns:: pointer to filter chain

int filter_chain_AppendFromString	(	filter_chain_t *	,
		const char *
	)

Append new filter to filter chain from string.

Parameters:

	p_chain	pointer to filter chain
	psz_string	string of filters

Returns:: 0 for success

block_t* filter_chain_AudioFilter	(	filter_chain_t *	,
		block_t *
	)

Apply the filter chain to a audio block.

Parameters:

	p_chain	pointer to filter chain
	p_block	audio frame to apply filters on

Returns:: modified audio frame after applying all audio filters

void filter_chain_Delete ( filter_chain_t * )

Delete filter chain will delete all filters in the chain and free all allocated data.

The pointer to the filter chain is then no longer valid.

Parameters:

p_chain

pointer to filter chain

int filter_chain_DeleteFilter	(	filter_chain_t *	,
		filter_t *
	)

Delete filter from filter chain.

This function also releases the filter object and unloads the filter modules. The pointer to p_filter is no longer valid after this function successfully returns.

Parameters:

	p_chain	pointer to filter chain
	p_filter	pointer to filter object

Returns:: VLC_SUCCESS on succes, else VLC_EGENERIC

filter_t* filter_chain_GetFilter	(	filter_chain_t *	,
		int	,
		const char *
	)

Get filter by name of position in the filter chain.

Parameters:

	p_chain	pointer to filter chain
	i_position	position of filter in filter chain
	psz_name	name of filter to get

Returns:: filter object based on position or name provided

const es_format_t* filter_chain_GetFmtOut ( filter_chain_t * )

Get last p_fmt_out in the chain.

Parameters:

p_chain

pointer to filter chain

Returns:: last p_fmt (es_format_t) of this filter chain

int filter_chain_GetLength ( filter_chain_t * )

Get the number of filters in the filter chain.

Parameters:

p_chain

pointer to filter chain

Returns:: number of filters in this filter chain

void filter_chain_Reset	(	filter_chain_t *	,
		const es_format_t *	,
		const es_format_t *
	)

Reset filter chain will delete all filters in the chain and reset p_fmt_in and p_fmt_out to the new values.

Parameters:

	p_chain	pointer to filter chain
	p_fmt_in	new fmt_in params
	p_fmt_out	new fmt_out params

void filter_chain_SubFilter	(	filter_chain_t *	,
		mtime_t
	)

Apply filter chain to subpictures.

Parameters:

	p_chain	pointer to filter chain
	display_date	of subpictures

picture_t* filter_chain_VideoFilter	(	filter_chain_t *	,
		picture_t *
	)

Apply the filter chain to a video picture.

Parameters:

	p_chain	pointer to filter chain
	p_picture	picture to apply filters on

Returns:: modified picture after applying all video filters

static void filter_DeletePicture	(	filter_t *	p_filter,
		picture_t *	p_picture
	)			`[inline, static]`

This function will release a picture create by filter_NewPicture.

Provided for convenience.

Parameters:

	p_filter	filter_t object
	p_picture	picture to be deleted

static void filter_DeleteSubpicture	(	filter_t *	p_filter,
		subpicture_t *	p_subpicture
	)			`[inline, static]`

This function will release a subpicture create by filter_NewSubicture.

Provided for convenience.

Parameters:

	p_filter	filter_t object
	p_subpicture	to be released

static block_t* filter_NewAudioBuffer	(	filter_t *	p_filter,
		int	i_size
	)			`[inline, static]`

This function will return a new audio buffer usable by p_filter as an output buffer.

You have to release it using block_Release or by returning it to the caller as a pf_audio_filter return value. Provided for convenience.

Parameters:

	p_filter	filter_t object
	i_size	size of audio buffer requested

Returns:: block to be used as audio output buffer

static picture_t* filter_NewPicture ( filter_t * p_filter ) [inline, static]

This function will return a new picture usable by p_filter as an output buffer.

You have to release it using filter_DeletePicture or by returning it to the caller as a pf_video_filter return value. Provided for convenience.

Parameters:

p_filter

filter_t object

Returns:: new picture on success or NULL on failure

static subpicture_t* filter_NewSubpicture ( filter_t * p_filter ) [inline, static]

This function will return a new subpicture usable by p_filter as an output buffer.

You have to release it using filter_DeleteSubpicture or by returning it to the caller as a pf_sub_filter return value. Provided for convenience.

Parameters:

p_filter

filter_t object

Returns:: new subpicture

Generated on Wed Aug 13 08:02:42 2008 for VLC by

1.5.1


Data Structures
struct	filter_t
	Structure describing a filter. More...
Defines
#define	VLC_FILTER_H 1
#define	VIDEO_FILTER_WRAPPER(name)
	Create a picture_t ()( filter_t , picture_t ) compatible wrapper using a void ()( filter_t , picture_t , picture_t ) function.
#define	filter_chain_New(a, b, c, d, e, f) __filter_chain_New( VLC_OBJECT( a ), b, c, d, e, f )
Typedefs
typedef filter_owner_sys_t	filter_owner_sys_t
typedef filter_chain_t	filter_chain_t
	Filter chain management API The filter chain management API is used to dynamically construct filters and add them in a chain.
Functions
static picture_t *	filter_NewPicture (filter_t *p_filter)
	This function will return a new picture usable by p_filter as an output buffer.
static void	filter_DeletePicture (filter_t p_filter, picture_t p_picture)
	This function will release a picture create by filter_NewPicture.
static subpicture_t *	filter_NewSubpicture (filter_t *p_filter)
	This function will return a new subpicture usable by p_filter as an output buffer.
static void	filter_DeleteSubpicture (filter_t p_filter, subpicture_t p_subpicture)
	This function will release a subpicture create by filter_NewSubicture.
static block_t *	filter_NewAudioBuffer (filter_t *p_filter, int i_size)
	This function will return a new audio buffer usable by p_filter as an output buffer.
filter_chain_t *	__filter_chain_New (vlc_object_t , const char , bool, int()(filter_t , void ), void()(filter_t ), void )
	Create new filter chain.
void	filter_chain_Delete (filter_chain_t *)
	Delete filter chain will delete all filters in the chain and free all allocated data.
void	filter_chain_Reset (filter_chain_t , const es_format_t , const es_format_t *)
	Reset filter chain will delete all filters in the chain and reset p_fmt_in and p_fmt_out to the new values.
filter_t *	filter_chain_AppendFilter (filter_chain_t , const char , config_chain_t , const es_format_t , const es_format_t *)
	Append filter to the end of the chain.
int	filter_chain_AppendFromString (filter_chain_t , const char )
	Append new filter to filter chain from string.
int	filter_chain_DeleteFilter (filter_chain_t , filter_t )
	Delete filter from filter chain.
filter_t *	filter_chain_GetFilter (filter_chain_t , int, const char )
	Get filter by name of position in the filter chain.
int	filter_chain_GetLength (filter_chain_t *)
	Get the number of filters in the filter chain.
const es_format_t *	filter_chain_GetFmtOut (filter_chain_t *)
	Get last p_fmt_out in the chain.
picture_t *	filter_chain_VideoFilter (filter_chain_t , picture_t )
	Apply the filter chain to a video picture.
block_t *	filter_chain_AudioFilter (filter_chain_t , block_t )
	Apply the filter chain to a audio block.
void	filter_chain_SubFilter (filter_chain_t *, mtime_t)
	Apply filter chain to subpictures.