C# Class AForge.Imaging.Filters.BaseUsingCopyPartialFilter

Base class for filters, which require source image backup to make them applicable to source image (or its part) directly.

The base class is used for filters, which can not do direct manipulations with source image. To make effect of in-place filtering, these filters create a background copy of the original image (done by this base class) and then do manipulations with it putting result back to the original source image.

The background copy of the source image is created only in the case of in-place filtering. Otherwise background copy is not created - source image is processed and result is put to destination image.

The base class is for those filters, which support as filtering entire image, as partial filtering of specified rectangle only.

Inheritance: IFilter, IInPlaceFilter, IInPlacePartialFilter, IFilterInformation

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

Public Methods

Method	Description
Apply ( Bitmap image ) : Bitmap	Apply filter to an image. The method keeps the source image unchanged and returns the result of image processing filter as new image.
Apply ( BitmapData imageData ) : Bitmap	Apply filter to an image. The filter accepts bitmap data as input and returns the result of image processing filter as new image. The source image data are kept unchanged.
Apply ( UnmanagedImage image ) : UnmanagedImage	Apply filter to an image in unmanaged memory. The method keeps the source image unchanged and returns the result of image processing filter as new image.
Apply ( UnmanagedImage sourceImage, UnmanagedImage destinationImage ) : void	Apply filter to an image in unmanaged memory. The method keeps the source image unchanged and puts result of image processing into destination image. The destination image must have the same width and height as source image. Also destination image must have pixel format, which is expected by particular filter (see FormatTranslations property for information about pixel format conversions).
ApplyInPlace ( Bitmap image ) : void	Apply filter to an image. The method applies the filter directly to the provided source image.
ApplyInPlace ( Bitmap image, Rectangle rect ) : void	Apply filter to an image or its part. The method applies the filter directly to the provided source image.
ApplyInPlace ( BitmapData imageData ) : void	Apply filter to an image. The method applies the filter directly to the provided source image.
ApplyInPlace ( BitmapData imageData, Rectangle rect ) : void	Apply filter to an image or its part. The method applies the filter directly to the provided source image.
ApplyInPlace ( UnmanagedImage image ) : void	Apply filter to an unmanaged image. The method applies the filter directly to the provided source unmanaged image.
ApplyInPlace ( UnmanagedImage image, Rectangle rect ) : void	Apply filter to an unmanaged image or its part. The method applies the filter directly to the provided source image.

Protected Methods

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

Private Methods

Method	Description
CheckSourceFormat ( PixelFormat pixelFormat ) : void

Method Details

Apply() public method

Apply filter to an image.

The method keeps the source image unchanged and returns the result of image processing filter as new image.

Unsupported pixel format of the source image.

public Apply ( Bitmap image ) : Bitmap
image	System.Drawing.Bitmap	Source image to apply filter to.
return	System.Drawing.Bitmap

Apply() public method

Apply filter to an image.

The filter accepts bitmap data as input and returns the result of image processing filter as new image. The source image data are kept unchanged.

Unsupported pixel format of the source image.

public Apply ( BitmapData imageData ) : Bitmap
imageData	System.Drawing.Imaging.BitmapData	Source image to apply filter to.
return	System.Drawing.Bitmap

Apply() public method

Apply filter to an image in unmanaged memory.

The method keeps the source image unchanged and returns the result of image processing filter as new image.

Unsupported pixel format of the source image.

public Apply ( UnmanagedImage image ) : UnmanagedImage
image	UnmanagedImage	Source image in unmanaged memory to apply filter to.
return	UnmanagedImage

Apply() public method

Apply filter to an image in unmanaged memory.

The method keeps the source image unchanged and puts result of image processing into destination image.

The destination image must have the same width and height as source image. Also destination image must have pixel format, which is expected by particular filter (see FormatTranslations property for information about pixel format conversions).

Unsupported pixel format of the source image. Incorrect destination pixel format. Destination image has wrong width and/or height.

public Apply ( UnmanagedImage sourceImage, UnmanagedImage destinationImage ) : void
sourceImage	UnmanagedImage	Source image in unmanaged memory to apply filter to.
destinationImage	UnmanagedImage	Destination image in unmanaged memory to put result into.
return	void

ApplyInPlace() public method

Apply filter to an image.

The method applies the filter directly to the provided source image.

Unsupported pixel format of the source image.

public ApplyInPlace ( Bitmap image ) : void
image	System.Drawing.Bitmap	Image to apply filter to.
return	void

ApplyInPlace() public method

Apply filter to an image or its part.

The method applies the filter directly to the provided source image.

Unsupported pixel format of the source image.

public ApplyInPlace ( Bitmap image, Rectangle rect ) : void
image	System.Drawing.Bitmap	Image to apply filter to.
rect	System.Drawing.Rectangle	Image rectangle for processing by the filter.
return	void

ApplyInPlace() public method

Apply filter to an image.

The method applies the filter directly to the provided source image.

Unsupported pixel format of the source image.

public ApplyInPlace ( BitmapData imageData ) : void
imageData	System.Drawing.Imaging.BitmapData	Image data to apply filter to.
return	void

ApplyInPlace() public method

Apply filter to an image or its part.

The method applies the filter directly to the provided source image.

Unsupported pixel format of the source image.

public ApplyInPlace ( BitmapData imageData, Rectangle rect ) : void
imageData	System.Drawing.Imaging.BitmapData	Image data to apply filter to.
rect	System.Drawing.Rectangle	Image rectangle for processing by the filter.
return	void

ApplyInPlace() public method

Apply filter to an unmanaged image.

The method applies the filter directly to the provided source unmanaged image.

Unsupported pixel format of the source image.

public ApplyInPlace ( UnmanagedImage image ) : void
image	UnmanagedImage	Unmanaged image to apply filter to.
return	void

ApplyInPlace() public method

Apply filter to an unmanaged image or its part.

The method applies the filter directly to the provided source image.

Unsupported pixel format of the source image.

public ApplyInPlace ( UnmanagedImage image, Rectangle rect ) : void
image	UnmanagedImage	Unmanaged image to apply filter to.
rect	System.Drawing.Rectangle	Image rectangle for processing by the filter.
return	void

ProcessFilter() protected abstract method

Process the filter on the specified image.

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