Add text watermarks and picture watermarks to meet specific requirements - CDN: Central de Documentação do Alibaba Cloud

O recurso de edição de imagens do Alibaba Cloud CDN permite sobrepor marcas d'água de texto e imagem nas imagens entregues via CDN sem modificar os arquivos originais. Use marcas d'água para proteger direitos autorais, adicionar identidade visual ou aplicar assinaturas às suas imagens.

Os recursos de edição de imagens do Alibaba Cloud CDN e da Dynamic Content Delivery Network (DCDN), bem como o recurso Image Processing (IMG) do Object Storage Service (OSS), são independentes e não podem ser usados indistintamente. A edição de imagens é gratuita até novo aviso.

Como funciona

Para aplicar marcas d'água, anexe o parâmetro de consulta image_process à URL da imagem. Cada marca d'água usa a ação watermark, seguida de seus parâmetros. Para aplicar várias marcas d'água, encadeie múltiplas ações watermark separadas por /.

http(s)://example.com/image01.png?image_process=watermark,<param1>_<value1>,<param2>_<value2>/watermark,<param1>_<value1>

Codifique todo o conteúdo de texto, nomes de fontes e URLs de imagens de marca d'água em Base64 seguro para URL antes do uso. Consulte Codificar valores de marca d'água.

Limites

Cada imagem suporta até cinco marcas d'água. Você pode combinar marcas d'água de texto e de imagem.
Marcas d'água de imagem não podem ser redimensionadas. A imagem original usada como marca d'água não deve exceder 1 MB.
Na conversão entre formatos de imagem (por exemplo, JPEG para WebP ou PNG para WebP), o arquivo de saída pode aumentar devido aos diferentes algoritmos de compressão. Defina o parâmetro quality para reduzir o tamanho do arquivo após a conversão.

Parâmetros

Parâmetros básicos

Estes parâmetros se aplicam tanto a marcas d'água de texto quanto de imagem.

Parâmetro	Descrição	Padrão	Intervalo
`t`	Opacidade. `100` indica opacidade total; `0` indica transparência total.	`100`	[0, 100]
`g`	Posição na imagem base. Consulte a tabela de valores de posição abaixo.	—	Veja abaixo
`x`	Margem horizontal em pixels. Aplica-se quando a marca d'água está na borda esquerda ou direita (`nw`, `west`, `sw`, `ne`, `east`, `se`).	`10`	[0, 4096]
`y`	Margem vertical em pixels. Aplica-se quando a marca d'água está na borda superior ou inferior (`nw`, `north`, `ne`, `south`, `se`).	`10`	[0, 4096]

Valores de posição para g:

Valor	Posição
`nw`	Superior esquerdo
`north`	Superior centralizado
`ne`	Superior direito
`west`	Centro à esquerda
`center`	Centro
`east`	Centro à direita
`sw`	Inferior esquerdo
`south`	Inferior centralizado
`se`	Inferior direito

Watermark position diagram

Use x e y juntos para ajustar com precisão o posicionamento da marca d'água, inclusive ao posicionar várias marcas d'água na mesma imagem.

Parâmetros de marca d'água de imagem

Parâmetro	Descrição	Valor
`image`	URL da imagem de marca d'água, codificada em Base64 seguro para URL. A URL deve ter acesso público. Se a URL exigir autenticação ou tiver restrições de acesso, o CDN poderá falhar ao recuperá-la.	String codificada em Base64

Parâmetros de marca d'água de texto

Parâmetro	Descrição	Padrão	Intervalo
`text`	Conteúdo de texto, codificado em Base64 seguro para URL.	—	Até 60 caracteres na string codificada em Base64
`type`	Nome da fonte, codificado em Base64 seguro para URL. Se a fonte especificada não estiver entre as 10 suportadas, o sistema usará `alihyaihei`.	`alihyaihei`	Consulte a tabela de fontes abaixo
`color`	Cor do texto como valor hexadecimal RGB de 6 dígitos.	`000000` (preto)	Por exemplo, `FFFFFF` para branco
`size`	Tamanho da fonte em pixels.	`40`	(0, 1000]
`rotate`	Rotação no sentido horário, em graus.	`0`	[0, 360]
`fill`	Repete a marca d'água por toda a imagem base. `1` ativa o preenchimento; `0` o desativa.	`0`	`0` ou `1`

Fontes suportadas:

Nome da fonte	Estilo	Valor codificado
`alihyaihei`	Negrito (padrão)	`YWxpaHlhaWhlaQ`
`hysong`	Variante Songti	`aHlzb25n`
`hyhei`	Variante Heiti	`aHloZWk`
`hyshuangxian`	Linha dupla	`aHlzaHVhbmd4aWFu`
`comfortaa`	Comfortaa	`Y29tZm9ydGFh`
`notosans`	NotoSans	`bm90b3NhbnM`

Codificar valores de marca d'água

Codifique todo o conteúdo da marca d'água (strings de texto, nomes de fontes e URLs de imagens) em Base64 seguro para URL. O Base64 padrão usa caracteres inseguros em URLs, portanto, duas substituições são necessárias.

Para codificar um valor de marca d'água:

Codifique o valor em Base64 usando uma ferramenta de codificação Base64 segura para URL.
Aplique as seguintes substituições de caracteres na saída codificada:
- Substitua + por -
- Substitua / por _
- Remova quaisquer caracteres = ao final da string

Importante

Use os valores codificados apenas nos parâmetros da marca d'água. Não os inclua nas strings de assinatura.

Exemplos

Marca d'água de texto

Adicione o texto "Hello World" na fonte Songti (hysong):

"Hello World" codifica-se como SGVsbG8gV29ybGQ
hysong codifica-se como aHlzb25n

http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n

Marcas d'água de texto e imagem combinadas

Aplique duas marcas d'água simultaneamente: uma de texto no canto inferior direito e outra de imagem no canto superior esquerdo:

Marca d'água de texto: "Hello World" → SGVsbG8gV29ybGQ, posicionada no canto inferior direito com margens de 10 px (g_se,x_10,y_10)
Marca d'água de imagem: a URL http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png codifica-se como aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n, posicionada no canto superior esquerdo com margens de 10 px (g_nw,x_10,y_10)

Separe várias ações de marca d'água com /:

http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10

Marca d'água em mosaico

Para repetir uma marca d'água de texto por toda a imagem, defina fill como 1. Combine com rotate para inclinar a marca d'água:

http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,fill_1,rotate_30,t_50

Esse comando repete "Hello World" com inclinação de 30 graus e 50% de opacidade.