API Reference

A transformação Resize é uma ferramenta fundamental para ajustar as dimensões de suas imagens. Seja para garantir que as imagens se encaixem em layouts específicos ou para otimizar o desempenho do carregamento.

Estrutura do Parâmetro

Para aplicar a transformação Resize, a URL deve ser estruturada da seguinte maneira:

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

/resize:800x600/ Para redimensionar para uma largura de 800 pixels e altura de 600 pixels.

/resize:800x/ Para redimensionar mantendo a proporção original, ajustando apenas a largura para 800 pixels.

/resize:x600/ Para redimensionar mantendo a proporção original, ajustando apenas a altura para 600 pixels.

/resize:800x600,fit:fill/ Para redimensionar, sem respeitar o aspect ratio, possivelmente gerando um efeito "esticado" na imagem.

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

https://img.voidr.co/meu_projeto/resize:800x600/fetch/:url

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

Argumentos Opcionais

⚠️ Esse transformador aceita argumentos opcionais, caso não especificado, o fit padrão é sempre cover

  • fit Define como a imagem deve ser ajustada às dimensões especificadas. Os valores disponíveis são:
    • contain Redimensiona a imagem para caber dentro das dimensões especificadas, mantendo a proporção.
    • cover Redimensiona a imagem para preencher completamente as dimensões especificadas, podendo cortar partes da imagem.
    • fill Redimensiona e deforma a imagem para preencher exatamente as dimensões especificadas.
    • inside Redimensiona a imagem para caber dentro das dimensões especificadas sem deformação.
    • outside Redimensiona a imagem para cobrir as dimensões especificadas e ainda manter a proporção.

Exemplos de Uso

Para redimensionar uma imagem para 800x600 pixels utilizando o fit padrão cover, a URL seria:

https://img.voidr.co/meu_projeto/resize:800x600/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8

Para redimensionar uma imagem para 500x200 pixels utilizando o fit fill, a URL seria:

https://img.voidr.co/meu_projeto/resize:500x200,fit:fill/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8

Para redimensionar uma imagem para 800x600 pixels utilizando o fit contain, a URL seria:

https://img.voidr.co/meu_projeto/resize:800x600,fit:contain/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8

Para redimensionar uma imagem para 800x600 pixels utilizando o fit outside, a URL seria:

https://img.voidr.co/meu_projeto/resize:800x600,fit:outside/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8

Para redimensionar uma imagem para 800x600 pixels utilizando o fit inside, a URL seria:

https://img.voidr.co/meu_projeto/resize:800x600,fit:inside/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8