Difference between revisions of "FindColorSpiral"

From SCAR Divi Manual
Jump to: navigation, search
(Description)
(Description)
Line 12: Line 12:
  
 
==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 spiral 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 search begins at the given ('''x''', '''y''') coordinate, if '''x''' or '''y''' are smaller than 0, the search will start in the middle of the search area.. The function returns [[false]] if the color was not found, if it was it returns [[true]] and the coordinates of the found color in ('''x''', '''y'''). The search will stop after the first color was found.
+
This function searches for a given color specified by '''Color''' inside of a given search area specified by '''xs''', '''ys''', '''xe''', '''ye''' using a spiral 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 search begins at the given ('''x''', '''y''') coordinate, if '''x''' or '''y''' are smaller than 0, the search will start in the middle of the search area. The function returns [[false]] if the color was not found, if it was it returns [[true]] and the coordinates of the found color in ('''x''', '''y'''). The search will stop after the first color was found.
  
 
==Example==
 
==Example==

Revision as of 08:43, 27 June 2011

FindColorSpiral.gif

Definition

function FindColorSpiral(var x, y: Integer; const Color, xs, ys, xe, ye: Integer): Boolean;

Availability

SCAR Divi 3.00 > Current

  • Before SCAR Divi 3.25, the search would not start in the middle of the search area if x or y are smaller than 0.

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 spiral 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 search begins at the given (x, y) coordinate, if x or y are smaller than 0, the search will start in the middle of the search area. The function returns false if the color was not found, if it was it returns true and the coordinates of the found color in (x, y). The search will stop after the first color was found.

Example

var
  w, h: Integer;
  x, y: Integer;

begin
  GetClientDimensions(w, h);
  x := -1; y := -1;
  if FindColorSpiral(x, y, 0, 0, 0, w - 1, h - 1) then
    WriteLn('Found color at ' + IntToStr(x) + ', ' + IntToStr(y));
end.

See Also