Difference between revisions of "CountColor"

From SCAR Divi Manual
Jump to: navigation, search
(Created page with "right ==Definition== <source lang="scar" lines="false"> function CountColor(Color, xs, ys, xe, ye: Integer): Integer; </source> ==Availability== SCAR Di...")
 
 
(2 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
==Definition==
 
==Definition==
 
<source lang="scar" lines="false">
 
<source lang="scar" lines="false">
function CountColor(Color, xs, ys, xe, ye: Integer): Integer;
+
function CountColor(const Color, XS, YS, XE, YE: Integer): Integer;
 
</source>
 
</source>
  
Line 10: Line 10:
  
 
==Description==
 
==Description==
This function searches for a given color specified by '''Color''' 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 the number of pixels it found, as a result of this 0 is returned when the color was not found.
+
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 the number of pixels it found, as a result of this 0 is returned when the color was not found.
  
 
==Example==
 
==Example==
Line 19: Line 21:
 
begin
 
begin
 
   GetClientDimensions(w, h);
 
   GetClientDimensions(w, h);
   WriteLn('Found color ' + IntToStr(CountColor(0, 0, 0, w - 1, h - 1)) + ' times');
+
   WriteLn('Counted color ' + IntToStr(CountColor(0, 0, 0, w - 1, h - 1)) + ' times');
 
end.
 
end.
 
</source>
 
</source>

Latest revision as of 13:42, 2 April 2012

CountColor.gif

Definition

function CountColor(const Color, XS, YS, XE, YE: Integer): Integer;

Availability

SCAR Divi 3.00 > Current

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 the number of pixels it found, as a result of this 0 is returned when the color was not found.

Example

var
  w, h: Integer;

begin
  GetClientDimensions(w, h);
  WriteLn('Counted color ' + IntToStr(CountColor(0, 0, 0, w - 1, h - 1)) + ' times');
end.

See Also