FindColorTolEx

From SCAR Divi Manual
Revision as of 16:29, 2 July 2011 by Freddy (talk | contribs)
Jump to: navigation, search
FindColorsTolerance.gif

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.

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.

See Also