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

Include dependency graph for vlc_filter.h:

Data Structures
struct	filter_t
	Structure describing a filter. More...
Defines
#define	pf_video_filter u.video.pf_filter
#define	pf_video_flush u.video.pf_flush
#define	pf_video_mouse u.video.pf_mouse
#define	pf_video_buffer_new u.video.pf_buffer_new
#define	pf_video_buffer_del u.video.pf_buffer_del
#define	pf_audio_filter u.audio.pf_filter
#define	pf_video_blend u.blend.pf_blend
#define	pf_sub_source u.sub.pf_source
#define	pf_sub_buffer_new u.sub.pf_buffer_new
#define	pf_sub_buffer_del u.sub.pf_buffer_del
#define	pf_sub_mouse u.sub.pf_mouse
#define	pf_sub_filter u.subf.pf_filter
#define	pf_render_text u.render.pf_text
#define	pf_render_html u.render.pf_html
#define	filter_NewAudioBuffer block_New
#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 struct filter_owner_sys_t	filter_owner_sys_t
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.
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 void	filter_FlushPictures (filter_t *p_filter)
	This function will flush the state of a video filter.
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 int	filter_GetInputAttachments (filter_t p_filter, input_attachment_t *ppp_attachment, int pi_attachment)
	This function gives all input attachments at once.
filter_t *	filter_NewBlend (vlc_object_t , const video_format_t p_dst_chroma)
	It creates a blend filter.
int	filter_ConfigureBlend (filter_t , int i_dst_width, int i_dst_height, const video_format_t p_src)
	It configures blend filter parameters that are allowed to changed after the creation.
int	filter_Blend (filter_t , picture_t p_dst, int i_dst_x, int i_dst_y, const picture_t *p_src, int i_alpha)
	It blends a picture into another one.
void	filter_DeleteBlend (filter_t *)
	It destroys a blend filter created by filter_NewBlend.
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.
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.
void	filter_chain_VideoFlush (filter_chain_t *)
	Flush a video filter chain.
block_t *	filter_chain_AudioFilter (filter_chain_t , block_t )
	Apply the filter chain to a audio block.
void	filter_chain_SubSource (filter_chain_t *, mtime_t)
	Apply filter chain to subpictures.
subpicture_t *	filter_chain_SubFilter (filter_chain_t , subpicture_t )
	Apply filter chain to subpictures.
int	filter_chain_MouseFilter (filter_chain_t , vlc_mouse_t , const vlc_mouse_t *)
	Apply the filter chain to a mouse state.
int	filter_chain_MouseEvent (filter_chain_t , const vlc_mouse_t , const video_format_t *)
	Inform the filter chain of mouse state.

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 )

Referenced by spu_Create(), ThreadStart(), and VoutDisplayCreateRender().

#define filter_NewAudioBuffer block_New

#define pf_audio_filter u.audio.pf_filter

#define pf_render_html u.render.pf_html

#define pf_render_text u.render.pf_text

#define pf_sub_buffer_del u.sub.pf_buffer_del

#define pf_sub_buffer_new u.sub.pf_buffer_new

#define pf_sub_filter u.subf.pf_filter

#define pf_sub_mouse u.sub.pf_mouse

#define pf_sub_source u.sub.pf_source

#define pf_video_blend u.blend.pf_blend

#define pf_video_buffer_del u.video.pf_buffer_del

#define pf_video_buffer_new u.video.pf_buffer_new

#define pf_video_filter u.video.pf_filter

#define pf_video_flush u.video.pf_flush

#define pf_video_mouse u.video.pf_mouse

#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 )                                                  \
        {                                                               \
            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

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

int filter_Blend	(	filter_t *	,
		picture_t *	p_dst,
		int	i_dst_x,
		int	i_dst_y,
		const picture_t *	p_src,
		int	i_alpha
	)

It blends a picture into another one.

The input picture is not modified and not released.

References filter_t::p_module.

Referenced by picture_BlendSubpicture().

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

References filter_chain_AppendFilterInternal(), msg_Err, and UpdateBufferFunctions().

Referenced by ThreadChangeFilters(), and VoutDisplayCreateRender().

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

References filter_chain_AppendFromStringInternal(), and UpdateBufferFunctions().

Referenced by spu_PutSubpicture(), and spu_Render().

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

References filter_chain_t::first, and chained_filter_t::next.

void filter_chain_Delete ( filter_chain_t * p_chain )

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

References es_format_Clean(), filter_chain_Reset(), filter_chain_t::fmt_in, and filter_chain_t::fmt_out.

Referenced by spu_Destroy(), ThreadStop(), and VoutDisplayDestroyRender().

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

References filter_chain_DeleteFilterInternal(), and UpdateBufferFunctions().

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

References filter_chain_t::b_allow_fmt_out_change, chained_filter_t::filter, filter_t::fmt_out, filter_chain_t::fmt_out, and filter_chain_t::last.

Referenced by ThreadChangeFilters().

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

References filter_chain_t::length.

Referenced by spu_PutSubpicture(), vout_FilterDisplay(), and VoutVideoFilterStaticNewPicture().

int filter_chain_MouseEvent	(	filter_chain_t *	,
		const vlc_mouse_t *	,
		const video_format_t *
	)

Inform the filter chain of mouse state.

It makes sense only for a sub source chain.

References filter_chain_t::first, chained_filter_t::next, and VLC_EGENERIC.

Referenced by spu_ProcessMouse().

int filter_chain_MouseFilter	(	filter_chain_t *	,
		vlc_mouse_t *	,
		const vlc_mouse_t *
	)

Apply the filter chain to a mouse state.

It will be applied from the output to the input. It makes sense only for a video filter chain.

The vlc_mouse_t* pointers may be the same.

References filter_chain_t::last, chained_filter_t::prev, and VLC_EGENERIC.

Referenced by vout_SendDisplayEventMouse().

filter_chain_t* filter_chain_New	(	vlc_object_t *	p_this,
		const char *	psz_capability,
		bool	b_allow_fmt_out_change,
		int()(filter_t , void *)	pf_buffer_allocation_init,
		void()(filter_t )	pf_buffer_allocation_clean,
		void *	p_buffer_allocation_data
	)

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

References filter_chain_t::allocator, filter_chain_t::b_allow_fmt_out_change, es_format_Init(), filter_chain_t::first, filter_chain_t::fmt_in, filter_chain_t::fmt_out, filter_chain_t::last, filter_chain_t::length, filter_chain_allocator_t::p_data, filter_chain_t::p_this, filter_chain_allocator_t::pf_clean, filter_chain_allocator_t::pf_init, filter_chain_t::psz_capability, and UNKNOWN_ES.

void filter_chain_Reset	(	filter_chain_t *	p_chain,
		const es_format_t *	p_fmt_in,
		const es_format_t *	p_fmt_out
	)

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

References es_format_Clean(), es_format_Copy(), chained_filter_t::filter, filter_chain_DeleteFilterInternal(), filter_chain_t::first, filter_chain_t::fmt_in, and filter_chain_t::fmt_out.

Referenced by filter_chain_Delete(), spu_PutSubpicture(), spu_Render(), ThreadChangeFilters(), and VoutDisplayCreateRender().

subpicture_t* filter_chain_SubFilter	(	filter_chain_t *	,
		subpicture_t *
	)

Apply filter chain to subpictures.

Parameters:

	p_chain	pointer to filter chain
	p_subpicture	subpicture to apply filters on

Returns:: modified subpicture after applying all subpicture filters

References filter_chain_t::first, and chained_filter_t::next.

Referenced by spu_PutSubpicture().

void filter_chain_SubSource	(	filter_chain_t *	,
		mtime_t
	)

Apply filter chain to subpictures.

Parameters:

	p_chain	pointer to filter chain
	display_date	of subpictures

References filter_chain_t::first, chained_filter_t::next, filter_chain_t::p_this, and spu_PutSubpicture().

Referenced by spu_Render().

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

References FilterChainVideoFilter(), filter_chain_t::first, filter_chain_t::last, picture_t::p_next, and chained_filter_t::prev.

Referenced by ThreadDisplayPreparePicture(), ThreadDisplayRenderPicture(), and vout_FilterDisplay().

void filter_chain_VideoFlush ( filter_chain_t * )

Flush a video filter chain.

References filter_FlushPictures(), FilterDeletePictures(), filter_chain_t::first, and chained_filter_t::next.

Referenced by ThreadFilterFlush().

int filter_ConfigureBlend	(	filter_t *	,
		int	i_dst_width,
		int	i_dst_height,
		const video_format_t *	p_src
	)

It configures blend filter parameters that are allowed to changed after the creation.

References filter_t::fmt_in, filter_t::fmt_out, video_format_t::i_chroma, es_format_t::i_codec, video_format_t::i_height, video_format_t::i_visible_height, video_format_t::i_visible_width, video_format_t::i_width, module_need, module_unneed, filter_t::p_module, and es_format_t::video.

Referenced by picture_BlendSubpicture().

void filter_DeleteBlend ( filter_t * )

It destroys a blend filter created by filter_NewBlend.

References module_unneed, filter_t::p_module, and vlc_object_release.

Referenced by ThreadDisplayRenderPicture(), and ThreadStop().

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

Referenced by FilterDeletePictures().

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 void filter_FlushPictures ( filter_t * p_filter ) [inline, static]

This function will flush the state of a video filter.

Referenced by filter_chain_VideoFlush().

static int filter_GetInputAttachments	(	filter_t *	p_filter,
		input_attachment_t ***	ppp_attachment,
		int *	pi_attachment
	)			`[inline, static]`

This function gives all input attachments at once.

You MUST release the returned values

References filter_t::pf_get_attachments.

filter_t* filter_NewBlend	(	vlc_object_t *	,
		const video_format_t *	p_dst_chroma
	)

It creates a blend filter.

Only the chroma properties of the dest format is used (chroma type, rgb masks and shifts)

References es_format_Init(), filter_t::fmt_in, filter_t::fmt_out, video_format_t::i_bmask, video_format_t::i_chroma, es_format_t::i_codec, video_format_t::i_gmask, video_format_t::i_lbshift, video_format_t::i_lgshift, video_format_t::i_lrshift, video_format_t::i_rbshift, video_format_t::i_rgshift, video_format_t::i_rmask, video_format_t::i_rrshift, filter_t::p_module, es_format_t::video, VIDEO_ES, and vlc_custom_create.

Referenced by ThreadDisplayRenderPicture().

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

References msg_Warn.

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_source return value. Provided for convenience.

Parameters:

p_filter

filter_t object

Returns:: new subpicture

References msg_Warn.

vlc_filter.h File Reference

Data Structures

Defines

Typedefs

Functions

Detailed Description

Define Documentation

Typedef Documentation

Function Documentation