Bitmap filter base class. More...

#include <ilviews/bitmaps/filter.h>

Inheritance diagram for IlvBitmapFilter:

Public Member Functions
	IlvBitmapFilter ()
	Constructor. More...

virtual	~IlvBitmapFilter ()
	Destructor. More...

virtual IlvBitmapData *	apply (IlUInt count=0, const IlvBitmapData **datas=0)
	Applies the filter to the given inputs. More...

IlvBitmapData *	applyUnary (const IlvBitmapData *data)
	Convenience method for unary filters. More...

virtual const char *	getClassName () const
	Returns the class name of the filter. More...

IlUInt	getHeight () const
	Returns the height of the filter effect region. More...

const char const	getInputs (IlUInt &count) const
	Returns the name of the input bitmap data. More...

const char *	getName () const
	Returns the name of the filter. More...

IlUInt	getRefCount () const
	Returns the reference count for this instance.

const char *	getResult () const
	Returns the name of the result bitmap data. More...

IlUInt	getWidth () const
	Returns the width of the filter effect region. More...

IlInt	getX () const
	Returns the left coordinate of the filter effect region. More...

IlInt	getY () const
	Returns the top coordinate of the filter effect region. More...

void	lock ()
	Locks the current instance.

void	setHeight (IlUInt height)
	Sets the height of the filter effect region. More...

void	setInputs (IlUInt count, const char const name)
	Sets the input names of the filter. More...

void	setName (const char *id)
	Sets the name of the filter. More...

void	setResult (const char *name)
	Sets the result name of the filter. More...

void	setWidth (IlUInt width)
	Sets the width of the filter effect region. More...

void	setX (IlInt x)
	Sets the left coordinate of the filter effect region. More...

void	setY (IlInt y)
	Sets the top coordinate of the filter effect region. More...

void	unLock ()
	Unlocks the current instance. When the reference count is `0`, the instance is deleted.

Public Member Functions inherited from IlvValueInterface
virtual IlBoolean	applyValue (const IlvValue &value)
	Apply an accessor. More...

virtual IlBoolean	changeValue (const IlvValue &val)
	Changes the value of an accessor. More...

virtual IlBoolean	changeValues (const IlvValue *values, IlUShort count=0)
	Changes several accessor values simultaneously. More...

virtual void	getAccessors (const IlSymbol const names, const IlvValueTypeClass const **types, IlUInt &count) const
	Retrieves the list of available accessors of an object. More...

virtual IlvValue &	queryValue (IlvValue &val) const
	Retrieves an accessor value. More...

virtual void	queryValues (IlvValue *values, IlUShort count) const
	Retrieves multiple accessor values simultaneously. More...

Static Public Member Functions
static IlvBitmapFilter *	Create (const char *classname, IlBoolean forceLoad=IlTrue)
	This static method creates an instance of a bitmap filter of given classname. If the filter class is not registered and forceLoad is `IlTrue`, an attempt to load a dynamic module for this filter is made. More...

static const char **	GetRegisteredFilters (IlUInt &num)
	This static method returns an array of registered filter class names. More...

Detailed Description

Bitmap filter base class.

Library: xviews or winviews or mviews (mutually exclusive)

The bitmap filter lets you manipulate bitmap data. This class provides general attribute management and must be subclassed. Each filter exposes its input and output bitmap data using names. The class IlvFilterFlow manages a list of filters and a list of bitmap data items.

See also: IlvRGBBitmapData, IlvFilterFlow

Constructor & Destructor Documentation

◆ IlvBitmapFilter()

IlvBitmapFilter::IlvBitmapFilter ( )

Constructor.

Initializes a new IlvBitmapFilter.

◆ ~IlvBitmapFilter()

virtual IlvBitmapFilter::~IlvBitmapFilter ( )

virtual

Destructor.

The destructor releases all the memory used by the instance.

Member Function Documentation

◆ apply()

virtual IlvBitmapData* IlvBitmapFilter::apply	(	IlUInt	count = `0`,
		const IlvBitmapData **	datas = `0`
	)

virtual

Applies the filter to the given inputs.

Parameters

count	The number of inputs.
datas	An array of count `IlvBitmapData` instances.

Returns: The resulting bitmap data.

Reimplemented in IlvTileFilter, IlvOffsetFilter, IlvMorphologyFilter, IlvMergeFilter, IlvSpecularLightingFilter, IlvDiffuseLightingFilter, IlvImageFilter, IlvGaussianBlurFilter, IlvFloodFilter, IlvDisplaceFilter, IlvConvolutionFilter, IlvComposeFilter, IlvComponentTransferFilter, IlvColorMatrixFilter, IlvFilterFlow, IlvTurbulenceFilter, and IlvBlendFilter.

◆ applyUnary()

IlvBitmapData* IlvBitmapFilter::applyUnary ( const IlvBitmapData * data )

Convenience method for unary filters.

Parameters

data	The bitmap data to apply the filter on.

Returns: The resulting bitmap data.

◆ Create()

static IlvBitmapFilter* IlvBitmapFilter::Create	(	const char *	classname,
		IlBoolean	forceLoad = `IlTrue`
	)

static

This static method creates an instance of a bitmap filter of given classname. If the filter class is not registered and forceLoad is IlTrue, an attempt to load a dynamic module for this filter is made.

Parameters

classname	The class name of the filter.
forceLoad	`IlTrue` if dynamic loading is attempted.

Returns: A pointer to the created bitmap filter.

◆ getClassName()

virtual const char* IlvBitmapFilter::getClassName ( ) const

virtual

Returns the class name of the filter.

Returns: The class name of the filter.

◆ getHeight()

IlUInt IlvBitmapFilter::getHeight ( ) const

Returns the height of the filter effect region.

Returns: The height of the filter effect region.

◆ getInputs()

const char* const* IlvBitmapFilter::getInputs ( IlUInt & count ) const

Returns the name of the input bitmap data.

Parameters

count The number of input names.

Returns: An array of input names.

◆ getName()

const char* IlvBitmapFilter::getName ( ) const

virtual

Returns the name of the filter.

Returns: The name of the filter.

Reimplemented from IlvValueInterface.

◆ GetRegisteredFilters()

static const char** IlvBitmapFilter::GetRegisteredFilters ( IlUInt & num )

static

This static method returns an array of registered filter class names.

Parameters

num	The size of the returned array.

Returns: An array of class names.

◆ getResult()

const char* IlvBitmapFilter::getResult ( ) const

Returns the name of the result bitmap data.

Returns: The name of the result bitmap data.

◆ getWidth()

IlUInt IlvBitmapFilter::getWidth ( ) const

Returns the width of the filter effect region.

Returns: The width of the filter effect region.

◆ getX()

IlInt IlvBitmapFilter::getX ( ) const

Returns the left coordinate of the filter effect region.

Returns: The left coordinate of the filter effect region.

◆ getY()

IlInt IlvBitmapFilter::getY ( ) const

Returns the top coordinate of the filter effect region.

Returns: The top coordinate of the filter effect region.

◆ setHeight()

void IlvBitmapFilter::setHeight ( IlUInt height )

Sets the height of the filter effect region.

Parameters

height The height of the filter effect region

◆ setInputs()

void IlvBitmapFilter::setInputs	(	IlUInt	count,
		const char const	name
	)

Sets the input names of the filter.

Parameters

count	The number of input names.
name	The names of the input bitmap data.

◆ setName()

void IlvBitmapFilter::setName ( const char * id )

Sets the name of the filter.

Parameters

id	The new name of the filter.

◆ setResult()

void IlvBitmapFilter::setResult ( const char * name )

Sets the result name of the filter.

Parameters

name	The new name of the result bitmap data.

◆ setWidth()

void IlvBitmapFilter::setWidth ( IlUInt width )

Sets the width of the filter effect region.

Parameters

width The width of the filter effect region.

◆ setX()

void IlvBitmapFilter::setX ( IlInt x )

Sets the left coordinate of the filter effect region.

Parameters

x	The left coordinate of the filter effect region.

◆ setY()

void IlvBitmapFilter::setY ( IlInt y )

Sets the top coordinate of the filter effect region.

Parameters

y	The top coordinate of the filter effect region.

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ IlvBitmapFilter()

◆ ~IlvBitmapFilter()

Member Function Documentation

◆ apply()

◆ applyUnary()

◆ Create()

◆ getClassName()

◆ getHeight()

◆ getInputs()

◆ getName()

◆ GetRegisteredFilters()

◆ getResult()

◆ getWidth()

◆ getX()

◆ getY()

◆ setHeight()

◆ setInputs()

◆ setName()

◆ setResult()

◆ setWidth()

◆ setX()

◆ setY()