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

Inheritance diagram for IlvBitmapDataKernel:

Public Types
enum	KernelHint { Normal, Nice }
	This enumeration defines the possible values for the hint. More...

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

	IlvBitmapDataKernel (IlUInt width, IlUInt height, const char *values)
	Constructor. More...

	IlvBitmapDataKernel (IlUInt width, IlUInt height, const IlFloat *values)
	Constructor. More...

virtual	~IlvBitmapDataKernel ()
	Destructor. More...

IlUInt	getHeight () const
	Returns the height of the kernel. More...

KernelHint	getHints () const
	Returns the hints of the kernel. More...

const char *	getKernelString ()
	Returns a string representation of the kernel. More...

const IlFloat *	getKernelValues (IlUInt &width, IlUInt &height) const
	Returns an array of floating point values representing the kernel. More...

IlUInt	getWidth () const
	Returns the width of the kernel. More...

void	setHeight (IlUInt height)
	Sets the height of the kernel. More...

void	setHints (KernelHint hints)
	Sets the given hints. More...

void	setKernelString (const char *values)

void	setValues (IlUInt width, IlUInt height, const char *values)

void	setValues (IlUInt width, IlUInt height, const IlFloat *values)
	Sets the kernel values using an array of floating point values. More...

void	setWidth (IlUInt width)
	Sets the width of the kernel. More...

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 const char *	getName () const
	Returns the name of the instance. The semantic and implementation of this method are defined by concrete subclasses. The default implementation returns `0`. 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...

Detailed Description

Kernel.

Library: ilvbmpflt

This class lets you manipulate kernels. A kernel is an m x n matrix. It is mainly used by the IlvConvolutionFilter.

For the Arithmetic operator each pixel is computed as follows:

result = k1 * c1 * c2 + k2 * c1 + k3 * c2 + k4
k1, k2, k3, and k4 can be specified.

See also: IlvRGBBitmapData, IlvBitmapFilter, IlvConvolutionFilter, IlvGaussianBlurFilter

Member Enumeration Documentation

◆ KernelHint

enum IlvBitmapDataKernel::KernelHint

This enumeration defines the possible values for the hint.

Enumerator
Normal	No particular hint.
Nice	The kernel has positive values and the divisor is the sum of the coefficients.

Constructor & Destructor Documentation

◆ IlvBitmapDataKernel() [1/3]

IlvBitmapDataKernel::IlvBitmapDataKernel ( )

Constructor.

Initializes a new instance of the class IlvBitmapDataKernel.

◆ IlvBitmapDataKernel() [2/3]

IlvBitmapDataKernel::IlvBitmapDataKernel	(	IlUInt	width,
		IlUInt	height,
		const IlFloat *	values
	)

Constructor.

Initializes a new instance of the class IlvBitmapDataKernel using an array of floating point values.

Parameters

width	The width (columns) of the kernel.
height	The height (rows) of the kernel.
values	An array of width x height values.

◆ IlvBitmapDataKernel() [3/3]

IlvBitmapDataKernel::IlvBitmapDataKernel	(	IlUInt	width,
		IlUInt	height,
		const char *	values
	)

Constructor.

Initializes a new instance of the class IlvBitmapDataKernel using a string representing the values, separated by 'space' or ','. For example: "1 1 1 1 2 1 1 1 1" is a simple blurring kernel.

Parameters

width	The width (columns) of the kernel.
height	The height (rows) of the kernel.
values	A string representing the values.

◆ ~IlvBitmapDataKernel()

virtual IlvBitmapDataKernel::~IlvBitmapDataKernel ( )

virtual

Destructor.

The destructor releases all the memory used by the instance.

Member Function Documentation

◆ getHeight()

IlUInt IlvBitmapDataKernel::getHeight ( ) const

Returns the height of the kernel.

Returns: The height of the kernel.

◆ getHints()

KernelHint IlvBitmapDataKernel::getHints ( ) const

Returns the hints of the kernel.

Returns: The hints of the kernel.

◆ getKernelString()

const char* IlvBitmapDataKernel::getKernelString ( )

Returns a string representation of the kernel.

Returns: A string representation of the kernel.

◆ getKernelValues()

const IlFloat* IlvBitmapDataKernel::getKernelValues	(	IlUInt &	width,
		IlUInt &	height
	)		const

Returns an array of floating point values representing the kernel.

Parameters

width	The width of the kernel.
height	The height of the kernel.

Returns: An array of width x height values.

◆ getWidth()

IlUInt IlvBitmapDataKernel::getWidth ( ) const

Returns the width of the kernel.

Returns: The width of the kernel.

◆ setHeight()

void IlvBitmapDataKernel::setHeight ( IlUInt height )

Sets the height of the kernel.

Parameters

height The new height of the kernel.

◆ setHints()

void IlvBitmapDataKernel::setHints ( KernelHint hints )

Sets the given hints.

Parameters

hints The new kernel hints.

◆ setKernelString()

void IlvBitmapDataKernel::setKernelString ( const char * values )

Sets the kernel values using a string representation.

Parameters

values The string representation of the new kernel.

◆ setValues() [1/2]

void IlvBitmapDataKernel::setValues	(	IlUInt	width,
		IlUInt	height,
		const char *	values
	)

short Sets the kernel values using a string representation.

Parameters

width	The width (columns) of the kernel.
height	The height (rows) of the kernel.
values	A string representing the values.

◆ setValues() [2/2]

void IlvBitmapDataKernel::setValues	(	IlUInt	width,
		IlUInt	height,
		const IlFloat *	values
	)

Sets the kernel values using an array of floating point values.

Parameters

width	The width (columns) of the kernel.
height	The height (rows) of the kernel.
values	An array of width x height values.

◆ setWidth()

void IlvBitmapDataKernel::setWidth ( IlUInt width )

Sets the width of the kernel.

Parameters

width The new width of the kernel.

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ KernelHint

Constructor & Destructor Documentation

◆ IlvBitmapDataKernel() [1/3]

◆ IlvBitmapDataKernel() [2/3]

◆ IlvBitmapDataKernel() [3/3]

◆ ~IlvBitmapDataKernel()

Member Function Documentation

◆ getHeight()

◆ getHints()

◆ getKernelString()

◆ getKernelValues()

◆ getWidth()

◆ setHeight()

◆ setHints()

◆ setKernelString()

◆ setValues() [1/2]

◆ setValues() [2/2]

◆ setWidth()