[Visual Basic] [
Boolean =
]imagekitcontrolname.Effect.AutoSelectImage(x
As Long, y As Long, Points As Long, Red As Integer, Green As
Integer, Blue As Integer, Mode As Integer, Level As Integer)
[Visual C++] [
BOOL =
]imagekitcontrolname.GetEffect().AutoSelectImage(long
*x, long *y, long Points, short Red, short Green, short Blue, short
Mode, short Level)
[VB.NET] [ Boolean =
]imagekitcontrolname.Effect.AutoSelectImage(ByRef
x As Integer, ByRef y As Integer, Points As Integer, Red As Short,
Green As Short, Blue As Short, Mode As Short, Level As Short)
[C#.NET] [ bool =
]imagekitcontrolname.Effect.AutoSelectImage(ref
int x, ref int y, int Points, short Red, short Green, short Blue,
short Mode, short Level)
Parameters
| Name | Explanation |
|---|---|
| x | An array of x coordinate values defining points of a polygonal area on the image. (in pixels) * (see Note below) |
| y | An array of y coordinate values defining points of a polygonal area on the image. (in pixels) * (see Note below) |
| Points | The number of points defining the polygonal area on the image. |
| Red | Specifies the red value of the color that will be selected (From 0 to 255) |
| Green | Specifies the green value of the color that will be selected (From 0 to 255) |
| Blue | Specifies the blue value of the color that will be selected (From 0 to 255) |
| Mode | Comparison mode (0:RGB, 1:CrCb, 2:Y) |
| Level | Level of Allowance (From 0 to 255) |
| * NOTE for retrieving array values: In Visual Basic, if the array is defined as Dim x(0 To 2) As Long, then the arguments are returned in x(0). In Visual C++, pass the pointer to the first element in the array. In VB.NET, the arguments are returned in x(0). In C#.NET, the arguments are returned in x[0]. |
|
Return Value
Returns True (nonzero) if successful, otherwise returns False (0).
Explanation
The AutoSelectImage method uses a specified color (RGB
value), and selects areas of the image that have that color. To
execute the AutoSelectImage method, set the image handle of
the image in the ImageHandle property or the
Layer(LayerNo).ImageHandle
property. The AutoSelectImage method supports 1, 4, 8, 16,
24, and 32 bit images.
Before executing the AutoSelectImage method, you must set
the area on the image that will be affected. There are 3 ways
to do this.
- To process the total image, set the SelectMode property to 1
- To process the polygonal area on the image, set the SelectMode property to 2. Select the polygon by setting the appropriate coordinate values for the points of the polygon in two arrays, one array for the x coordinate values and one array for the y coordinate values. The pass these arrays to the x and y arguments of the AutoSelectImage method. The number of points defining the polygon must be 3 or more
- To process an elliptical area on the image, set the SelectMode property to 3. Select the ellipse by setting the appropriate values for the bounding rectangle in the RectLeft, RectTop, RectRight, and RectBottom properties
The Mode parameter sets the type of color comparison used to select portions of the image. When the Mode parameter is other than 0 (i.e. CrCb or Y) then all RGB values are converted to YCrCb values and compared. The Level parameter controls the range of RGB values that will be selected. If the Level value is 0, then only those pixels that have the save RGB value as that specified in the Red, Green, and Blue parameters will be selected. As the Level parameter increases, the range of RGB values that will be selected increases. For example, if Level = 10 and Red, Green, and Blue = 100 respectively, then all pixels with an RGB value between (90,90,90) and (110,110,110) will be selected.
If successful the resulting raster image data is set in the LayerNo property (the ImageHandle property or the Layer(LayerNo).ImageHandle property. If unsuccessful, 0 is returned.
When the Caption, Message, and ButtonName properties are blank, the progress dialog box will not be displayed. When the progress dialog box is displayed, the percentage that the processing has completed will be shown in the dialog box.
For scripting languages and other programs that require variant types or when using 64 bit builds in VB.NET or C#, please refer to the AutoSelectImageVariant method.