Le xpx vous permet de manipuler les images pour les formater et optimiser leurs poids de fichier. Vous utilisez pour ce faire la balise <pict> avec les attributs suivants :

• « path=’’nom_du_fichier’’ » OU « content=’’$image$’’ » pour sélectionner la provenance de votre image.
• « dest=’’nom_du_fichier’’ » pour indiquer où écrire votre image à la fin du traitement.
• « name=’’varimage’’ » pour préciser le nom de l'image que vous traité (notamment pour lui appliquer plusieurs opération à la suite).
• « transparency=’’#couleur’’ » indique quelle couleur doit être convertie en transparent.
• « height=’’hauteur’’ » et « width=’’largeur’’ » permet de définir une nouvelle taille à l’image (précisée en pixels ou en pourcentage)
• « Geth=’’hauteur » et « getw=’’largeur’’ » permet d'obtenir la dimension (dans les variables largeur et hauteur) de l'image en pixels

Vous pouvez modifier l'image en lui ajoutant du texte en surimpression.

• « text=’’du_texte’’ » permet d’ajouter le texte
• « Font=’’police’’ » indique le nom de la police utilisé. Vous pouvez utiliser vos propres font au format TTF en indiquant leurs sources.
• « size=’’taille’’ » permet de choisir la taille du texte
• « color=’’couleur’’ » permet de définir la couleur du texte et de celui du cadre de l’image
• « border=’’taille’’ » permet de choisir la taille de la bordure en pixel (par défaut 0)
• « rotate=’’rotation’’ » permet d'appliquer une rotation au texte (en degré)
• « position=’’constante’’ » permet de choisir la position du texte. On utilise les valeurs suivantes :

  Hauteur		Largeur
  		LEFT	MIDDLE	RIGHT
  	TOP	TL	TM	TR
  	MIDDLE	ML	MM	MR
  	BOTTOM	BL	BM	BR

• vous pouvez également indiquer le position de votre texte en passant par les attributs « x=’’...’’ » et « y=’’...’’ ».

L'attribut calc="..." permet d'évaluer la place prise par un texte. On peu l'utiliser avec les attributs getH, getW et/ou getX, getY pour obtenir les dimensions du texte ou la position du coin opposé.

Comme pour le texte, vous pouvez ajouter un rectangle coloré à l'image.

• « rect=’’point_x,point_y,largeur,hauteur’’ » permet d’ajouter un rectangle
• « color=’’couleur’’ » permet de définir la couleur du rectangle.
• « fill=’’couleur - source_image’’ » permet de définir une couleur d'arrière plan ou une image de fond

Vous pouvez appliquer une couleur ou une image de fond à une plage de pixel de la même couleur.

• Les attributs « x=’’...’’ » et « y=’’...’’ » permettent de sélectionner un pixel précis sur l'image. La zone traitée par la suite, correspond à tous les pixels ayant la même teinte.
• Enfin, placé le code hexadécimal ou la source d'une image dans l'attribut « fill=’’...’’ » pour indiquer comment colorier la sélection.

Crée une zone mémoire pour stocker l'image $img$.

Si path est indiqué, le fichier image est lu puis stocké dans $img$.

L'attribut content permet d'indiquer le contenu d'une image déjà chargé dans une variable.

Fermeture de l'image et libération de la mémoire

Ecrit l'image dans le fichier destination indiqué.

Récupère la hauteur et la largeur d'une image.

Dessine un rectangle aux corrdonnées spécifiées dans l'image d'une épaisseur border et dans la couleur color.

La couleur peut être un code HTML hexadécimal #AABBCC ou un chemin vers un fichier qui servira pour le remplissage.

Le rectangle est rempli si l'attribut fill est précisé. Comme color, fill peut être un code couleur HTML ou un fichier image.

Redimensionne l'image dans la dimension précisé par width et height.

L'option est par défaut "quality" qui utilise une méthode d'anti-aliasing. Si l'option est "speed", le traitement est plus rapide mais perd un peu en qualité.

Copie l'image source (imgSrc) dans l'image de destination (imgDest) à la position X,Y.

À partir de la version 4.0a7, l'attribut srcparam permet de copier seulement une partie de l'image source en précisant XX et YY (origine) et W H (largeur et hauteur).

Applique sur l'image une rotation exprimée en degrés dans le sens trigonométrique (anti-horaire) si l'angle est positif.

Mesure de la place en pixels que va prendre un texte dans une taille et une fonte choisie. Prend en compte les retour à la ligne.

L'attribut qrcode permet la génération automatique d'un QR Code à partir de la chaîne fournie. La taille du bitmap créé dépend de la longueur de la chaîne de caractères.

ATTENTION : la chaîne doit être encodée en UTF-8.

Attributs de rendu graphique :

• thickness : taille en pixels image des "pixels" du QR Code (défaut : 4),
  
  
• margin : marge vide autour (en multiples de thickness, défaut : 2),
  
  
• border : épaisseur du cadre autour du QR Code (en multiples de thickness, défaut : 0 (pas de cadre)),
  
  
• color : couleur des pixels du QR code (défaut : noir),
  
  
• bgcolor : couleur de fond du QR code (défaut : blanc).

Attributs (facultatifs) de paramétrage fin :

• version : valeur entre 1 et 40 donnant la taille du QR Code, et partant la capacité de la chaîne (plus la valeur est petite, plus l'image sera petite et plus la chaîne devra être courte),
  
  
• ecc : niveau code de correction d'erreur. 4 valeurs possibles : L, M, Q, H, chacune avec un taux de redondance spécifique.
  L=Low (7%), M=Medium(15%), Q=Quartile (25%), H=High(30%)
  
  
• mask : définit le masque appliqué (valeur entre 0 et 7).

Pour plus d'informations sur ces 3 paramètres, voir ici.

Cette fonctionnalité est présente depuis la version 4.0a19 (4001903). Les attributs de paramétrage fin à partir de la version 4001904.