MonkeyImage

Classe do monkeyrunner que guarda uma imagem da tela do dispositivo ou do emulador. A imagem é copiada do buffer de tela durante uma captura de tela. Os métodos desse objeto permitem converter a imagem em vários formatos de armazenamento, gravar a imagem em um arquivo, copiar partes dela e comparar esse com outros objetos MonkeyImage.

Não é necessário criar novas instâncias da MonkeyImage. Em vez disso, use MonkeyDevice.takeSnapshot() para criar uma nova instância de uma captura de tela. Por exemplo, use: 

newimage = MonkeyDevice.takeSnapshot()

Resumo

Métodos
string convertToBytes (string format)
Converte a imagem atual em um formato específico e retorna como uma string que pode ser acessada como um iterável de bytes binários.
tuple getRawPixel (integer x, integer y)
Retorna o único pixel no local da imagem (x, y) como tupla de número inteiro, no formato (a,r,g,b).
integer getRawPixelInt (integer x, integer y)
Retorna o único pixel no local da imagem (x, y) como um número inteiro de 32 bits.
MonkeyImage getSubImage (tuple rect)
Cria um novo objeto MonkeyImage de uma seleção retangular da imagem atual.
boolean sameAs (MonkeyImage other, float percent)
Compara esse objeto MonkeyImage com outro e retorna o resultado da comparação. O argumento percent especifica a diferença percentual permitida para que as duas imagens sejam "iguais".
void writeToFile (string path, string format)
Grava a imagem atual no arquivo especificado por filename no formato especificado por format.

Métodos públicos

string convertToBytes ( string format)

Converte a imagem atual em um formato específico e a retorna como uma string que você pode acessar como um iterável de bytes binários.

Argumentos
formato Formato de saída desejado. Todos os formatos de saída rasterizados comuns são compatíveis. O valor padrão é "png" (Portable Network Graphics).

tuple getRawPixel (integer x, integer y)

Retorna o único pixel no local da imagem (x, y) como tupla de número inteiro, no formato (a,r,g,b).

Argumentos
x Posição horizontal do pixel, começando com 0 no lado esquerdo da tela, na orientação do momento em que a captura de tela foi feita.
y Posição vertical do pixel, começando com 0 no topo da tela, na orientação do momento em que a captura de tela foi feita.
Retornos
  • Tupla de números inteiros que representa o pixel na forma (a,r,g,b), em que "a" é o valor do canal Alfa, e "r", "g" e "b" são os valores vermelho, verde e azul, respectivamente.

tuple getRawPixelInt (integer x, integer y)

Retorna o único pixel no local da imagem (x, y) como um número inteiro. Use esse método para economizar memória.

Argumentos
x Posição horizontal do pixel, começando com 0 no lado esquerdo da tela, na orientação do momento em que a captura de tela foi feita.
y Posição vertical do pixel, começando com 0 no topo da tela, na orientação do momento em que a captura de tela foi feita.
Retornos
  • Valores "a", "r", "g" e "b" do pixel na forma de valores de 8 bits, combinados em um inteiro de 32 bits, em que "a" são os 8 bits mais à esquerda, "r" os próximos à direita e assim por diante.

MonkeyImage getSubImage (tuple rect)

Cria um novo objeto MonkeyImage de uma seleção retangular da imagem atual.

Argumentos
rect Uma tupla (x, y, w, h) que especifica a seleção. Os valores "x" e "y" especificam a posição do pixel baseada em 0 do canto superior esquerdo da seleção, enquanto "w" especifica a largura da região e "h" especifica a altura, ambas em unidades de pixels.

A orientação da imagem é a mesma que a da tela no momento em que a captura de tela foi feita.

Retornos
  • Um novo objeto MonkeyImage que contém a seleção.

boolean sameAs ( MonkeyImage otherImage, float percent )

Compara esse objeto MonkeyImage com outro e retorna o resultado da comparação. O argumento percent especifica a diferença percentual permitida para que as duas imagens sejam "iguais".

Argumentos
outro Outro objeto MonkeyImage para comparar com este.
porcentagem Uma flutuação no intervalo de 0,0 a 1,0, indicando o percentual de pixels que precisam ser iguais para o método retornar true. O padrão é 1,0, indicando que todos os pixels precisam ser correspondentes.
Retornos
  • Booleano true se as imagens forem correspondentes. Caso contrário, booleano false.

void writeToFile (string filename, string format)

Grava a imagem atual no arquivo especificado por filename no formato especificado por format.

Argumentos
caminho O nome de arquivo e a extensão totalmente qualificados do arquivo de saída.
formato Formato de saída a ser usado para o arquivo. Se nenhum formato for providenciado, o método tentará adivinhar o formato a partir da extensão do nome de arquivo. Se nenhuma extensão for informada e nenhum formato for especificado, o formato padrão "png" (Portable Network Graphics) será usado.