Edição e conversão de imagens
image.open_imageCarrega imagem de arquivo
Carrega uma imagem de arquivo (PNG, JPG, BMP, WebP...) numa variável para os demais comandos de imagem.
Exemplo: Abra C:\Robos\entrada\foto.jpg em {image}.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Arquivo de imagem * | Arquivo | ||
| Salvar a imagem na variável * | Variável de saída | image |
Resultado: guardado na variável image (Objeto).
image.save_imageSalva imagem em arquivo
Salva a imagem num arquivo; o formato vem da extensão, e a qualidade vale para JPEG e WebP.
Exemplo: Salve {image} como C:\Robos\saida\foto_{id}.jpg com qualidade 85.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Imagem * | Arquivo | Um arquivo, ou uma variável com imagem ({imagem}) | |
| Salvar como (formato pela extensão) * | Arquivo |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Qualidade JPEG/WebP | Número | 90 |
image.resizeAltera dimensões
Muda o tamanho da imagem. Com as proporções mantidas, ela cabe dentro da largura e altura informadas; deixe uma vazia para calcular pela outra.
Exemplo: Redimensione {image} para 800 de largura antes de enviar ao portal.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Imagem * | Arquivo | Um arquivo, ou uma variável com imagem ({imagem}) | |
| Largura (vazio = proporcional) | Número | ||
| Altura (vazio = proporcional) | Número | ||
| Manter as proporções (cabe dentro) | Sim/Não | Sim | |
| Salvar a imagem na variável * | Variável de saída | image |
Resultado: guardado na variável image (Objeto).
image.cropRecorta região
Recorta uma região da imagem (esquerda, topo, largura, altura em pixels).
Exemplo: Recorte 0, 0, 600 × 120 da imagem do documento para ficar só com o cabeçalho.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Imagem * | Arquivo | Um arquivo, ou uma variável com imagem ({imagem}) | |
| Esquerda * | Número | ||
| Topo * | Número | ||
| Largura * | Número | ||
| Altura * | Número | ||
| Salvar a imagem na variável * | Variável de saída | image |
Resultado: guardado na variável image (Objeto).
image.rotateRotaciona por graus
Gira a imagem pelos graus informados, no sentido horário, aumentando a área para não cortar os cantos se marcado.
Exemplo: Gire 90 graus as fotos de documentos tiradas na vertical.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Imagem * | Arquivo | Um arquivo, ou uma variável com imagem ({imagem}) | |
| Graus (sentido horário) | Número | 90 ° | |
| Salvar a imagem na variável * | Variável de saída | image |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Aumentar para não cortar os cantos | Sim/Não | Sim |
Resultado: guardado na variável image (Objeto).
image.convert_formatConverte entre PNG, JPEG, BMP, etc.
Salva a imagem em outro formato (PNG, JPEG, BMP, WebP...), escolhido pela extensão do novo arquivo.
Exemplo: Converta comprovante.bmp em comprovante.png.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Imagem * | Arquivo | Um arquivo, ou uma variável com imagem ({imagem}) | |
| Novo arquivo (formato pela extensão) * | Arquivo | ||
| Salvar o caminho na variável | Variável de saída |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Qualidade JPEG/WebP | Número | 90 |
Resultado: guardado na variável escolhida (Texto).
image.add_textDesenha texto sobre a imagem
Escreve um texto sobre a imagem na posição, tamanho e cor escolhidos, com uma faixa de fundo opcional para ficar legível.
Exemplo: Escreva "Conferido em {data}" no canto superior com faixa branca.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Imagem * | Arquivo | Um arquivo, ou uma variável com imagem ({imagem}) | |
| Texto * | Texto (várias linhas) | ||
| X | Número | 10 px | |
| Y | Número | 10 px | |
| Tamanho da fonte | Número | 24 px | |
| Cor | Texto | #000000 | |
| Salvar a imagem na variável * | Variável de saída | image |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Cor da faixa de fundo (vazio = sem faixa) | Texto |
Resultado: guardado na variável image (Objeto).
image.compareCalcula similaridade entre imagens
Compara duas imagens e guarda a semelhança em porcentagem.
Exemplo: Compare a assinatura digitalizada com a de referência e siga se {similarity} >= 90.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Imagem * | Arquivo | Um arquivo, ou uma variável com imagem ({imagem}) | |
| Outra imagem * | Arquivo | Um arquivo, ou uma variável com imagem ({imagem}) | |
| Salvar resultado na variável * | Variável de saída | similarity | 0 a 100 (%); acima de ~95 é praticamente igual |
Resultado: guardado na variável similarity (Número).