add text watermarks and image watermarks to images - Edge Security Acceleration: Central de Documentação do Alibaba Cloud

Parâmetros

image_process=watermark

Parâmetros básicos (posições da marca d'água)

Parâmetro	Descrição	Faixa de valores
t	Opacidade da marca d'água.	`[0,100]` Valor padrão: `100`. O valor 100 indica que a marca d'água é totalmente opaca.
g	Posição da marca d'água na imagem.	nw: canto superior esquerdo north: parte superior central ne: canto superior direito west: meio à esquerda center: centro east: meio à direita sw: canto inferior esquerdo south: parte inferior central se: canto inferior direito
x	Margem horizontal entre a marca d'água e a borda da imagem. Este parâmetro só tem efeito quando a marca d'água está no lado esquerdo ou direito da imagem.	`[0,4096]` Valor padrão: `10`. Unidade: `px`.
y	Margem vertical entre a marca d'água e a borda da imagem. Este parâmetro só tem efeito quando a marca d'água está na parte superior ou inferior da imagem.	`[0,4096]` Valor padrão: `10`. Unidade: `px`.

Nota

Use x, y e offset para ajustar as posições da marca d'água. Esses parâmetros também ajudam a organizar o layout quando uma imagem possui várias marcas d'água.

Parâmetros de marca d'água de imagem

Parâmetro

Descrição

Faixa de valores

image

URL da imagem da marca d'água, que deve ser publicamente acessível. Se a URL exigir autenticação ou permissões específicas, o ESA poderá falhar ao recuperar a imagem.

A URL deve estar codificada em Base64. Para obter mais informações, consulte Codificar marcas d'água.

Strings codificadas em Base64

Parâmetros de marca d'água de texto

Parâmetro	Descrição	Faixa de valores
text	Conteúdo da marca d'água de texto, que deve estar codificado em Base64. Para obter mais informações, consulte Codificar marcas d'água.	String codificada em Base64 com até 60 caracteres
type	Fonte da marca d'água de texto, que deve estar codificada em Base64. Para obter mais informações, consulte Codificar marcas d'água.	É possível especificar até 10 fontes. Para obter informações sobre as fontes suportadas e seus valores codificados, consulte configurações e codificação de type.
color	Cor da marca d'água de texto, especificada como um valor hexadecimal RGB.	Por exemplo, 000000 especifica preto e FFFFFF especifica branco. Valor padrão: `000000`.
rotate	Ângulo de rotação horária da marca d'água de texto.	`[0,360]` Valor padrão: `0`. O valor 0 significa sem rotação. Unidade: °.
fill	Define se a imagem será preenchida em mosaico com a marca d'água de texto.	Valores válidos: `0` e `1`. Valor padrão: `0`. 0: não preenche a imagem em mosaico com a marca d'água de texto. 1: preenche a imagem em mosaico com a marca d'água de texto.
size	Tamanho da fonte da marca d'água de texto.	`[1,1000]` Valor padrão: `40`. Unidade: `px`.

Configurações e codificação de type

Fonte de texto	Descrição	Valor codificado
alihyaihei	Fonte em negrito. Esta é a fonte padrão.	YWxpaHlhaWhlaQ
hysong	Variante da fonte Songti.	aHlzb25n
hyhei	Variante da fonte Heiti.	aHloZWk
hyshuangxian	Fonte de linha dupla.	aHlzaHVhbmd4aWFu
fzltzhk	Variante da fonte Heiti.	ZnpsdHpoaw
fzshengsks	Fonte de escrita regular.	ZnpzaGVuZ3Nrcw
fzqusongjian	Variante da fonte Songti.	ZnpxdXNvbmdqaWFu
zzgfxingyan	Fonte artística.	enpnZnhpbmd5YW4
comfortaa	Comfortaa	Y29tZm9ydGFh
notosans	NotoSans	bm90b3NhbnM

Nota

Se você especificar uma fonte que não esteja na lista acima, o sistema usará a fonte padrão alihyaihei.

Codificar marcas d'água

Ao adicionar marcas d'água, codifique o conteúdo de texto e o nome da fonte, ou a URL da imagem da marca d'água, em Base64 usando caracteres seguros para URL. Para codificar marcas d'água, execute as etapas a seguir:

Codifique o conteúdo da marca d'água em Base64.

Nota

Recomendamos o uso de ferramentas de codificação Base64 seguras para URL para codificar o conteúdo de texto, os nomes das fontes e as URLs das imagens de marca d'água. O conteúdo da marca d'água codificado em Base64 aplica-se apenas aos parâmetros específicos da marca d'água. Não inclua conteúdo de marca d'água codificado em Base64 nas strings de assinatura.

Substitua os caracteres no conteúdo da marca d'água codificado em Base64 com base nas seguintes regras:
- Substitua os sinais de mais (+) por hifens (-).
- Substitua as barras (/) por sublinhados (_).
- Omita os sinais de igual (=) no final do conteúdo da marca d'água codificado em Base64.

Exemplos

Adicionar a marca d'água de texto "Hello World".

Codifique a marca d'água de texto Hello World em Base64 seguro para URL. Para obter mais informações, consulte Codificar marcas d'água. O texto codificado é SGVsbG8gV29ybGQ. O valor codificado da fonte hysong é aHlzb25n. A URL de processamento de imagem é http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n.

Adicionar marcas d'água de texto e de imagem.
- Codifique a marca d'água de texto "Happy New Year" em Base64 seguro para URL para obter a string 5paw5bm05b-r5LmQ. Defina a posição da marca d'água como canto inferior direito, margem horizontal como 10 pixels e deslocamento vertical como 10 pixels usando g_se,x_10,y_10.
- Codifique a URL da imagem da marca d'água http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png em Base64 seguro para URL para obter a string aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n. Defina a posição da marca d'água como canto superior esquerdo, margem horizontal como 10 pixels e deslocamento vertical como 10 pixels usando g_nw,x_10,y_10.
- Especifique a URL de processamento de imagem como http(s)://example.com/image01.png?image_process=watermark,text_5paw5bm05b-r5LmQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10.