Preprocess Method (image, grayscale, edges, threshold, scaleWidth, scaleHeight)

Preprocesses the specified image by converting it to a grayscale image, detecting object edges, thresholding, and/or resizing/scaling it.

Declaration Syntax

Visual Basic

Visual C++

public static Bitmap Preprocess(
	Bitmap image,
	bool grayscale,
	bool edges,
	bool threshold,
	double scaleWidth,
	double scaleHeight
)

Public Shared Function Preprocess ( _
	image As Bitmap, _
	grayscale As Boolean, _
	edges As Boolean, _
	threshold As Boolean, _
	scaleWidth As Double, _
	scaleHeight As Double _
) As Bitmap

public:
static Bitmap^ Preprocess(
	Bitmap^ image, 
	bool grayscale, 
	bool edges, 
	bool threshold, 
	double scaleWidth, 
	double scaleHeight
)

Parameters

image (Bitmap): An image.

grayscale (Boolean): If true and image is not already a grayscale image, converts the image to a grayscale image (see ConvertRgbToGrayscaleImage(Bitmap)).

edges (Boolean): If true, tries to detect object edges in the image (see DetectEdges(Bitmap)).

threshold (Boolean): If true, a threshold (128) is applied to the image (see Threshold(Bitmap, Byte)).

scaleWidth (Double): If not equal to 1.0, the width of the image will be scaled using the specified factor (see Resize(Bitmap, Double, Double)).

scaleHeight (Double): If not equal to 1.0, the height of the image will be scaled using the specified factor (see Resize(Bitmap, Double, Double)).

Return Value

The preprocessed image.

Exceptions

Exception	Condition
ArgumentNullException	If image is null.
ArgumentException	If the input image is not a grayscale image, needs to be converted to such, and cannot be converted to Format24bppRgb pixel format (i.e. if it is no color image in a 32 bit format).

Assembly: Ranorex.Core (Module: Ranorex.Core) Version: 3.2.3.16825 (3.2.3.16825)