C# Class AForge.Imaging.Filters.Texturer

Texturer filter.

Adjust pixels’ color values using factors from the given texture. In conjunction with different type of texture generators, the filter may produce different type of interesting effects.

The filter uses specified texture to adjust values using the next formula:
dst = src * PreserveLevel + src * FilterLevel * textureValue,
where src is value of pixel in a source image, dst is value of pixel in a destination image and textureValue is corresponding value from provided texture (see TextureGenerator or Texture). Using PreserveLevel and FilterLevel values it is possible to control the portion of source data affected by texture.

In most cases the PreserveLevel and FilterLevel properties are set in such way, that PreserveLevel + FilterLevel = 1. But there is no limitations actually for those values, so their sum may be as greater, as lower than 1 in order create different type of effects.

The filter accepts 8 bpp grayscale and 24 bpp color images for processing.

Sample usage:

 // create filter Texturer filter = new Texturer( new TextileTexture( ), 0.3, 0.7 ); // apply the filter filter.ApplyInPlace( image );

Initial image:

Result image:

Inheritance: BaseInPlacePartialFilter

显示文件 Open project: holisticware-admin/MonoVersal.AForgeNET Class Usage Examples

Public Methods

Method	Description
Texturer ( AForge generator ) : System	Initializes a new instance of the Texturer class.
Texturer ( AForge generator, double filterLevel, double preserveLevel ) : System	Initializes a new instance of the Texturer class.
Texturer ( float texture ) : System	Initializes a new instance of the Texturer class.
Texturer ( float texture, double filterLevel, double preserveLevel ) : System	Initializes a new instance of the Texturer class.

Protected Methods

Method	Description
ProcessFilter ( UnmanagedImage image, Rectangle rect ) : void	Process the filter on the specified image.

Private Methods

Method	Description
Texturer ( ) : System

Method Details

ProcessFilter() protected method

Process the filter on the specified image.

protected ProcessFilter ( UnmanagedImage image, Rectangle rect ) : void
image	UnmanagedImage	Source image data.
rect	System.Drawing.Rectangle	Image rectangle for processing by the filter.
return	void

Texturer() public method

Initializes a new instance of the Texturer class.

public Texturer ( AForge generator ) : System
generator	AForge	Texture generator.
return	System

Texturer() public method

Initializes a new instance of the Texturer class.

public Texturer ( AForge generator, double filterLevel, double preserveLevel ) : System
generator	AForge	Texture generator.
filterLevel	double	Filter level value (see property).
preserveLevel	double	Preserve level value (see property).
return	System

Texturer() public method

Initializes a new instance of the Texturer class.

public Texturer ( float texture ) : System
texture	float	Generated texture.
return	System

Texturer() public method

Initializes a new instance of the Texturer class.

public Texturer ( float texture, double filterLevel, double preserveLevel ) : System
texture	float	Generated texture.
filterLevel	double	Filter level value (see property).
preserveLevel	double	Preserve level value (see property).
return	System