PICT

Général

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

Ajout de texte

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é.

<pict path="une_image_test.jpg" name="image" height="50%" width="50%" text="photographie" font="Arial" size="10" color="black" position="MM" border="0">

Ajout de forme

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


<pict name="img" width="50" height="50">
<pict name="img" rect="1,1,48,48" border="2" color="blue" fill="cyan">
<pict name="img" rect="10,10,39,39" border="10" color="red" fill="orange">

Colorier une zone

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.

<pict name="im" x="0" y="160" fill="#99CC00">

<pict name="img" [path="$chemin$" | content="$image$"]>

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.

<pict close="img">

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

<pict name="img" dest="$chemin$">

Ecrit l'image dans le fichier destination indiqué.

<pict name="img" geth="height" getw="width">

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

<pict name="img" path="$gDirTelechargement$/$imgLogoGroupe$">
<pict name="img" geth="imgHeight" getw="imgwidth">

<pict name="img" rect="$x1$,$y1$,$x2$,$y2$" border="$border$" color="$color$" [fill=$fill$]>

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.

<pict name="img" width="$width$" height="$width$" [option="quality,speed"]>

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é.

<pict name="imgDest" copy="imgSrc" x="$posX$" y="$posY$" [srcparam="XX YY [W H]"]>

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).

<pict name="img2" copy="img1" x="10" y="10" srcparam="30 30 150 40">

<pict name="img" rotate="$angle$">

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

<pict name="img" rotate="90">

<pict calc="texte a mesurer" size="taille" font="font" getw="largeur" geth="hauteur">

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.

<set name="textMesure" value="texte à mesurer\navec saut">

<pict calc="$textMesure$" font="fonts/Grimm1-0908.ttf" size="24" geth="getH" getw="getW">

$getW$x$getH$ => 245x58