Una classe monkeyrunner in cui è presente un'immagine dello schermo del dispositivo o dell'emulatore. L'immagine viene
copiata dal buffer dello schermo durante uno screenshot. I metodi di questo oggetto consentono di convertire l'immagine in vari formati di archiviazione, scrivere l'immagine in un file, copiare parti dell'immagine e confrontare 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 stringa a cui puoi accedere come iterabile di byte binari.
|
||||||||||
|
Restituisce il singolo pixel nella posizione dell'immagine (x,y), sotto forma di tupla di numero intero nel formato (a,r,g,b).
|
||||||||||
|
Restituisce il singolo pixel nella posizione dell'immagine (x,y), sotto forma di numero intero a 32 bit.
|
||||||||||
MonkeyImage
|
Crea un nuovo oggetto
MonkeyImage da una selezione rettangolare dell'immagine corrente.
|
||||||||||
|
MonkeyImage
altro,
float percento)
Confronta questo oggetto
MonkeyImage con un altro e restituisce il risultato del confronto. L'argomento percent specifica la differenza percentuale consentita affinché due immagini siano "uguali".
|
||||||||||
|
Scrive l'immagine corrente nel file specificato da
filename , nel
formato specificato da format .
|
Metodi pubblici
string convertToBytes ( formato stringa)
Converte l'immagine corrente in un formato particolare e la restituisce come stringa a cui puoi accedere come iterabile di byte binari.
Argomenti
formato | Il formato di output desiderato. Sono supportati tutti i formati di output raster comuni. Il valore predefinito è "png" (Portable Network Graphics). |
---|
tuple getRawPixel (numero intero x, numero intero y)
Restituisce il singolo pixel nella posizione dell'immagine (x,y), sotto forma di tupla di numero intero nel formato (a,r,g,b).
Argomenti
x | La posizione orizzontale del pixel, a partire da 0 a sinistra dello schermo, nell'orientamento che aveva quando è stato acquisito lo screenshot. |
---|---|
y | La posizione verticale del pixel, a partire da 0 nella parte superiore dello schermo, nell'orientamento che aveva quando è stato acquisito lo screenshot. |
Ritorni
- Una tupla di numeri interi che rappresentano il pixel, nel formato (a,r,g,b) dove a è il valore del canale alfa e r, g e b sono rispettivamente i valori rosso, verde e blu.
tuple getRawPixelInt (numero intero x, numero intero y)
Restituisce il singolo pixel nella posizione dell'immagine (x,y), sotto forma di numero intero. Utilizza questo metodo per risparmiare memoria.
Argomenti
x | La posizione orizzontale del pixel, a partire da 0 a sinistra dello schermo, nell'orientamento che aveva quando è stato acquisito lo screenshot. |
---|---|
y | La posizione verticale del pixel, a partire da 0 nella parte superiore dello schermo, nell'orientamento che aveva quando è stato acquisito lo screenshot. |
Ritorni
- I valori a, r, g e b del pixel come valori a 8 bit combinati in un numero intero a 32 bit, con a come 8 bit più a sinistra, r il successivo a destra e così via.
MonkeyImage
getSubImage
(tuple retto)
Crea un nuovo oggetto MonkeyImage
da una selezione rettangolare dell'immagine corrente.
Argomenti
rect |
Una tupla (x, y, w, h) che specifica la selezione. x e y specificano la posizione dei pixel in base a 0 dell'angolo superiore sinistro della selezione. w specifica la larghezza dell'area, h specifica la sua altezza, entrambe espresse in pixel.
L'orientamento dell'immagine corrisponde a quello dello schermo registrato al momento dello screenshot. |
---|
Ritorni
-
Un nuovo oggetto
MonkeyImage
contenente la selezione.
booleano
sameAs
(
MonkeyImage
otherImage,
float percento
)
Confronta questo oggetto MonkeyImage
con un altro e restituisce il risultato del confronto. L'argomento percent
specifica la differenza percentuale consentita affinché due immagini siano "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, che indica che tutti i pixel devono corrispondere.
|
Ritorni
-
Valore booleano
true
se le immagini corrispondono ofalse
booleano in caso contrario.
void writeToFile (nome file string, formato string)
Scrive l'immagine corrente nel file specificato da filename
, nel
formato 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, il metodo prova a indovinare il formato dall'estensione del nome file. Se non viene fornita alcuna estensione e non viene specificato alcun formato, viene utilizzato il formato predefinito "png" (Portable Network Graphics). |