MonkeyImage

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
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.
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.
Ganzzahl getRawPixelInt (Ganzzahl x, Ganzzahl y)
Gibt das einzelne Pixel an der Bildposition (x,y) als 32-Bit-Ganzzahl zurück.
MonkeyImage getSubImage (Tupel-Rechteck)
Erstellt ein neues MonkeyImage-Objekt aus einer rechteckigen Auswahl des aktuellen Bilds.
Boolesch sameAs (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.
void writeToFile (Pfad string, Format string)
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 Wert false

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.