PixelGetColor

Ruft die Farbe eines bestimmten Pixels auf dem Bildschirm ab.

PixelGetColor, AusgabeVar, X, Y , Modus

Parameter

AusgabeVar

Name der Ausgabevariable, in der die Farb-ID gespeichert werden soll, standardmäßig im hexadezimalen Blau-Grün-Rot-Format (BGR). Zum Beispiel ist die Farbe Lila als 0x800080 definiert, weil sie einen Blau- und Rotanteil von 80 und einen Grünanteil von 00 hat.

X, Y

Die X- und Y-Koordinate des Pixels (können Ausdrücke sein). Standardmäßig sind Koordinaten relativ zum aktiven Fenster, was aber mit CoordMode geändert werden kann.

Modus

Wenn leer oder weggelassen, wird das Pixel im BGR-Format mit der normalen Methode abgerufen. Andernfalls geben Sie eines oder mehrere der folgenden Wörter an: Mehrere Wörter müssen mit Leerzeichen voneinander getrennt werden (z.B. Alt RGB).

Alt [v1.0.43.10+]: Eine alternative Methode, um Farben abzurufen, die nur verwendet werden sollte, wenn die normale Methode ungültige oder ungenaue Farben bei bestimmten Fenstern liefert. Diese Methode ist etwa 10 % langsamer als die normale Methode.

Slow [v1.0.43.10+]: Eine aufwendigere Methode, um Farben abzurufen, die bei bestimmten Vollbildanwendungen besser funktionieren kann als die anderen Methoden. Diese Methode ist etwa dreimal langsamer als die normale Methode. Hinweis: Slow hat Vorrang vor Alt, so dass Alt in diesem Fall nicht angegeben werden muss.

RGB: Ruft die Farbe im RGB- statt BGR-Format ab. Mit anderen Worten, die Rot- und Blauanteile sind vertauscht. Dies ist nützlich, um Farben abzurufen, die mit WinSet, Gui, Progress und SplashImage kompatibel sind.

Fehlerbehandlung

[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.

ErrorLevel wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt.

Bemerkungen

Das Pixel muss sichtbar sein, d.h. es ist nicht möglich, die Pixelfarbe eines Fensters abzurufen, das hinter einem anderen Fenster verborgen ist. Dagegen werden Pixel unter dem Mauszeiger in der Regel erkannt. Eine Ausnahme bilden die Mauszeiger von Videospielen, die in den meisten Fällen alle darunter liegenden Pixel verdecken.

Verwenden Sie das interne Tool "Window Spy" (erreichbar über das Tray-Menü) oder das Beispiel ganz unten, um die aktuellen Farben auf dem Bildschirm zu identifizieren.

Bekannte Einschränkungen:

• Ein Fenster, das teilweise transparent ist oder in dem eine seiner Farben als unsichtbar markiert ist (TransColor), meldet die Farben des darunter liegenden Fensters, nicht die eigenen Farben.
• PixelGetColor kann bei bestimmten Anwendungen falsche Werte liefern. Versuchen Sie es in diesem Fall mit dem Wort Alt oder Slow im letzten Parameter.

Siehe auch

PixelSearch, ImageSearch, CoordMode, MouseGetPos

Beispiele

^!z::  ; Hotkey STRG+ALT+Z.
MouseGetPos, MausX, MausY
PixelGetColor, Farbe, %MausX%, %MausY%
MsgBox Die Farbe an der aktuellen Mausposition ist %Farbe%.
return