Eine Monkeyrunner-Klasse, die ein Bild des Geräte- oder Emulatorbildschirms enthält Das Bild wird während des Screenshots aus dem Bildschirmzwischenspeicher kopiert. Mit den Methoden dieses Objekts können Sie das Bild in verschiedene Speicherformate konvertieren, in eine Datei schreiben, Teile des Bildes kopieren und dieses Objekt mit anderen MonkeyImage
-Objekten vergleichen.
Sie müssen keine neuen Instanzen von MonkeyImage
erstellen. Verwenden Sie stattdessen
MonkeyDevice.takeSnapshot()
, um eine neue Instanz aus einem Screenshot zu erstellen. Beispiele:
newimage = MonkeyDevice.takeSnapshot()
Zusammenfassung
Methoden | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
Konvertiert das aktuelle Bild in ein bestimmtes Format und gibt es als String zurück, auf den Sie dann als iterable von binären Byte zugreifen können.
|
||||||||||
|
Gibt das einzelne Pixel an der Bildposition (x,y) als Tupel von integer in Form (a, r, g, b) zurück.
|
||||||||||
|
Gibt das einzelne Pixel an der Bildposition (x,y) als 32-Bit-Ganzzahl zurück.
|
||||||||||
MonkeyImage
|
Erstellt ein neues
MonkeyImage -Objekt aus einer rechteckigen Auswahl des aktuellen Bilds.
|
||||||||||
|
MonkeyImage
andere,
Gleitkommazahl %)
Vergleicht dieses
MonkeyImage -Objekt mit einem anderen und gibt das Ergebnis des Vergleichs zurück. Das Argument percent gibt die prozentuale Differenz an, die zulässig ist, damit die beiden Bilder „gleich“ sind.
|
||||||||||
|
Schreibt das aktuelle Bild in der von
filename angegebenen Datei im durch format angegebenen Format.
|
Öffentliche Methoden
string convertToBytes ( string-Format)
Konvertiert das aktuelle Bild in ein bestimmtes Format und gibt es als String zurück, auf den Sie dann als iterable von binären Byte zugreifen können.
Argumente
Format | Das gewünschte Ausgabeformat. Alle gängigen Raster-Ausgabeformate werden unterstützt. Der Standardwert ist „png“ (Portable Network Graphics). |
---|
Tupel getRawPixel (Ganzzahl x, Ganzzahl Y)
Gibt das einzelne Pixel an der Bildposition (x,y) als Tupel von integer in Form (a, r, g, b) zurück.
Argumente
x | Die horizontale Position des Pixels, beginnend mit 0 links auf dem Bildschirm in der Ausrichtung, in der es zur Erstellung des Screenshots war. |
---|---|
y | Die vertikale Position des Pixels, beginnend mit 0 oben auf dem Bildschirm, in der Ausrichtung, in der der Screenshot erstellt wurde. |
Returns
- Ein Tupel von Ganzzahlen, die das Pixel in der Form (a, r, g, b) darstellen, wobei a der Alphakanalwert und r, g und b die jeweiligen roten, grünen bzw. blauen Werte sind.
tuple getRawPixelInt (integer x, integer y)
Gibt das einzelne Pixel an der Bildposition (x,y) als Ganzzahl zurück. Verwenden Sie diese Methode, um Speicher zu sparen.
Argumente
x | Die horizontale Position des Pixels, beginnend mit 0 links auf dem Bildschirm in der Ausrichtung, in der es zur Erstellung des Screenshots war. |
---|---|
y | Die vertikale Position des Pixels, beginnend mit 0 oben auf dem Bildschirm, in der Ausrichtung, in der der Screenshot erstellt wurde. |
Returns
- Die Werte a, r, g und b des Pixels als 8-Bit-Werte kombiniert in einer 32-Bit-Ganzzahl, wobei a die 8 Bit ganz links, r ganz rechts und so weiter steht.
MonkeyImage
getSubImage
(Tupel Rect)
Erstellt ein neues MonkeyImage
-Objekt aus einer rechteckigen Auswahl des aktuellen Bilds.
Argumente
Rechteck |
Ein Tupel (x, y, w, h), das die Auswahl angibt. x und y geben die 0-basierte Pixelposition der oberen linken Ecke der Auswahl an. w gibt die Breite des Bereichs und h die Höhe an, beides in Pixeleinheiten.
Die Ausrichtung des Bildes entspricht der Bildschirmausrichtung zum Zeitpunkt der Erstellung des Screenshots. |
---|
Returns
-
Ein neues
MonkeyImage
-Objekt, das die Auswahl enthält.
boolesch
sameAs
(
MonkeyImage
otherImage,
FLOAT Prozent
)
Vergleicht dieses MonkeyImage
-Objekt mit einem anderen und gibt das Ergebnis des Vergleichs zurück. Das Argument percent
gibt die prozentuale Differenz an, die zulässig ist, damit die beiden Bilder „gleich“ sind.
Argumente
Andere |
Ein anderes MonkeyImage -Objekt, das mit diesem verglichen werden kann.
|
---|---|
Prozent |
Eine Gleitkommazahl im Bereich von 0,0 bis einschließlich 1,0, die den Prozentsatz der Pixel angibt, die gleich sein müssen, damit die Methode true zurückgibt. Der Standardwert ist 1,0.Dies bedeutet, dass alle Pixel übereinstimmen müssen.
|
Returns
-
Boolescher Wert
true
, wenn die Bilder übereinstimmen, oder boolescher Wertfalse
void writeToFile (string-Dateiname, string-Format)
Schreibt das aktuelle Bild in der von filename
angegebenen Datei im durch format
angegebenen Format.
Argumente
Pfad | Der voll qualifizierte Dateiname und die Erweiterung der Ausgabedatei. |
---|---|
Format | Das für die Datei zu verwendende Ausgabeformat. Ist kein Format angegeben, versucht die Methode, das Format anhand der Dateiendung zu erraten. Wenn keine Erweiterung und kein Format angegeben ist, wird das Standardformat „PNG“ (Portable Network Graphics) verwendet. |