MonkeyImage

Una clase de monkeyrunner para conservar una imagen de la pantalla del dispositivo o el emulador. La imagen se copia del búfer de la pantalla durante una captura de pantalla. Los métodos del objeto permiten convertir la imagen en varios formatos de almacenamiento, escribir la imagen en un archivo, copiar partes de la imagen y comparar este objeto con otros de MonkeyImage.

No es necesario crear instancias nuevas de MonkeyImage. En su lugar, usa MonkeyDevice.takeSnapshot() para crear una nueva instancia a partir de una captura de pantalla. Por ejemplo, usa:

    newimage = MonkeyDevice.takeSnapshot()
    

Resumen

Métodos
string convertToBytes (formato string)
Convierte la imagen actual a un formato determinado y la muestra como una string, a la que luego puedes acceder como iterable de bytes binarios.
tuple getRawPixel (integer x, integer y)
Muestra el pixel único de la ubicación de la imagen (x,y), como un objeto tuple de integer, con el formato (a,r,g,b).
integer getRawPixelInt (integer x, integer y)
Muestra el único píxel en la ubicación de imagen (x,y), como integer de 32 bits.
MonkeyImage getSubImage (tuple rect)
Crea un objeto MonkeyImage nuevo a partir de una selección rectangular de la imagen actual.
boolean sameAs (otro MonkeyImage, porcentaje float)
Compara este objeto MonkeyImage con otro y muestra el resultado de la comparación. El argumento percent especifica la diferencia de porcentaje permitida para que las dos imágenes sean "iguales".
void writeToFile(ruta de acceso string, formato string)
Escribe la imagen actual en el archivo especificado por filename, en el formato especificado por format.

Métodos públicos

string convertToBytes (formato string)

Convierte la imagen actual a un formato determinado y lo muestra como una string, a la que luego puedes acceder como un objeto iterable de bytes binarios.

Argumentos
format Es el formato de salida deseado. Todos los formatos de salida de trama comunes son compatibles. El valor predeterminado es "png" (Gráficos de red portátiles).

tuple getRawPixel (integer x, integer y)

Muestra el píxel único de la ubicación de la imagen (x,y), como un tuple de integer, con el formato (a,r,g,b).

Argumentos
x Posición horizontal del píxel, comenzando por 0 en la parte izquierda de la pantalla en la orientación que tenía cuando se tomó la captura de pantalla.
y Posición vertical del píxel, comenzando por 0 en la parte superior de la pantalla, en la orientación que tenía cuando se tomó la captura de pantalla.
Resultado que se muestra
  • Es una tupla de números enteros que representa el píxel, en el formato (a,r,g,b), donde "a" es el valor del canal Alfa, y "r", "g" y "b" son los valores rojo, verde y azul respectivamente.

tuplegetRawPixelInt (integer x, integer y)

Muestra el único píxel en la ubicación de imagen (x,y), como integer. Usa este método para ahorrar memoria.

Argumentos
x Posición horizontal del píxel, comenzando por 0 en la parte izquierda de la pantalla en la orientación que tenía cuando se tomó la captura de pantalla.
y Posición vertical del píxel, comenzando por 0 en la parte superior de la pantalla, en la orientación que tenía cuando se tomó la captura de pantalla.
Resultado que se muestra
  • Valores a, r, g y b del píxel como valores de 8 bits combinados en un número entero de 32 bits, donde "a" representa los primeros 8 bits de izquierda, "r" los siguientes hacia la derecha, y así sucesivamente.

MonkeyImage getSubImage (tuple rect)

Crea un nuevo objeto MonkeyImage a partir de una selección rectangular de la imagen actual.

Argumentos
rect Es una tupla (x, y, w, h) que especifica la selección. "x" e "y" especifican la posición del píxel basada en 0 de la esquina superior izquierda de la selección; "w" especifica el ancho de la región y "h" especifica la altura, ambos en unidades de píxeles.

La orientación de la imagen es la misma que la orientación que tenía la pantalla al momento de realizar la captura de pantalla.

Resultado que se muestra
  • Un nuevo objeto MonkeyImage que contiene la selección.

boolean sameAs ( MonkeyImage otherImage, float percent)

Compara este objeto MonkeyImage con otro y muestra el resultado de la comparación. El argumento percent especifica la diferencia de porcentaje que se permite para que las dos imágenes sean "iguales".

Argumentos
other Otro objeto MonkeyImage para comparar con este.
percent Un tipo flotante en el rango de 0.0 a 1.0 inclusive, que indica el porcentaje de píxeles que deben ser los mismos para que el método muestre true. El valor predeterminado es 1.0, e indica que todos los píxeles deben coincidir.
Resultado que se muestra
  • Booleano true si las imágenes coinciden o booleano false si no lo hacen.

void writeToFile (string filename, string format)

Escribe la imagen actual en el archivo especificado por filename, en el formato especificado por format.

Argumentos
path Es el nombre de archivo completo y extensión del archivo de salida.
format Formato de salida que se usará para el archivo. Si no se proporciona ningún formato, el método intentará adivinar el formato a partir de la extensión del nombre de archivo. Si no se proporciona ninguna extensión y no se especifica ningún formato, se utilizará el formato predeterminado de "png" (Gráficos de red portátiles).