A transformação Crop é uma funcionalidade para cortar suas imagens, permitindo ajustar o foco ou as dimensões de acordo com suas necessidades. Esta operação suporta cortes precisos com dimensões específicas, além de permitir o uso de coordenadas ou posições predefinidas para um controle mais refinado.

Estrutura do Parâmetro

A URL para aplicar a transformação Crop deve ser estruturada da seguinte forma:

/crop:[largura]x[altura],[argumentos opcionais]/

/crop:500x200/ Para definir altura e largura.

/crop:540x120,position:entropy/ Definindo posição de corte onde temos mais entropia de cores na imagem.

/crop:540x120,position:northeast/ Definindo posição de corte onde temos mais entropia de cores na imagem.

Para aplicar o corte, a URL deve ser formatada da seguinte maneira:

https://img.voidr.co/meu_projeto/crop:500x200/fetch/:url

Onde valor é o a largura e a altura em pixels, e opcionalmente uma configuração de position.

Argumentos Opcionais

⚠️ Esse transformador aceita argumentos opcionais, caso não especificado, o posicionamento do corte padrão é sempre attention

position Define a posição do corte, com valores predefinidos disponíveis.
- Posições utilizando a estratégia de gravidade disponíveis são:
  north, northeast, southeast, south, southwest, west, northwest, east, center
- entropy Foco em áreas com maior entropia.
- attention Foco em áreas com maior saturação de cor e presença de tons de pele.

Para cortar uma imagem para dimensões de 920x470 pixels em regiões com maior saturação, a URL deve ser estruturada da seguinte maneira:

https://img.voidr.co/meu_projeto/crop:920x470,position:attention/fetch/:url

Exemplos de Uso

Para cortar uma imagem para dimensões de 3000x3000 pixels com posicionamento de corte padrão attention, a URL seria:

https://img.voidr.co/meu_projeto/crop:3000x3000/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8

Para cortar uma imagem para dimensões de 2400x1400 pixels, e focando em areas com maior entropia de cores, a URL seria

https://img.voidr.co/meu_projeto/crop:2400x1400,position:entropy/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8

Para cortar uma imagem para dimensões de 2400x1400 pixels, a partir da posição northeast, a URL seria

https://img.voidr.co/meu_projeto/crop:2400x1400,position:northeast/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8

Para cortar uma imagem para dimensões de 4400x2400 pixels, a partir da posição south, a URL seria

https://img.voidr.co/meu_projeto/crop:4400x2400,position:south/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8