Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Cortar Imagem

Função que corta a imagem passada por parâmetro.

Parâmetros de Entrada

Parâmetros

Nome

Tipo

Doc

Parâmetro 1ImagemObjetoCampo destinado a receber a imagem que será redimensionada.
Parâmetro 2LarguraStringNuméricoDefine o limite da largura para o corte
Parâmetro 3AlturaStringNuméricoDefine o limite da altura para o corte

Retorno

Retorna uma imagem com as dimensões cortadas

Compatibilidade

 Servidor

Exemplo

Para este exemplo, faremos uma cópia da imagem original, com o objetivo de comparar o arquivo antes e depois da execução da função. 


Figura 1 -  Função que recorta uma imagem


  1. Criação da variável "origem", responsável por obter o caminho da imagem original.
  2. Criação da variável "destino", responsável por indicar o caminho e o nome do novo arquivo.
  3. A variável refArquivoOrigem recebe o bloco de programação Abrir arquivo para leitura, cujo valor recebido é a variável "origem".
  4. Qualquer tipo de manipulação de imagem é feita através dos bytes da imagem, por isso criamos a variável bytesImg, recebendo  recebendo o bloco de programação Ler todo o conteúdo do arquivo em bytes, ele é responsável por transformar converter o conteúdo da variável refArquivoOrigem, que consta o caminho da imagem. em bytesdo arquivo aberto em array de byte.
  5. Para manipular a imagem utilizaremos o bloco de programação Cortar Imagem, o primeiro parâmetro recebe a variável bytesImg, os dois atributos seguintes receberão os parâmetros "largura" e "altura", eles definirão os limites de corte da imagem a partir do centro da imagem.
  6. Nesse ponto não precisamos mais mexer o arquivo original, por isso podemos utilizar o bloco de programação Fechar o arquivo, passando como referência a variável refArquivoOrigem.
  7. Utilizamos a variável refArquivoDestino juntamente com o bloco Abrir arquivo para escrita, recebendo que recebe a variável "destino", para indicar o caminho da nova imagem cortadacom o caminho do novo arquivo comprimido e passamos o valor "null" em seu conteúdo.
  8. Agora escreveremos alimentamos o novo arquivo redimensionado no caminho de destino, utilizando o bloco de programação Adicionar conteúdo a arquivo, passando dois parâmetros: a variável refArquivoDestino e a variável bytesImg,criado no passo 7 com o array de byte da imagem, variável "bytesImg".
  9. Após a escrita do novo arquivo podemos fechar o arquivo de destino.
  10. E por fim, faremos o download do arquivo, através do bloco de programação Iniciar download do arquivo físico.


A figura 2 exibe a imagem original antes do corte.


Figura 2 - Imagem original


A figura 3 exibe uma cópia da imagem da figura 2 cortada.


Figura 3 - Cópia cortada da imagem da figura 2

Sobre o bloco

Os tipos de valores suportados no parâmetro Imagem do bloco de programação Redimensionar Imagem são: Caminho absoluto, URL, Base64 e Array de Bytes,