Difference between revisions of "FindColorTolEx"
From SCAR Divi Manual
| Line 10: | Line 10: | ||
==Description== | ==Description== | ||
| − | This function searches for a given color specified by '''Color''' within a [[tolerance]] range specified by '''Tol''' inside of a given search area specified by '''xs''', '''ys''', '''xe''', '''ye''' 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. The function returns [[false]] if the color was not found, if it was it returns [[true]] and the coordinates of all found instances of the color in the [[TPointArray]] '''Points'''. The search will stop after the first color was found. | + | This function searches for a given color specified by '''Color''' within a [[tolerance]] range specified by '''Tol''' inside of a given search area specified by '''xs''', '''ys''', '''xe''', '''ye''' 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. The function returns [[false]] if the color was not found, if it was it returns [[true]] and the coordinates of all found instances of the color in the [[TPointArray]] '''Points'''. The search will stop after the first color was found. The active tolerance algorithm can be changed using the [[ColorToleranceSpeed]] function. |
==Example== | ==Example== | ||
Revision as of 14:31, 6 July 2011
Definition
function FindColorsTolerance(var Points: TPointArray; Color, xs, ys, xe, ye, Tol: Integer): Boolean;
Availability
SCAR Divi 3.00 > Current
Description
This function searches for a given color specified by Color within a tolerance range specified by Tol inside of a given search area specified by xs, ys, xe, ye 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. The function returns false if the color was not found, if it was it returns true and the coordinates of all found instances of the color in the TPointArray Points. The search will stop after the first color was found. The active tolerance algorithm can be changed using the ColorToleranceSpeed function.
Example
var
w, h: Integer;
TPA: TPointArray;
begin
GetClientDimensions(w, h);
if FindColorsTolerance(TPA, 4, 0, 0, w - 1, h - 1, 5) then
begin
WriteLn('Found color ' + IntToStr(Length(TPA)) + ' times');
WriteLn('Coordinates: ' + TPAToStr(TPA));
end;
end.
