Difference between revisions of "FindColorEx"

From SCAR Divi Manual
Jump to: navigation, search
Line 35: Line 35:
 
==See Also==
 
==See Also==
 
*[[FindColorExTol]]
 
*[[FindColorExTol]]
 +
*[[FindColor]]
 
*[[FindColorsEx]]
 
*[[FindColorsEx]]
*[[FindColor]]
 
 
*[[CountColor]]
 
*[[CountColor]]
 
*[[GetColor]]
 
*[[GetColor]]

Revision as of 14:02, 7 August 2012

FindColors.gif

Definition

function FindColorEx(out Points: TPointArray; const Color, XS, YS, XE, YE: Integer): Boolean;

Availability

SCAR Divi 3.35 > Current

Aliases

  • FindColors (SCAR Divi 3.00 > 3.34)

Description

This function searches for a given color specified by Color 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 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.

Example

var
  W, H: Integer;
  TPA: TPointArray;

begin
  GetBoxSize(GetClient.ImageArea, W, H);
  if FindColorEx(TPA, 0, 0, 0, W - 1, H - 1) then
  begin
    WriteLn('Found color ' + IntToStr(Length(TPA)) + ' times');
    WriteLn('Coordinates: ' + TPAToStr(TPA));
  end;
end.

See Also