Ir para o conteúdo

Tela de Exibição

Usando os métodos abaixo, você poderá interagir com a tela.

Obtendo o tamanho da tela

Usando o método display size, você pode obter a dimensão da tela (largura e altura) em pixels.

# Definindo uma variável para receber o método display_size.
tamanho_tela = bot.display_size()

# Imprima o tamanho da tela em pixels.
print(tamanho_tela)
// Método não implementado.
// Definindo uma variável para receber o método display_size.
const tamanho_tela = await desktopBot.display_size()

// Imprima o tamanho da tela em pixels.
console.log(tamanho_tela)
// Definindo uma variável para receber o método display_size.
const tamanho_tela: displaySize = await desktopBot.display_size()

// Imprima o tamanho da tela em pixels.
console.log(tamanho_tela)

Obtendo uma captura de tela

Com o método get screenshot, é possível fazer uma captura de tela e salvá-la em qualquer diretório passando o caminho como um parâmetro.

# Tire uma captura de tela, salve o arquivo se o caminho for passado e retorne o objeto Image.
bot.get_screenshot(filepath='meu_screenshot_com_metodo_get_screenshot.png')

Dica

O método possui um parâmetro opcional region que é uma tupla com valores de esquerda(left), superior(top), largura(width) e altura(height) para cortar uma parte da tela. Saiba mais na documentação completa da API.

// Tire uma captura de tela e retorne o objeto MarvinImage.
MarvinImage screen = getScreenShot();
// Tire uma captura de tela, salve o arquivo se o caminho for passado e retorne o caminho utilizado.
await desktopBot.screenshot('/home/usuario/', 'meu_screenshot_com_metodo_get_screenshot.png')
// Tire uma captura de tela, salve o arquivo se o caminho for passado e retorne o caminho utilizado.
await desktopBot.screenshot('/home/usuario/', 'meu_screenshot_com_metodo_get_screenshot.png')

Obtendo uma captura parcial da tela

Como vimos acima, é possível tirar uma captura de tela utilizando a tela inteira como referência. Usando o método screen cut e passando como parâmetro as coordenadas x e y junto com a largura e a altura, somente a área indicada será coletada.

# Capturando parte da tela.
parte_da_tela = bot.screen_cut(x=702, y=380, width=120, height=80)

# A variável `parte_da_tela` é o objeto Image retornado da captura de tela.
// Capturando parte da tela.
MarvinImage parteDaTela = screenCut(702, 380, 120, 80);

// A variável `parteDaTela` é o objeto MarvinImage retornado da captura de tela.
// Capturando parte da tela.
Const parte_da_tela = await desktopBot.screenCut(702, 380, 120, 80);
// Capturando parte da tela.
const parte_da_tela: Image = await desktopBot.screenCut(702, 380, 120, 80);

Salvando uma captura de tela

O método save screenshot tem praticamente a mesma funcionalidade que os métodos get_screenshot e screenshot.

A única diferença é que ele não retorna um objeto de imagem. Ao invés disso, a imagem será salva no disco.

# Tire e salve uma captura de tela.
bot.save_screenshot("screenshot.png")
// Tire e salve uma captura de tela.
saveScreenshot("screenshot.png");
// Tire e salve uma captura de tela.
await desktopBot.screenshot('/home/usuario/', 'meu_screenshot_com_metodo_get_screenshot.png')
// Tire e salve uma captura de tela.
await desktopBot.screenshot('/home/usuario/', 'meu_screenshot_com_metodo_get_screenshot.png')