Ações de Tela

Ações de tela são ações para interagir com a tela do computador.

Ações

screen.crop_screen

Faz uma captura de tela da parte desejada da tela.

Parâmetros:

x - Posição mais à esquerda da tela a ser cortada

y - Posição superior da tela a ser cortada

width - Largura da tela a ser cortada

height - Altura da tela a ser cortada

save_path - Caminho para salvar a imagem de captura de tela recortada

Retorna:

screenshot - Imagem da tela inteira

crop - Imagem da área recortada

Exceções:

Esta ação não dá nenhuma exceção

screen.find_image

Encontre a melhor correspondência de imagem de modelo, de ativos, dentro da tela e retorne a posição na tela.

Parâmetros:

template_image - nome da imagem do recurso usada como modelo.

threshold (opcional) - correspondência mínima para considerar que o modelo foi encontrado (padrão=0,9 - 90%).

screenshot_img (opcional) - se o modelo deve ser encontrado em uma determinada tela ao lado da tela atual (padrão=Nenhum - faça uma nova captura de tela).

Retorna:

x - posição esquerda da imagem encontrada na tela/screenshot_img

y - posição superior da imagem encontrada na tela/screenshot_img

width - largura da imagem encontrada na tela/screenshot_img

height - altura da imagem encontrada na tela/screenshot_img

Exceções:

ImageNotFoundException - se nenhuma imagem correspondente for encontrada até que o tempo limite seja atingido

screen.find_image_center

Encontre a melhor correspondência de imagem de modelo, de ativos, dentro da tela e retorne a posição central da imagem encontrada.

Parâmetros:

template_image - nome da imagem do recurso usada como modelo.

threshold (opcional) - correspondência mínima para considerar que o modelo foi encontrado (padrão=0,9 - 90%).

screenshot_img (opcional) - se o modelo deve ser encontrado em uma determinada tela ao lado da tela atual (padrão=Nenhum - faça uma nova captura de tela).

Retorna:

x - posição central à esquerda da imagem encontrada na tela/screenshot_img

y - posição central da parte superior da imagem encontrada na tela/screenshot_img

screen.find_image_multiple

Encontre todas as correspondências da imagem do modelo, dentro da tela e retorne sua posição.

Parâmetros:

template_image - nome da imagem do recurso usada como modelo.

threshold (opcional) - correspondência mínima para considerar que o modelo foi encontrado (padrão=0,9 - 90%).

screenshot_img (opcional) - se o modelo deve ser encontrado em uma determinada tela ao lado da tela atual (padrão=Nenhum - faça uma nova captura de tela).

overlap_factor (opcional) - porcentagem de sobreposição para considerar a mesma imagem. Se a sobreposição entre duas imagens for maior que o overlap_factor, as duas imagens encontradas serão consideradas iguais (padrão=0,5 - 50%).

Retorna:

Lista de posições de imagem, com valores:

x[num] - posição esquerda da imagem encontrada na tela/screenshot_img

y[num] - posição superior da imagem encontrada na tela/screenshot_img

width[num] - largura da imagem encontrada na tela/screenshot_img

height[num] - altura da imagem encontrada na tela/screenshot_img

length - número de imagens encontradas

screen.find_image_multiple_center

Encontre todas as correspondências da imagem do modelo, dentro da tela e retorne sua posição central.

Parâmetros:

template_image - nome da imagem do recurso usada como modelo.

threshold (opcional) - correspondência mínima para considerar que o modelo foi encontrado (padrão=0,9 - 90%).

screenshot_img (opcional) - se o modelo deve ser encontrado em uma determinada tela ao lado da tela atual (padrão=Nenhum - faça uma nova captura de tela).

overlap_factor (opcional) - porcentagem de sobreposição para considerar a mesma imagem. Se a sobreposição entre duas imagens for maior que o overlap_factor, as duas imagens encontradas serão consideradas iguais (padrão=0,5 - 50%).

Retorna:

Lista de posições de imagem, com valores:

x[num] - posição central à esquerda da imagem encontrada na tela/screenshot_img

y[num] - posição central da parte superior da imagem encontrada na tela/screenshot_img

length - número de imagens encontradas

screen.screenshot

Faz uma captura de tela da tela inteira.

Parâmetros:

Esta ação não tem parâmetros

Retorna:

screenshot - Imagem da tela inteira

Exceções:

Esta ação não dá nenhuma exceção

screen.wait_image

Aguarda até que uma imagem correspondente apareça na tela.

Parâmetros:

template_image - nome da imagem do recurso usada como modelo.

threshold (opcional) - correspondência mínima para considerar que o modelo foi encontrado (padrão=0,9 - 90%).

screenshot_img (opcional) - se o modelo deve ser encontrado em uma determinada tela ao lado da tela atual (padrão=Nenhum - faça uma nova captura de tela).

timeout (opcional) - número máximo de segundos para esperar por uma imagem correspondente. Se nenhuma imagem correspondente, peras lança um ImageNotFoundException (padrão = 60).

Retorna:

x - posição esquerda da imagem encontrada na tela/screenshot_img

y - posição superior da imagem encontrada na tela/screenshot_img

width - largura da imagem encontrada na tela/screenshot_img

height - altura da imagem encontrada na tela/screenshot_img

Exceções:

ImageNotFoundException - se nenhuma imagem correspondente for encontrada até que o tempo limite seja atingido

screen.wait_images

Aguarda até que uma das imagens correspondentes apareça na tela.

Parâmetros:

template_image_list - lista com o nome das imagens de ativos usadas como modelo.

threshold (opcional) - correspondência mínima para considerar que o modelo foi encontrado (padrão=0,9 - 90%).

screenshot_img (opcional) - se o modelo deve ser encontrado em uma determinada tela ao lado da tela atual (padrão=Nenhum - faça uma nova captura de tela).

timeout (opcional) - número máximo de segundos para esperar por uma imagem correspondente. Se nenhuma imagem correspondente, peras lança um ImageNotFoundException (padrão = 60).

Retorna:

image_found- nome da imagem que foi encontrada na tela

x - posição esquerda da imagem encontrada na tela/screenshot_img

y - posição superior da imagem encontrada na tela/screenshot_img

width - largura da imagem encontrada na tela/screenshot_img

height - altura da imagem encontrada na tela/screenshot_img

Exceções:

ImageNotFoundException - se nenhuma imagem correspondente for encontrada até que o tempo limite seja atingido

Exemplo de uso

script.mvn

screen.wait_images(["error-1.png", "error-2.png"])

if $image_found == "error-1.png":
    prompt.alert("Erro 1 encontrado na tela")

elif $image_found == "error-2.png":
    prompt.alert("Erro 2 encontrado na tela")

screen.wait_image_disapear

Aguarda até que uma imagem correspondente desapareça da tela.

Parâmetros:

template_image - nome da imagem do recurso usada como modelo.

threshold (opcional) - correspondência mínima para considerar que o modelo foi encontrado (padrão=0,9 - 90%).

screenshot_img (opcional) - se o modelo deve ser encontrado em uma determinada tela ao lado da tela atual (padrão=Nenhum - faça uma nova captura de tela).

timeout (opcional) - número máximo de segundos para aguardar que uma imagem correspondente desapareça, caso contrário, lança um TimeoutException (padrão = 60).

Retorna:

Esta ação não tem retorno

Exceções:

TimeoutException - se a imagem correspondente ainda estiver visível após o tempo limite