FindColors

From SCAR Divi Manual
Jump to: navigation, search

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.

See Also