Texturer Class

Texturer filter.

Inheritance Hierarchy

SystemObject
Accord.Imaging.FiltersBaseInPlacePartialFilter
Accord.Imaging.FiltersTexturer

Namespace: Accord.Imaging.Filters
Assembly: Accord.Imaging (in Accord.Imaging.dll) Version: 3.8.0

Syntax

Copy

public class Texturer : BaseInPlacePartialFilter

Public Class Texturer
	Inherits BaseInPlacePartialFilter

Request Example View Source

The Texturer type exposes the following members.

Constructors

	Name	Description
	Texturer(Single)	Initializes a new instance of the Texturer class.
	Texturer(ITextureGenerator)	Initializes a new instance of the Texturer class.
	Texturer(Single, Double, Double)	Initializes a new instance of the Texturer class.
	Texturer(ITextureGenerator, Double, Double)	Initializes a new instance of the Texturer class.

Top

Properties

	Name	Description
	FilterLevel	Filter level value.
	FormatTranslations	Format translations dictionary. (Overrides BaseInPlacePartialFilterFormatTranslations.)
	PreserveLevel	Preserve level value.
	Texture	Generated texture.
	TextureGenerator	Texture generator.

Top

Methods

	Name	Description
	Apply(Bitmap)	Apply filter to an image. (Inherited from BaseInPlacePartialFilter.)
	Apply(BitmapData)	Apply filter to an image. (Inherited from BaseInPlacePartialFilter.)
	Apply(UnmanagedImage)	Apply filter to an image in unmanaged memory. (Inherited from BaseInPlacePartialFilter.)
	Apply(UnmanagedImage, UnmanagedImage)	Apply filter to an image in unmanaged memory. (Inherited from BaseInPlacePartialFilter.)
	ApplyInPlace(Bitmap)	Apply filter to an image. (Inherited from BaseInPlacePartialFilter.)
	ApplyInPlace(BitmapData)	Apply filter to an image. (Inherited from BaseInPlacePartialFilter.)
	ApplyInPlace(UnmanagedImage)	Apply filter to an unmanaged image. (Inherited from BaseInPlacePartialFilter.)
	ApplyInPlace(Bitmap, Rectangle)	Apply filter to an image or its part. (Inherited from BaseInPlacePartialFilter.)
	ApplyInPlace(BitmapData, Rectangle)	Apply filter to an image or its part. (Inherited from BaseInPlacePartialFilter.)
	ApplyInPlace(UnmanagedImage, Rectangle)	Apply filter to an unmanaged image or its part. (Inherited from BaseInPlacePartialFilter.)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ProcessFilter	Process the filter on the specified image. (Overrides BaseInPlacePartialFilterProcessFilter(UnmanagedImage, Rectangle).)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Extension Methods

	Name	Description
	HasMethod	Checks whether an object implements a method with the given name. (Defined by ExtensionMethods.)
	IsEqual	Compares two objects for equality, performing an elementwise comparison if the elements are vectors or matrices. (Defined by Matrix.)
	To(Type)	Overloaded. Converts an object into another type, irrespective of whether the conversion can be done at compile time or not. This can be used to convert generic types to numeric types during runtime. (Defined by ExtensionMethods.)
	ToT	Overloaded. Converts an object into another type, irrespective of whether the conversion can be done at compile time or not. This can be used to convert generic types to numeric types during runtime. (Defined by ExtensionMethods.)

Top

Remarks

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:

Copy

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

Initial image:

Result image:

Reference

Accord.Imaging.Filters Namespace