Participe do evento ⁠#Android11: apresentação de lançamento da versão Beta no dia 3 de junho.

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 (formato da string)
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.
tupla getRawPixel (número inteiro x, número inteiro y)
Retorna o único pixel no local da imagem (x, y) como tupla de número inteiro, no formato (a,r,g,b).
número inteiro getRawPixelInt (número inteiro x, número inteiro y)
Retorna o único pixel no local da imagem (x, y) como um número inteiro de 32 bits.
MonkeyImage getSubImage (rect de tupla)
Cria um novo objeto MonkeyImage de uma seleção retangular da imagem atual.
booleano sameAs (outra MonkeyImage, porcentagem de flutuação)
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".
nulo writeToFile (caminho da string, formato da string)
Grava a imagem atual no arquivo especificado por filename no formato especificado por format.

Métodos públicos

string convertToBytes ( formato de string)

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).

tupla getRawPixel (número inteiro x, número inteiro 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.

tupla getRawPixelInt (número inteiro x, número inteiro 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 (rect de tupla)

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.

booleano sameAs (otherImage MonkeyImage , porcentagem de flutuação)

Compara este 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 a porcentagem 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.

nulo writeToFile (nome de arquivo da string, formato da string)

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.