Difference between revisions of "FindColors"
From SCAR Divi Manual
| Line 8: | Line 8: | ||
==Description== | ==Description== | ||
| − | This function searches for | + | This function searches for multiple colors specified by '''Colors''' using a scan-line pattern. The search area is given as a set of upper-left ('''XS''', '''YS''') and lower-right ('''XE''', '''YE''') coordinates which are specified relative to the selected client window. If the given search area is invalid ('''XS''' > '''XE''' or '''YS''' > '''YE'''), an exception is thrown. |
The function returns [[false]] if none of the color were found, if a color is found, it returns [[true]] and the coordinates of the found color in ('''X''', '''Y'''). The search will stop after the first pixel with one of the colors was found. | The function returns [[false]] if none of the color were found, if a color is found, it returns [[true]] and the coordinates of the found color in ('''X''', '''Y'''). The search will stop after the first pixel with one of the colors was found. | ||
Latest revision as of 13:59, 22 November 2012
Definition
function FindColors(out X, Y: Integer; const Colors: TIntArray; const XS, YS, XE, YE: Integer): Boolean;
Availability
SCAR Divi 3.35 > Current
Description
This function searches for multiple colors specified by Colors using a scan-line pattern. The search area is given as a set of upper-left (XS, YS) and lower-right (XE, YE) coordinates which are specified relative to the selected client window. If the given search area is invalid (XS > XE or YS > YE), an exception is thrown.
The function returns false if none of the color were found, if a color is found, it returns true and the coordinates of the found color in (X, Y). The search will stop after the first pixel with one of the colors was found.
Example
var
W, H: Integer;
X, Y: Integer;
begin
GetBoxSize(GetClient.ImageArea, W, H);
if FindColors(X, Y, [0, 255], 0, 0, W - 1, H - 1) then
WriteLn('Found color (' + IntToStr(GetColor(X, Y)) + ') at ' + IntToStr(X) +
', ' + IntToStr(Y));
end.
