###Function###
PixelSearch

###Description###
Sucht in einem Rechteck nach einem Pixel der angegebenen Farbe.

###Syntax###
PixelSearch ( left, top, right, bottom, color [, shade-variation] [, step]]  )


###Parameters###
@@ParamTable@@
left
	Linke Koordinate des Rechteckes.
top
	Obere Koordinate des Rechteckes.
right
	Rechte Koordinate des Rechteckes.
bottom
	Untere Koordinate des Rechteckes.
colour
	Farbwert, der gesucht werden soll (dezimal oder hexadezimal).
shade-variation
	[optional] Eine Zahl zwischen 0 und 255, die angibt, um viele grüne, blaue und rote Farbnuancen sich das überprüfete Pixel vom exakten Farbwert unterscheiden darf.Stnadrd ist 0 (exakte Übereinstimmung).
step
	[optional] Anstatt jedes einzelne Pixel in die Berechnung einzubeziehen, kann ein Wert größer als 1 gewählt werden, um (zur Beschleunigung) Pixel zu überspringen. Z.B. wird der Wert 2 nicht jedes Pixel überprüfen. Standard ist 1.
@@End@@


###ReturnValue###
@@ReturnTable@@
Erfolg:	Gibt ein Array mit zwei Elementen mit den Pixelkoordinaten zurück. (Array[0] = x, Array[1] = y)
Misserfolg:	Setzt @error auf 1 wenn die Farbe nicht gefunden wurde.
@@End@@


###Remarks###
Die Suche wird von oben nach unten und von links nach rechts durchgeführt. Es wird das erste passende Pixel zurückgegeben.

Frühere Versionen von AutoIt (vor 3.0.102) benutzten das BGR-Format, um Farben zu definieren. Neuere Versionen verwenden standardmäßig das RGB-Format, was aber über ColorMode geändert werden kann.

Die Suche kann zeitaufwändig sein. Du solltest also möglichst kleine Rechtecke verwenden, um den Prozessor zu schonen.


###Related###
ColorMode (Option), PixelChecksum, PixelGetColor, PixelCoordMode (Option)


###Example###
@@IncludeExample@@
