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 de este objeto permiten convertir la imagen en varios formatos de almacenamiento, escribir la imagen en un archivo, copiar partes de esta y comparar el objeto con otros de MonkeyImage.

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

newimage = MonkeyDevice.takeSnapshot()

Resumen

Métodos
string convertToBytes (formato de 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 píxel único de la ubicación de la imagen (x,y), como un 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 un número entero de 32 bits.
MonkeyImage getSubImage (tuple rect)
Crea un nuevo objeto MonkeyImage a partir de una selección rectangular de la imagen actual.
boolean sameAs (otro MonkeyImage , porcentaje de float)
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".
void writeToFile (ruta de acceso de string, formato de string)
Escribe la imagen actual en el archivo especificado por filename, en el formato especificado por format.

Métodos públicos

string convertToBytes ( formato de 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 único píxel en la ubicación de la imagen (x,y), como una tupla de número entero, 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.

tuple getRawPixelInt (integer x, integer y)

Muestra el único píxel en la ubicación de imagen (x,y), como un número entero. 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 la 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 medidos en píxeles.

La orientación de la imagen es la misma que la 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, porcentaje de 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".

Argumentos
other Es otro objeto MonkeyImage para comparar con este.
percent Es un número de punto flotante en el rango de 0.0 a 1.0 inclusive, que indica el porcentaje de píxeles que deben ser iguales 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
  • Es un valor booleano true si las imágenes coinciden, o bien un valor booleano false si no lo hacen.

void writeToFile (nombre de archivo de string, formato de string)

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á adivinarlo 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 PNG (Gráficos de red portátiles).