Immagine di scimmia

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
stringa 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.
tupla 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).
numero intero getRawPixelInt (numero intero x, numero intero y)
Restituisce il singolo pixel nella posizione dell'immagine (x,y), sotto forma di numero intero a 32 bit.
MonkeyImage getSubImage (tuple retto)
Crea un nuovo oggetto MonkeyImage da una selezione rettangolare dell'immagine corrente.
booleano sameAs (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".
void writeToFile (percorso stringa, formato stringa)
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 o false 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).