Una classe monkeyrunner per contenere un'immagine dello schermo del dispositivo o dell'emulatore. L'immagine è
copiati dal buffer dello schermo durante uno screenshot. I metodi di questo oggetto ti consentono
convertire l'immagine in vari formati di archiviazione, scrivere l'immagine in un file, copiare parti
l'immagine e confronta questo oggetto con altri oggetti MonkeyImage
.
Non è necessario creare nuove istanze di MonkeyImage
. Utilizza invece
MonkeyDevice.takeSnapshot()
per creare una nuova istanza da uno screenshot. Ad esempio, utilizza:
newimage = MonkeyDevice.takeSnapshot()
Riepilogo
Metodi | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
Converte l'immagine corrente in un formato particolare e la restituisce come
string a cui potrai accedere come iterabile di byte binari.
|
||||||||||
|
Restituisce il singolo pixel nella posizione dell'immagine (x,y), come
una tupla di numero intero, nel formato (a,r,g,b).
|
||||||||||
|
Restituisce il singolo pixel nella posizione dell'immagine (x,y), come
un numero intero a 32 bit.
|
||||||||||
MonkeyImage
|
Crea un nuovo oggetto
MonkeyImage da una selezione rettangolare di
l'immagine corrente.
|
||||||||||
|
MonkeyImage )
altri
percentuale in virgola mobile)
Confronta questo oggetto
MonkeyImage con un altro e restituisce il risultato di
il confronto. L'argomento percent specifica la percentuale
differenza che consente alle due immagini di essere "uguali".
|
||||||||||
|
Scrive l'immagine corrente nel file specificato da
filename , nel
specificato da format .
|
Metodi pubblici
stringa convertToBytes ( string)
Converte l'immagine corrente in un formato particolare e la restituisce come string a cui potrai accedere come iterabili di byte binari.
Argomenti
formato | Il formato di output desiderato. Sono supportati tutti i comuni formati di output raster. Il valore predefinito è "png" (Portable Network Graphics). |
---|
tupla getRawPixel (numero intero x, intero y)
Restituisce il singolo pixel nella posizione dell'immagine (x,y), come una tupla di numero intero, nel formato (a,r,g,b).
Argomenti
x | La posizione orizzontale del pixel, che inizia con 0 a sinistra dello schermo nella l'orientamento che aveva al momento dell'acquisizione dello screenshot. |
---|---|
y | La posizione verticale del pixel, che inizia con 0 nella parte superiore dello schermo nella l'orientamento che aveva al momento dell'acquisizione dello screenshot. |
Ritorni
- Una tupla di numeri interi che rappresentano il pixel, nel formato (a,r,g,b) dove a è il valore del canale alfa, mentre r, g e b sono i valori rosso, verde e blu, rispettivamente.
tupla getRawPixelInt (numero intero x, intero y)
Restituisce il singolo pixel nella posizione dell'immagine (x,y), come un numero intero. Usa questo metodo per risparmiare sulla memoria.
Argomenti
x | La posizione orizzontale del pixel, che inizia con 0 a sinistra dello schermo nella l'orientamento che aveva al momento dell'acquisizione dello screenshot. |
---|---|
y | La posizione verticale del pixel, che inizia con 0 nella parte superiore dello schermo nella l'orientamento che aveva al momento dell'acquisizione dello screenshot. |
Ritorni
- I valori a, r, g e b del pixel come valori a 8 bit combinati in un intervallo a 32 bit intero, con a come 8 bit più a sinistra, r il successivo più a destra e così via.
MonkeyImage
getSubImage
(rettangolo a forma di tupla)
Crea un nuovo oggetto MonkeyImage
da una selezione rettangolare di
l'immagine corrente.
Argomenti
rect |
Una tupla (x, y, w, h) che specifica la selezione. x e y specificano il pixel in base 0
dell'angolo in alto a sinistra della selezione. w specifica la larghezza
regione, mentre h specifica la sua altezza, entrambe espresse in pixel.
L'orientamento dell'immagine è uguale all'orientamento dello schermo del momento in cui screenshot. |
---|
Ritorni
-
Un nuovo oggetto
MonkeyImage
contenente la selezione.
booleano
sameAs
(
MonkeyImage
altra immagine,
Percentuale in virgola mobile
)
Confronta questo oggetto MonkeyImage
con un altro e restituisce il risultato di
il confronto. L'argomento percent
specifica la percentuale
differenza che consente alle due immagini di essere "uguali".
Argomenti
altro |
Un altro oggetto MonkeyImage da confrontare con questo.
|
---|---|
percentuale |
Un numero in virgola mobile compreso tra 0,0 e 1,0 inclusi, che indica
la percentuale di pixel che devono essere uguali affinché il metodo restituisca
true . Il valore predefinito è 1, 0 e indica che tutti i pixel
devono corrispondere.
|
Ritorni
-
Valore booleano
true
se le immagini corrispondono, oppure booleanofalse
in caso contrario.
null . writeToFile (nome file stringa, string) .
Scrive l'immagine corrente nel file specificato da filename
, nel
specificato da format
.
Argomenti
percorso | Il nome file completo e l'estensione del file di output. |
---|---|
formato | Il formato di output da utilizzare per il file. Se non viene fornito alcun formato, tenta di indovinare il formato dall'estensione del nome file. In caso contrario viene specificata l'estensione e non viene specificato alcun formato, viene quindi utilizzato il formato predefinito "png" (Portable Network Graphics). |