IlvColorMatrixFilter Class Reference

Color matrix filter. More...

#include <ilviews/bitmaps/filters/colmatrix.h>

Inheritance diagram for IlvColorMatrixFilter:

Public Member Functions
	IlvColorMatrixFilter (const IlFloat *values=0)
	Constructor. More...
	~IlvColorMatrixFilter ()
	Destructor. More...
IlvBitmapData *	apply (IlUInt count=0, const IlvBitmapData **inputs=0)
	Applies the color matrix to the given image.
const IlFloat *	getValues (IlUInt &count) const
	Returns the matrix coefficients. More...
void	setValues (const IlFloat *values)
	Sets the matrix coefficients. More...
void	setValues (IlFloat a00, IlFloat a01, IlFloat a02, IlFloat a03, IlFloat a04, IlFloat a10, IlFloat a11, IlFloat a12, IlFloat a13, IlFloat a14, IlFloat a20, IlFloat a21, IlFloat a22, IlFloat a23, IlFloat a24, IlFloat a30, IlFloat a31, IlFloat a32, IlFloat a33, IlFloat a34)
	Sets the matrix coefficients. More...
Public Member Functions inherited from IlvBitmapFilter
	IlvBitmapFilter ()
	Constructor. More...
virtual	~IlvBitmapFilter ()
	Destructor. 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.

Additional Inherited Members
Static Public Member Functions inherited from IlvBitmapFilter
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

Color matrix filter.

Library: ilvbmpflt

This bitmap filter lets you manipulate the color components of an image using a 5x4 matrix.

See Also

IlvRGBBitmapData, IlvBitmapFilter, IlvSaturationFilter, IlvLuminanceToAlphaFilter, IlvHueRotateFilter

Constructor & Destructor Documentation

IlvColorMatrixFilter::IlvColorMatrixFilter

(

const IlFloat *

values = 0

)

Constructor.

Initializes a new instance of the class IlvColorMatrixFilter. The matrix coefficients (if present) are set to the given values.

Parameters

values

An array of 20 floating point values.

IlvColorMatrixFilter::~IlvColorMatrixFilter

(

)

Destructor.

The destructor releases all the memory used by the instance.

Member Function Documentation

const IlFloat* IlvColorMatrixFilter::getValues

(

IlUInt &

count

)

const

Returns the matrix coefficients.

Parameters

count

The number of coefficients.

Returns

An array of count values.

void IlvColorMatrixFilter::setValues

(

const IlFloat *

values

)

Sets the matrix coefficients.

Parameters

values

An array of 20 values.

void IlvColorMatrixFilter::setValues	(	IlFloat	a00,
		IlFloat	a01,
		IlFloat	a02,
		IlFloat	a03,
		IlFloat	a04,
		IlFloat	a10,
		IlFloat	a11,
		IlFloat	a12,
		IlFloat	a13,
		IlFloat	a14,
		IlFloat	a20,
		IlFloat	a21,
		IlFloat	a22,
		IlFloat	a23,
		IlFloat	a24,
		IlFloat	a30,
		IlFloat	a31,
		IlFloat	a32,
		IlFloat	a33,
		IlFloat	a34
	)

Sets the matrix coefficients.

Parameters

a00	(through a34) The matrix coefficients.