import"nodejs.idl";

Public Member Functions
void	remove ()

void	update (DOMString name, DOMString value)

void	set_source (_Filter src, DOMString link_args=null)

void	set_source_restricted (_Filter src, DOMString link_args=null)

void	insert (_Filter f, long pid_idx=-1, DOMString link_args=null)

void	reconnect (long pid_idx=-1)

DOMString	probe_link (long pid_idx, DOMString name)

DOMString	get_destinations (long pid_idx=-1)

PropertyValue	ipid_prop (unsigned long idx, DOMString prop_name)

void	ipid_enum_props (unsigned long idx, function callback_fun)

PropertyValue	opid_prop (unsigned long idx, DOMString prop_name)

void	opid_enum_props (unsigned long idx, function callback_fun)

PidStatistics	ipid_stats (unsigned long idx, unsigned long mode=0)

PidStatistics	opid_stats (unsigned long idx, unsigned long mode=0)

_Filter	ipid_source (unsigned long idx)

Array	opid_sinks (unsigned long idx)

Array	all_args ()

PropertyValue	get_info (DOMString info_name)

FilterStatistics	get_statistics ()

void	require_source_id ()

void	bind (object interf)

Data Fields
attribute readonly DOMString	name

attribute readonly DOMString	ID

attribute readonly unsigned long	nb_ipid

attribute readonly unsigned long	nb_opid

Detailed Description

Filter object

Member Function Documentation

◆ remove()

void _Filter::remove ( )

remove this filter - see gf_filter_remove

◆ update()

void _Filter::update	(	DOMString	name,
		DOMString	value
	)

send option update to this filter - see gf_fs_send_update

Parameters

name	name of option
value	value of option

◆ set_source()

void _Filter::set_source	(	_Filter	src,
		DOMString	link_args = `null`
	)

set a given filter as source for this filter - see gf_filter_set_source

Note: Setting a source will force the filter session linker to run in explicit linking mode.

Parameters

src	source filter
link_args	link options

◆ set_source_restricted()

void _Filter::set_source_restricted	(	_Filter	src,
		DOMString	link_args = `null`
	)

set a given filter as restricted source for this filter - see gf_filter_set_source_restricted

Note: Setting a source will force the filter session linker to run in explicit linking mode.

Parameters

src	source filter
link_args	link options

◆ insert()

void _Filter::insert	(	_Filter	f,
		long	pid_idx = `-1`,
		DOMString	link_args = `null`
	)

insert a given filter after this filter - see gf_filter_set_source and gf_filter_reconnect_output

Parameters

f	_Filter to insert
pid_idx	index of pid to relink, negative value means all output pids
link_args	link options

◆ reconnect()

void _Filter::reconnect ( long pid_idx = -1 )

reconnect the filter output - see gf_filter_set_source and gf_filter_reconnect_output

Parameters

pid_idx index of output pid to reconnect, -1 for all pids

◆ probe_link()

DOMString _Filter::probe_link	(	long	pid_idx,
		DOMString	name
	)

Resolves link from given output pid of filter to a filter description. The described filter is not loaded in the graph - see gf_filter_probe_link

Parameters

pid_idx	0-based index of the output pid
name	filter description to link to; this can be any filter description

Returns: comma-spearated string list of the filter names in the resolved chain from current filter to destination

◆ get_destinations()

DOMString _Filter::get_destinations ( long pid_idx = -1 )

Gets all possible destination filter for this filter or one of its output PID - see gf_filter_get_possible_destinations

Parameters

pid_idx 0-based index of the output pid, use -1 to check all output pids

Returns: None if no possible connections to known filter, or a comma-separated string list containing all possible direct connections

◆ ipid_prop()

PropertyValue _Filter::ipid_prop	(	unsigned long	idx,
		DOMString	prop_name
	)

get an input pid property by name

Parameters

idx	index of input pid
prop_name	name of property

Returns: property value or None if not found

◆ ipid_enum_props()

void _Filter::ipid_enum_props	(	unsigned long	idx,
		function	callback_fun
	)

enumerate an input pid properties

Parameters

idx	index of input pid
callback_fun	callback function taking three parameters, prop_name (string), propval (PropertyValue) and proptype (int, GPAC property data type)

◆ opid_prop()

PropertyValue _Filter::opid_prop	(	unsigned long	idx,
		DOMString	prop_name
	)

get an output pid property by name

Parameters

idx	index of output pid
prop_name	name of property

Returns: property value or null if not found

◆ opid_enum_props()

void _Filter::opid_enum_props	(	unsigned long	idx,
		function	callback_fun
	)

enumerate an output pid properties

Parameters

idx	index of output pid
callback_fun	callback function taking three parameters, prop_name (string), propval (PPropertyValue) and proptype (int, GPAC property data type)

◆ ipid_stats()

PidStatistics _Filter::ipid_stats	(	unsigned long	idx,
		unsigned long	mode = `0`
	)

get statistics on input pid

Parameters

idx	index of input pid
mode	search mode for stats (one of GF_STATS_XXX)

Returns: stats or null if error

◆ opid_stats()

PidStatistics _Filter::opid_stats	(	unsigned long	idx,
		unsigned long	mode = `0`
	)

get statistics on output pid

Parameters

idx	index of input pid
mode	search mode for stats (one of GF_STATS_XXX)

Returns: stats or null if error

◆ ipid_source()

_Filter _Filter::ipid_source ( unsigned long idx )

gets the filter at the source of an input pid

Parameters

idx	index of input PID

Returns: filter or null if error

◆ opid_sinks()

Array _Filter::opid_sinks ( unsigned long idx )

gets the list of destination filters of an output pid

Parameters

idx	index of output PID

Returns: list of _Filter

◆ all_args()

Array _Filter::all_args ( )

gets all defined options / arguments for a filter

Returns: list of FilterArg

◆ get_info()

PropertyValue _Filter::get_info ( DOMString info_name )

gets a property info on a filter - see gf_filter_get_info and gf_filter_get_info_str

Parameters

info_name property to query

Returns: property value or None if not found

◆ get_statistics()

FilterStatistics _Filter::get_statistics ( )

gets the statistics of a filter - see gf_filter_get_stats

Returns: stats object

◆ require_source_id()

void _Filter::require_source_id ( )

enforces sourceID to be present for output pids of this filter - see gf_filter_require_source_id

◆ bind()

void _Filter::bind ( object interf )

Binds the given object to the underlying filter for callbacks override - only supported by DASH demuxer and httpout for the current time

For DASH, the object must implement the methods of the _DASHCustomAlgorithm interface For DASH, the object must implement the methods of the _HTTPRequestHandler interface

Parameters

interf interface object to bind

Field Documentation

◆ name

attribute readonly DOMString _Filter::name

name of the filter, readonly - see gf_filter_get_name

◆ ID

attribute readonly DOMString _Filter::ID

ID of the filter, readonly - see gf_filter_get_id

◆ nb_ipid

attribute readonly unsigned long _Filter::nb_ipid

number of input pids for that filter, readonly - see gf_filter_get_ipid_count

◆ nb_opid

attribute readonly unsigned long _Filter::nb_opid

number of output pids for that filter, readonly - see gf_filter_get_opid_count

Public Member Functions

Data Fields

Detailed Description

Member Function Documentation

◆ remove()

◆ update()

◆ set_source()

◆ set_source_restricted()

◆ insert()

◆ reconnect()

◆ probe_link()

◆ get_destinations()

◆ ipid_prop()

◆ ipid_enum_props()

◆ opid_prop()

◆ opid_enum_props()

◆ ipid_stats()

◆ opid_stats()

◆ ipid_source()

◆ opid_sinks()

◆ all_args()

◆ get_info()

◆ get_statistics()

◆ require_source_id()

◆ bind()

Field Documentation

◆ name

◆ ID

◆ nb_ipid

◆ nb_opid