CDN:Ajouter des filigranes

Remarques d'utilisation

• Vous pouvez ajouter un maximum de cinq filigranes à une image. Les filigranes image et textuels sont pris en charge.

• Le redimensionnement des filigranes image n'est pas possible. La taille de l'image de base utilisée comme filigrane ne doit pas dépasser 1 Mo.

Paramètres

Action : watermark

• Paramètres de base

  Parameter	Description	Value range
  t	L'opacité du filigrane textuel ou image.	[0,100] Valeur par défaut : 100. Une valeur de 100 indique que le filigrane est opaque.
  g	La position du filigrane sur l'image.	nw : en haut à gauche. north : en haut au centre. ne : en haut à droite. west : au milieu à gauche. center : au centre. east : au milieu à droite. sw : en bas à gauche. south : en bas au centre. se : en bas à droite. Pour plus d'informations sur les positions, consultez la figure suivante.
  x	La marge horizontale, c'est-à-dire la distance horizontale entre le filigrane et le bord de l'image. Ce paramètre prend effet uniquement lorsque le filigrane se trouve en haut à gauche, au milieu à gauche, en bas à gauche, en haut à droite, au milieu à droite ou en bas à droite de l'image.	[0,4096] Valeur par défaut : 10. Unité : pixels.
  y	La marge verticale, c'est-à-dire la distance verticale entre le filigrane et le bord inférieur de l'image. Ce paramètre prend effet uniquement lorsque le filigrane se trouve en haut à gauche, en haut au centre, en haut à droite, en bas au centre ou en bas à droite de l'image.	[0,4096] Valeur par défaut : 10. Unité : pixels.

Utilisez les paramètres x, y et offset pour ajuster la position d'un filigrane sur une image. Vous pouvez également utiliser ces paramètres pour organiser la disposition des filigranes lorsqu'une image en contient plusieurs.

• Paramètres des filigranes image

  Parameter	Description	Value range
  image	L'URL du filigrane accessible via Internet. Si une authentification ou des autorisations sont requises pour accéder à l'URL spécifiée, Alibaba Cloud CDN peut échouer à récupérer l'URL du filigrane. Les URL des filigranes doivent être encodées en Base64. Pour plus d'informations, consultez Encoder les filigranes.	Chaînes encodées en Base64

• Paramètres des filigranes textuels

  Parameter	Description	Value range
  text	Le contenu du filigrane textuel. Le contenu textuel doit être encodé en Base64. Pour plus d'informations, consultez Encoder les filigranes.	Une chaîne encodée en Base64 contenant au maximum 60 caractères.
  type	La police du filigrane textuel. Le nom de la police doit être encodé en Base64. Pour plus d'informations, consultez Encoder les filigranes.	Jusqu'à 10 polices sont prises en charge. Pour plus d'informations, consultez le tableau suivant. Remarque Si vous spécifiez une police non prise en charge, le système utilise alihyaihei par défaut.
  color	La couleur du filigrane textuel. Les valeurs valides pour ce paramètre sont des valeurs de couleur RGB.	Par exemple, 000000 spécifie le noir et FFFFFF spécifie le blanc. Valeur par défaut : 000000.
  rotate	Le degré de rotation horaire du filigrane textuel.	[0,360] Valeur par défaut : 0. Une valeur de 0 indique que le filigrane textuel n'est pas tourné.
  fill	Indique s'il faut appliquer le filigrane textuel en mosaïque sur l'image de base.	Valeurs valides : 0 et 1. Valeur par défaut : 0. 0 : n'applique pas le filigrane textuel en mosaïque sur l'image de base. 1 : applique le filigrane textuel en mosaïque sur l'image de base.
  size	La taille du filigrane textuel.	(0,1000] Valeur par défaut : 40. Unité : pixels.

  Le tableau suivant décrit les valeurs valides du paramètre type et les chaînes encodées correspondantes.

  Text font	Description	Encoded value
  alihyaihei	Une police en gras. Il s'agit de la police par défaut.	YWxpaHlhaWhlaQ
  hysong	Une variante de la police Songti.	aHlzb25n
  hyhei	Une variante de la police Heiti.	aHloZWk
  hyshuangxian	Une police à double ligne.	aHlzaHVhbmd4aWFu
  comfortaa	Comfortaa	Y29tZm9ydGFh
  notosans	NotoSans	bm90b3NhbnM

Encoder les filigranes

Lorsque vous ajoutez des filigranes, le contenu et les polices des filigranes textuels ainsi que les URL des filigranes image doivent être encodés en Base64 sécurisé pour les URL. Pour encoder les filigranes, procédez comme suit :

1. Encodez le contenu du filigrane en Base64.

   Nous vous recommandons d'utiliser des outils d'encodage Base64 sécurisé pour les URL pour encoder le contenu et les polices des filigranes textuels ainsi que les URL des filigranes image. Les chaînes encodées des filigranes ne peuvent être utilisées que dans les paramètres d'ajout de filigranes. N'incluez pas les chaînes encodées des filigranes dans les chaînes de signature.

2. Remplacez les caractères du 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 underscores (_).

   • Omettez les signes égal (=) à la fin du contenu du filigrane encodé en Base64.