MonkeyImage

Classe monkeyrunner qui contient une image de l'écran de l'appareil ou de l'émulateur. L'image est copiée depuis la mémoire tampon écran lors d'une capture d'écran. Les méthodes de cet objet vous permettent de convertir l'image dans différents formats de stockage, d'écrire l'image dans un fichier, de copier des parties de l'image et de comparer cet objet à d'autres objets MonkeyImage.

Vous n'avez pas besoin de créer de nouvelles instances de MonkeyImage. Utilisez plutôt MonkeyDevice.takeSnapshot() pour créer une nouvelle instance à partir d'une capture d'écran. Par exemple, utilisez : 

newimage = MonkeyDevice.takeSnapshot()

Résumé

Méthodes
chaîne convertToBytes (format de string)
Convertit l'image actuelle dans un format particulier et la renvoie sous forme de string à laquelle vous pouvez ensuite accéder en tant que iterable d'octets binaires.
tuple getRawPixel (integer x, integer y)
Renvoie le pixel unique à l'emplacement de l'image (x,y), en tant que tuple de integer, au format (a,r,g,b).
entier getRawPixelInt (integer x, integer y)
Renvoie le pixel unique à l'emplacement de l'image (x,y), en tant que integer 32 bits.
MonkeyImage getSubImage (tuple rect)
Crée un nouvel objet MonkeyImage à partir d'une sélection rectangulaire de l'image actuelle.
booléen sameAs (autre MonkeyImage, pourcentage de float)
Compare cet objet MonkeyImage à un autre et renvoie le résultat de la comparaison. L'argument percent spécifie la différence de pourcentage autorisée pour que les deux images soient "égales".
vide writeToFile (chemin d'accès de string, format de string)
Écrit l'image actuelle dans le fichier spécifié par filename, au format spécifié par format.

Méthodes publiques

string convertToBytes ( format de string)

Convertit l'image actuelle dans un format particulier et la renvoie sous forme de string à laquelle vous pouvez ensuite accéder en tant que iterable d'octets binaires.

Arguments
format Format de sortie souhaité. Tous les formats de sortie de trame courants sont pris en charge. La valeur par défaut est "png" (Portable Network Graphics).

tuple getRawPixel (integer x, integer y)

Renvoie le pixel unique à l'emplacement de l'image (x,y), en tant que tuple de integer, au format (a,r,g,b).

Arguments
x Position horizontale du pixel, commençant par 0 à gauche de l'écran dans l'orientation définie au moment de la capture d'écran.
y Position verticale du pixel, commençant par 0 en haut de l'écran dans l'orientation définie au moment de la capture d'écran.
Renvoie
  • Un tuple d'entiers représentant le pixel, au format (a,r,g,b), où "a" est la valeur du canal alpha, et "r", "g" et "b" sont les valeurs rouge, vert et bleu, respectivement.

tuple getRawPixelInt (integer x, integer y)

Renvoie le pixel unique à l'emplacement de l'image (x,y), en tant que integer. Utilisez cette méthode pour économiser de la mémoire.

Arguments
x Position horizontale du pixel, commençant par 0 à gauche de l'écran dans l'orientation définie au moment de la capture d'écran.
y Position verticale du pixel, commençant par 0 en haut de l'écran dans l'orientation définie au moment de la capture d'écran.
Renvoie
  • Les valeurs a, r, g et b du pixel sous la forme de valeurs 8 bits combinées en un entier 32 bits, "a" correspondant aux 8 bits les plus à gauche, "r" aux 8 bits les plus à droite, etc.

MonkeyImage getSubImage (tuple rect)

Crée un nouvel objet MonkeyImage à partir d'une sélection rectangulaire de l'image actuelle.

Arguments
rect Un tuple (x, y, w, h) spécifiant la sélection. "x" et "y" indiquent la position du pixel en base 0 dans l'angle supérieur gauche de la sélection. "w" spécifie la largeur de la région, et "h" spécifie sa hauteur, toutes deux en unités de pixels.

L'orientation de l'image est identique à l'orientation de l'écran au moment de la capture d'écran.

Renvoie
  • Un nouvel objet MonkeyImage contenant la sélection

boolean sameAs ( MonkeyImage otherImage, pourcentage de float )

Compare cet objet MonkeyImage à un autre et renvoie le résultat de la comparaison. L'argument percent spécifie la différence en pourcentage autorisée pour que les deux images soient "égales".

Arguments
other Un autre objet MonkeyImage à comparer à celui-ci.
percent Valeur flottante comprise entre 0,0 et 1,0 (inclus), indiquant le pourcentage de pixels devant être identique pour que la méthode renvoie true. La valeur par défaut est 1,0. Elle indique que tous les pixels doivent correspondre.
Renvoie
  • Booléen true si les images correspondent, booléen false dans le cas contraire.

void writeToFile (nom de fichier de string, format de string)

Écrit l'image actuelle dans le fichier spécifié par filename, au format spécifié par format.

Arguments
path Nom de fichier complet et extension du fichier de sortie.
format Format de sortie à utiliser pour le fichier. Si aucun format n'est fourni, la méthode tente de deviner le format à partir de l'extension du nom de fichier. Si aucune extension n'est fournie et qu'aucun format n'est spécifié, le format par défaut "png" (Portable Network Graphics) est utilisé.