add text watermarks and image watermarks to images - Edge Security Acceleration

Paramètres

image_process=watermark

Paramètres de base (positions du filigrane)

Paramètre	Description	Plage de valeurs
t	Opacité du filigrane.	`[0,100]` Valeur par défaut : `100`. Une valeur de 100 indique que le filigrane est totalement opaque.
g	Position du filigrane sur l'image.	nw : haut gauche north : haut centre ne : haut droite west : milieu gauche center : centre east : milieu droite sw : bas gauche south : bas centre se : bas droite
x	Marge horizontale entre le filigrane et le bord de l'image. Ce paramètre s'applique uniquement lorsque le filigrane est situé sur le côté gauche ou droit de l'image.	`[0,4096]` Valeur par défaut : `10`. Unité : `px`.
y	Marge verticale entre le filigrane et le bord de l'image. Ce paramètre s'applique uniquement lorsque le filigrane est situé en haut ou en bas de l'image.	`[0,4096]` Valeur par défaut : `10`. Unité : `px`.

Remarque

Les paramètres x, y et offset permettent d'ajuster la position du filigrane. Ils facilitent également la mise en page lorsqu'une image comporte plusieurs filigranes.

Paramètres des filigranes graphiques

Paramètre

Description

Plage de valeurs

image

URL de l'image servant de filigrane, qui doit être accessible publiquement. Si l'URL nécessite une authentification ou des permissions spécifiques, ESA pourrait ne pas parvenir à récupérer l'image.

L'URL doit être encodée en Base64. Pour plus d'informations, consultez Encoder les filigranes.

Chaînes encodées en Base64

Paramètres des filigranes textuels

Paramètre	Description	Plage de valeurs
text	Contenu du filigrane textuel, devant être encodé en Base64. Pour plus d'informations, consultez Encoder les filigranes.	Chaîne encodée en Base64 de 60 caractères maximum
type	Police du filigrane textuel, devant être encodée en Base64. Pour plus d'informations, consultez Encoder les filigranes.	Vous pouvez spécifier jusqu'à 10 polices. Pour obtenir la liste des polices prises en charge et leurs valeurs encodées, consultez Paramètres et encodage du type.
color	Couleur du filigrane textuel, définie par une valeur hexadécimale RGB.	Par exemple, 000000 correspond au noir et FFFFFF au blanc. Valeur par défaut : `000000`.
rotate	Angle de rotation horaire du filigrane textuel.	`[0,360]` Valeur par défaut : `0`. Une valeur de 0 signifie aucune rotation. Unité : °.
fill	Indique si l'image doit être remplie avec le filigrane textuel en mosaïque.	Valeurs valides : `0` et `1`. Valeur par défaut : `0`. 0 : ne remplit pas l'image avec le filigrane textuel. 1 : remplit l'image avec le filigrane textuel en mosaïque.
size	Taille de police du filigrane textuel.	`[1,1000]` Valeur par défaut : `40`. Unité : `px`.

Paramètres et encodage du type

Police de texte

Description

Valeur encodée

alihyaihei

Police grasse. Il s'agit de la police par défaut.

YWxpaHlhaWhlaQ

hysong

Variante de police Songti.

aHlzb25n

hyhei

Variante de police Heiti.

aHloZWk

hyshuangxian

Police à double ligne.

aHlzaHVhbmd4aWFu

fzltzhk

Variante de police Heiti.

ZnpsdHpoaw

fzshengsks

Police de style écriture régulière.

ZnpzaGVuZ3Nrcw

fzqusongjian

Variante de police Songti.

ZnpxdXNvbmdqaWFu

zzgfxingyan

Police artistique.

enpnZnhpbmd5YW4

comfortaa

Comfortaa

Y29tZm9ydGFh

notosans

NotoSans

bm90b3NhbnM

Remarque

Si vous spécifiez une police absente de la liste ci-dessus, la police par défaut alihyaihei sera utilisée.

Encoder les filigranes

Lors de l'ajout de filigranes, vous devez encoder en Base64 le contenu textuel et le nom de la police, ou l'URL du filigrane graphique, en utilisant des caractères sûrs pour les URL. Pour encoder les filigranes, procédez comme suit :

Encodez le contenu du filigrane en Base64.

Remarque

Nous vous recommandons d'utiliser des outils d'encodage Base64 sûr pour URL pour encoder le contenu textuel, les noms de police et les URL des filigranes graphiques. Le contenu de filigrane encodé en Base64 s'applique uniquement aux paramètres spécifiques aux filigranes. N'incluez pas de contenu de filigrane encodé en Base64 dans les chaînes de signature.

Remplacez les caractères dans le contenu du filigrane encodé en Base64 selon les règles suivantes :
- Remplacez les signes plus (+) par des traits d'union (-).
- Remplacez les barres obliques (/) par des traits de soulignement (_).
- Omettez les signes égal (=) à la fin du contenu du filigrane encodé en Base64.

Exemples

Ajouter le filigrane textuel « Hello World ».

Encodez le filigrane textuel Hello World en Base64 sûr pour URL. Pour plus d'informations, consultez Encoder les filigranes. Le texte encodé est SGVsbG8gV29ybGQ. La valeur encodée pour la police hysong est aHlzb25n. L'URL de traitement d'image est http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n.

Ajouter des filigranes textuels et graphiques.
- Encodez le filigrane textuel « Happy New Year » en Base64 sûr pour URL afin d'obtenir la chaîne 5paw5bm05b-r5LmQ. Définissez la position du filigrane en bas à droite, avec une marge horizontale de 10 pixels et un décalage vertical de 10 pixels en utilisant g_se,x_10,y_10.
- Encodez l'URL du filigrane graphique http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png en Base64 sûr pour URL afin d'obtenir la chaîne aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n. Définissez la position du filigrane en haut à gauche, avec une marge horizontale de 10 pixels et un décalage vertical de 10 pixels en utilisant g_nw,x_10,y_10.
- Spécifiez l'URL de traitement d'image suivante : 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.