API Reference

A transformação "Watermark" é uma funcionalidade que permite adicionar uma marca d'água às suas imagens. Esta operação oferece a flexibilidade de personalizar a opacidade, o tamanho e a posição da marca d'água para se adequar às suas necessidades específicas.

Estrutura do Parâmetro

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

/watermark:[url_da_watermark],[argumentos opcionais]/

/watermark:https://example.com/my_wattermark.png/- Para aplicar marca d'água com os valores padrão

/watermark:https://example.com/my_wattermark.png,opacity:0.5/ - Para aplicar marca d'água com 50% de opacidade

/watermark:https://example.com/my_wattermark.png,size:200x300/- Para aplicar marca d'água com tamanho fixo definido

/watermark:https://example.com/my_wattermark.png,size:50p/ - Para aplicar marca d'água com tamanho de 50% referente a largura da imagem base.

/watermark:https://example.com/my_wattermark.png,position:north/ - Para aplicar a marca d'água no posição north

Argumentos Opcionais

  • opacity: Define a opacidade da marca d'água, variando de 0 (totalmente transparente) a 1 (totalmente opaco).
    O valor padrão é 1.
  • size: Especifica o tamanho da marca d'água. Pode ser definido com dimensões específicas (ex.: "200x300"), mantendo o aspect ratio (ex.: "200x" ou "x300") ou em porcentagem do tamanho da largura da imagem base (ex.: "50p").
    O valor padrão é 50p
  • position: Determina a posição da marca d'água na imagem. Valores disponíveis são: north, northeast, east, southeast, south, southwest, west, northwest, e center.
    O valor padrão é "center".

Exemplos de Uso

Para adicionar uma marca d'água com opacidade padrão e posição centralizada, a URL seria:

https://img.voidr.co/meu_projeto/watermark:https://example.com/minha_marca_dagua.png/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8

Para adicionar uma marca d'água com 50% de opacidade, tamanho de 600x120 pixels, a URL seria:

https://img.voidr.co/meu_projeto/watermark:https://assets.voidr.co/images/logo-voidr-images.png,opacity:0.5,size:600x120/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8

Para adicionar uma marca d'água ocupando 50% da imagem original, com opacidade total na posição south, a URL seria:

https://img.voidr.co/meu_projeto/watermark:https://example.com/minha_marca_dagua.png,size:50p,position:south/fetch/https://images.unsplash.com/photo-1561336313-0bd5e0b27ec8>