Cortar Imagem / Crop Image
Função que corta a imagem passada por parâmetro.
Figura 1 - Bloco Cortar Imagem
Compatibilidade
Bloco servidor: cronapi.io.Operations.cropImage()
Retorno
Retorna um array de bytes representando a imagem cortada.
Parâmetros
Imagem
Campo destinado a receber a imagem que será cortada. Os tipos de valores aceitáveis são: caminho absoluto, URL, Base64 e array de bytes.
Posição: 1
Inglês: Imäge
Tipo: Objeto / Object
Exemplo: retorno do bloco Ler todo conteúdo do arquivo em bytes
Nova Largura
Define o limite da largura para o corte.
Posição: 2
Inglês: New width
Tipo: Inteiro / Integer
Exemplo: 300
Nova Altura
Define o limite da altura para o corte.
Posição: 3
Inglês: New height
Tipo: Inteiro / Integer
Exemplo: 100
Exemplo
A imagem a seguir apresenta um exemplo de uso do bloco Cortar Imagem. Abaixo detalharemos cada função utilizada.
Figura 2 - Exemplo de uso do bloco Cortar Imagem
Destaques da Figura 2:
Criação da variável "origem", responsável por armazenar o caminho da imagem original.
Criação da variável "destino", responsável por indicar o caminho e o nome do novo arquivo.
A variável "refArquivoOrigem" recebe o bloco de programação Abrir arquivo para leitura, cujo valor recebido é a variável "origem".
Qualquer tipo de manipulação de imagem é feita através dos bytes da imagem, por isso criamos a variável "bytesImg" que recebe o bloco Cortar Imagem. No parâmetro "Imagem" do bloco, inserimos o bloco Ler todo o conteúdo do arquivo em bytes, responsável por converter o conteúdo do arquivo aberto em array de bytes. E nos parâmetros "Nova Largura" e "Nova Altura" inserimos os valores que definem o limite de corte da imagem a partir do centro.
Utilizamos o bloco Fechar o arquivo, passando como referência a variável "refArquivoOrigem".
Utilizamos a variável "refArquivoDestino" juntamente com o bloco Abrir arquivo para escrita, que recebe a variável "destino" (caminho do novo arquivo) e o valor nulo como conteúdo.
No bloco Adicionar conteúdo a arquivo, inserimos, no primeiro parâmetro, a variável "refArquivoDestino" e, no segundo parâmetro, a variável "bytesImg".
Após a escrita do novo arquivo, ele é fechado utilizando o bloco Fechar o arquivo.
Por fim, faz-se o download do arquivo utilizando o bloco Iniciar download de arquivo físico.
As imagens abaixo exibe o arquivo de imagem original (Figura 2.1) e a imagem resultante baixada (Figura 2.2) após a execução da função da Figura 2.
Figura 2.1 - Imagem original
Figura 2.2 - Imagem após execução da função
Nesta página
- 1 Compatibilidade
- 2 Retorno
- 3 Parâmetros
- 3.1 Imagem
- 3.2 Nova Largura
- 3.3 Nova Altura
- 4 Exemplo