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
Show file 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