PreprocessingFilter (ocr 25.9.0 API)

java.lang.Object
- com.aspose.ocr.PreprocessingFilter

```
public class PreprocessingFilter
extends Object
```
Base class for image processing commands.

Author:

Aspose

Field Summary

Fields
Modifier and Type Field and Description

static PreprocessingFilter Empty

Fields
Modifier and Type	Field and Description
`static PreprocessingFilter`	`Empty`

Constructor Summary

Constructors
Constructor and Description

PreprocessingFilter()

Constructors
Constructor and Description
`PreprocessingFilter()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(PreprocessingFilter filter)` Add the new filter to the collection to further run all operations.
`static PreprocessingFilter`	`AutoDenoising()` Enables the use of an additional neural network to improve the image - reduce noise.
`static PreprocessingFilter`	`AutoDenoising(Rectangle area)` Enables the use of an additional neural network to improve the part of the image - reduce noise.
`static PreprocessingFilter`	`AutoDewarping()` Automatically corrects geometric distortions in the image.
`static PreprocessingFilter`	`AutoSkew()` Enables the automatic image skew correction.
`static PreprocessingFilter`	`AutoSkew(Rectangle area)` Enables the automatic image part skew correction.
`static PreprocessingFilter`	`Binarize()` Converts an image to black-and-white image.
`static PreprocessingFilter`	`Binarize(Rectangle area)` Converts a part of the image to black-and-white image.
`static PreprocessingFilter`	`BinarizeAndDilate()` Dilation adds pixels to the boundaries of objects in an image.
`static PreprocessingFilter`	`BinarizeAndDilate(Rectangle area)` Dilation adds pixels to the boundaries of objects in a part of the image.
`static PreprocessingFilter`	`ContrastCorrection()` Contrast correction filter.
`static PreprocessingFilter`	`ContrastCorrection(Rectangle area)` Contrast correction filter for the part of the image.
`static PreprocessingFilter`	`Invert()` Automatically inverts colors in a document image.
`static PreprocessingFilter`	`Invert(Rectangle area)` Automatically inverts colors in a part of the image.
`static PreprocessingFilter`	`Median()` The median filter run through each element of the image and replace each pixel with the median of its neighboring pixels.
`static PreprocessingFilter`	`Median(Rectangle area)` The median filter run through each element of the part of the image and replace each pixel with the median of its neighboring pixels.
`static PreprocessingFilter`	`Resize(int width, int height)` Rescale image - Upscale or downscale image resolution.
`static PreprocessingFilter`	`Resize(int width, int height, InterpolationFilterType type)` Rescale image - upscale or downscale image resolution.
`static PreprocessingFilter`	`Rotate(float angle)` Rotate original image.
`static PreprocessingFilter`	`Rotate(float angle, Rectangle area)` Rotate the part of the image.
`static PreprocessingFilter`	`Scale(float ratio)` Rescale image - Upscale or downscale image resolution.
`static PreprocessingFilter`	`Scale(float ratio, InterpolationFilterType type)` Rescale image - Upscale or downscale image resolution.
`static PreprocessingFilter`	`Threshold(int value)` Create a binary image based on setting a threshold value on the pixel intensity of the original image.
`static PreprocessingFilter`	`Threshold(int value, Rectangle area)` Create a binary image part based on setting a threshold value on the pixel intensity of the original image part.
`static PreprocessingFilter`	`ToGrayscale()` Converts an image to grayscale image.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - Empty
```
public static final PreprocessingFilter Empty
```
- Constructor Detail
  - PreprocessingFilter
```
public PreprocessingFilter()
```
- Method Detail
  - Binarize
```
public static PreprocessingFilter Binarize()
```
    Converts an image to black-and-white image. Binary images are images whose pixels have only two possible intensity values. They are normally displayed as black and white. Numerically, the two values are often 0 for black, and 255 for white. Binary images are produced by auto thresholding an image.
    
    Returns:
    
    BinarizeFilter object.
  - Binarize
```
public static PreprocessingFilter Binarize(Rectangle area)
```
    Converts a part of the image to black-and-white image. Binary images are images whose pixels have only two possible intensity values. They are normally displayed as black and white. Numerically, the two values are often 0 for black, and 255 for white. Binary images are produced by auto thresholding an image.
    
    Parameters:
    
    area - Rectangle to preprocess.
    
    Returns:
    
    BinarizeFilter object.
  - Resize
```
public static PreprocessingFilter Resize(int width,
                                         int height,
                                         InterpolationFilterType type)
```
    Rescale image - upscale or downscale image resolution.
    
    Parameters:
    
    width - The new width of the image.
    
    height - The new height of the image.
    
    type - InterpolationFilterType @see InterpolationFilterType
    
    Returns:
    
    ResizeFilter object.
  - Resize
```
public static PreprocessingFilter Resize(int width,
                                         int height)
```
    Rescale image - Upscale or downscale image resolution. InterpolationFilterType = bilinear or nearest neighbor @see InterpolationFilterType
    
    Parameters:
    
    width - The new width of the image.
    
    height - The new height of the image.
    
    Returns:
    
    ResizeFilter object.
  - BinarizeAndDilate
```
public static PreprocessingFilter BinarizeAndDilate()
```
    Dilation adds pixels to the boundaries of objects in an image.
    
    Returns:
    
    DilateFilter object.
  - BinarizeAndDilate
```
public static PreprocessingFilter BinarizeAndDilate(Rectangle area)
```
    Dilation adds pixels to the boundaries of objects in a part of the image.
    
    Parameters:
    
    area - Rectangle to preprocess.
    
    Returns:
    
    DilateFilter object.
  - Invert
```
public static PreprocessingFilter Invert()
```
    Automatically inverts colors in a document image.
    
    Returns:
    
    InvertFilter object.
  - Invert
```
public static PreprocessingFilter Invert(Rectangle area)
```
    Automatically inverts colors in a part of the image.
    
    Parameters:
    
    area - Rectangle to preprocess.
    
    Returns:
    
    InvertFilter object.
  - Rotate
```
public static PreprocessingFilter Rotate(float angle)
```
    Rotate original image.
    
    Parameters:
    
    angle - Angle of rotation. Value from -360 to 360.
    
    Returns:
    
    RotateFilter object.
  - Rotate
```
public static PreprocessingFilter Rotate(float angle,
                                         Rectangle area)
```
    Rotate the part of the image.
    
    Parameters:
    
    angle - Angle of rotation. Value from -360 to 360.
    
    area - Rectangle to preprocess.
    
    Returns:
    
    RotateFilter object.
  - Scale
```
public static PreprocessingFilter Scale(float ratio)
```
    Rescale image - Upscale or downscale image resolution. InterpolationFilterType default bilinear or nearest neighbor @see InterpolationFilterType
    
    Parameters:
    
    ratio - The scaling factor. Recommended value from 0.1 to 1 to shrink. From 1 to 10 to enlarge.
    
    Returns:
    
    ScaleFilter object.
  - Scale
```
public static PreprocessingFilter Scale(float ratio,
                                        InterpolationFilterType type)
```
    Rescale image - Upscale or downscale image resolution.
    
    Parameters:
    
    ratio - The scaling factor. Recommended value from 0.1 to 1 to shrink. From 1 to 10 to enlarge.
    
    type - InterpolationFilterType @see InterpolationFilterType
    
    Returns:
    
    ScaleFilter object.
  - ToGrayscale
```
public static PreprocessingFilter ToGrayscale()
```
    Converts an image to grayscale image. Grayscale image have 256 level of light in image (0 to 255).
    
    Returns:
    
    GrayscaleFilter object.
  - Threshold
```
public static PreprocessingFilter Threshold(int value)
```
    Create a binary image based on setting a threshold value on the pixel intensity of the original image.
    
    Parameters:
    
    value - The max value.
    
    Returns:
    
    BinarizeFilter object.
  - Threshold
```
public static PreprocessingFilter Threshold(int value,
                                            Rectangle area)
```
    Create a binary image part based on setting a threshold value on the pixel intensity of the original image part.
    
    Parameters:
    
    value - The max value.
    
    area - Rectangle to preprocess.
    
    Returns:
    
    BinarizeFilter object.
  - Median
```
public static PreprocessingFilter Median()
```
    The median filter run through each element of the image and replace each pixel with the median of its neighboring pixels.
    
    Returns:
    
    MedianFilter object.
  - Median
```
public static PreprocessingFilter Median(Rectangle area)
```
    The median filter run through each element of the part of the image and replace each pixel with the median of its neighboring pixels.
    
    Parameters:
    
    area - Rectangle to preprocess.
    
    Returns:
    
    MedianFilter object.
  - AutoDenoising
```
public static PreprocessingFilter AutoDenoising()
```
    Enables the use of an additional neural network to improve the image - reduce noise. Useful for images with scan artifacts, distortion, spots, flares, gradients, foreign elements.
    
    Returns:
    
    AutoDenoisingFilter object.
  - AutoDewarping
```
public static PreprocessingFilter AutoDewarping()
```
    Automatically corrects geometric distortions in the image. Extremely resource intensive!
    
    Returns:
    
    AutoDewarpingFilter object.
  - AutoDenoising
```
public static PreprocessingFilter AutoDenoising(Rectangle area)
```
    Enables the use of an additional neural network to improve the part of the image - reduce noise. Useful for images with scan artifacts, distortion, spots, flares, gradients, foreign elements.
    
    Parameters:
    
    area - Rectangle to preprocess.
    
    Returns:
    
    AutoDenoisingFilter object.
  - AutoSkew
```
public static PreprocessingFilter AutoSkew()
```
    Enables the automatic image skew correction.
    
    Returns:
    
    AutoSkewFilter object.
  - AutoSkew
```
public static PreprocessingFilter AutoSkew(Rectangle area)
```
    Enables the automatic image part skew correction.
    
    Parameters:
    
    area - Rectangle to preprocess.
    
    Returns:
    
    AutoSkewFilter object.
  - ContrastCorrection
```
public static PreprocessingFilter ContrastCorrection()
```
    Contrast correction filter.
    
    Returns:
    
    ContrastCorrectionFilter object.
  - ContrastCorrection
```
public static PreprocessingFilter ContrastCorrection(Rectangle area)
```
    Contrast correction filter for the part of the image.
    
    Parameters:
    
    area - Rectangle to preprocess.
    
    Returns:
    
    ContrastCorrectionFilter object.
  - add
```
public void add(PreprocessingFilter filter)
```
    Add the new filter to the collection to further run all operations. Consistency in the collection matters.
    
    Parameters:
    
    filter - New operation to add to filter list.

Class PreprocessingFilter

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

Empty

Constructor Detail

PreprocessingFilter

Method Detail

Binarize

Binarize

Resize

Resize

BinarizeAndDilate

BinarizeAndDilate

Invert

Invert

Rotate

Rotate

Scale

Scale

ToGrayscale

Threshold

Threshold

Median

Median

AutoDenoising

AutoDewarping

AutoDenoising

AutoSkew

AutoSkew

ContrastCorrection

ContrastCorrection

add