Fontfile Le nom de la police TrueType. (peut aussi être une URL.) angle Angle en degré dans lequel le texte va être mesuré.
ImageTTFBBox() retourne une tableau avec 8 éléments représentant les 4 sommets du rectangle ainsi défini.
0 Coin inférieur gauche, abscisse 1 Coin inférieur gauche, ordonnée 2 Coin inférieur droit, abscisse 3 Coin inférieur droit, ordonnée 4 Coin supérieur droit, abscisse 5 Coin supérieur droit, ordonnée 6 Coin supérieur gauche, abscisse 7 Coin supérieur gauche, ordonnée
Les positions des points sont relatives au texte, indépendamment de líangle : coin supérieur gauche faire référence au coin supérieur gauche du texte écrit horizontalement. Cette fonction requiert les bibliothèques GD et Freetype.
ImageTTFText
ImageTTFText -- dessine un texte avec une police TrueType
Description
array ImageTTFText(int im, int size, int angle, int x, int y, int col, string fontfile, string text);
ImageTTFText dessine la chaîne text dans líimage im, en commancant aux coordonnées (x,y) (le coin supérieur gauche est líorigine (0,0)), avec un angle de angle, et dans la couleur col, en utilisant la police TrueType identifiée par fontfile.
Les coordonnées (x,y) serviront de référence pour le premier caractère (en gros, le coin inférieur gauche du caractère). Cíest différent de ImageString(), qui utilise le coin supérieur droit.
angle est donné en degrés, avec 0 degré pour un texte horizontal, et en comptant les angles dans le sens inverse des aiguilles díune montre (sens direct).
fontfile est le chemin jusquíà la police TrueType à utiliser.
text est le texte à dessiner, incluant aussi des séquences de caractères UTF-8 (de la forme: { ) pour générer des caractères au delà de 255.
col est líindex de la couleur dans la palette. Utiliser des index négatifs, revient à supprimer líanti-aliasing.
ImageTTFText() retourne un tableau de 8 éléments représentants les 4 points marquant les limites du texte. Líordre des points est :supérieur gauche, supérieur droit, inférieur droit, inférieur gauche. Les points sont nommés relativement au texte à líhorizontal.
Cet exemple va générer une image GIF noire de 400x30 pixels, avec les mots "Test en cours..." en police blanche, Arial.
Exemple 1. ImageTTFText
<?php
Header("Content-type: image/gif");
$im = imagecreate(400,30);
$black = ImageColorAllocate($im, 0,0,0);
$white = ImageColorAllocate($im, 255,255,255);
ImageTTFText($im, 20, 0, 10, 20, $white, "/path/arial.ttf", "Test en cours...
Omega: Ω");
ImageGif($im);
ImageDestroy($im);
?>
Cette fonction requiert les bibliothèques GD et FreeType
ImageColorAt
ImageColorAt ñ retourne líindex de la couleur díun pixel donné
Description
int imagecolorat(int im, int x, int y);
Retourne líindex de la couleur du pixel donné, dans líimage im.
ImageColorClosest
ImageColorClosest -- retourne líindex de la couleur la plus proche díune couleur donnée
Description
int imagecolorclosest(int im, int red, int green, int blue);
Retourne líindex de la couleur de la palette qui est la plus proche de la valeur RGB passée.
La "distance" entre la couleur souhaitée et les couleurs de la palette sont calculées en considérant líespace RGB comme un espace à 3 dimensions.
ImageColorExact
ImageColorExact -- retourne líindex de la couleur donnée
Description
int imagecolorexact(int im, int red, int green, int blue);
Retourne líindex de la couleur spécifiée dans la palette de líimage im.
Si la couleur níexiste pas dans cette palettre, retourne ñ1
ImageColorResolve
ImageColorResolve -- retourne líindex de la couleur donnée, ou la plus proche possible
Description
int imagecolorresolve(int im, int red, int green, int blue);
Cette fonction retourne un index de couleur à tous les coups. Soit il arrive à trouver la couleur demandée dans la palette, soit il recherche la couleur la plus proche.
ImageColorSet
ImageColorSet -- change la couleur dans une palette à líindex donné
Description
bool imagecolorset(int im, int index, int red, int green, int blue);
Cette fonction permet díattribuer à un index díune palette une couleur spécifique. Cíest une fonction très pratique pour effectuer du remplissage de couleur sans le faire réellement.
ImageColorsForIndex
ImageColorsForIndex -- retourne la couleur associée à un index
Description
array imagecolorsforindex(int im, int index);
Cette fonction retourne un tableau associatif avec les couleur rouge (red) , vert (green), bleu (blue) qui contiennent les valeurs de la couleur correspondante.
ImageColorsTotal
ImageColorsTotal -- calcule le nombre de couleur díune palette
Description
int imagecolorstotal(int im);
Cette fonction retourne le nombre de couleur de la palette
ImagePSLoadFont
ImagePSLoadFont -- charge une police PostScript Type 1 depuis un fichier
Description
int imagepsloadfont(string filename);
Au cas où tout a bien marché, un index de police va être retourné, et pourra être utilisé pour des opérations ultérieures. Sinon, la fonction retourne faux et affiche un message décrivant ce qui est erroné.
ImagePSFreeFont
ImagePSFreeFont -- libère la mémoire occupée par une police PostScript Type 1
Description
void imagepsfreefont(int fontindex);
ImagePSEncodeFont
ImagePSEncodeFont -- change le codage vectoriel díun caractère dans une police
Description
int imagepsencodefont(string encodingfile);
Charge le codage vectoriel díun caractère depuis un fichier et change le codage vectoriel de la police correspondante. Etant donné
utilisez une autre langue que líanglais. Le format exact est décrit dans la documentation T1libs. T1lib est disponible en deux formes : IsoLatin1.enc et IsoLatin2.enc.
Si vous commencez à utiliser cette fonction régulièrement, une meilleure solution est de définir un encodage, et de líutiliser avec set ps.default_encoding dans php3.ini pour utiliser par défaut líencodage correct.
ImagePSText
ImagePSText -- dessine un texte sur une image avec une police PostScript Type1
Description
array imagepstext(int image, string text, int font, int size, int foreground, int background, int x, int y, int space, int tightness, float angle, int antialias_steps);
size est exprimé en pixel.
foreground est la couleur dans laquelle le texte va être dessiné.. background est la couleur díanti aliasing.. Aucun pixel avec la couleur background níest dessiné, ce qui fait que líarrière plan nía pas besoin díêtre dans une couleur fixe.
Les coordonnées données (x, y) définissent líorigine du premier caractère (grossièrement, le coin inférieur gauche du caractère).
Ceci est différent de la fonction ImageString(), où (x, y) définissait le coin supérieur gauche du premier caracètre. Reportez vous à la documentation PostScipt pour avoir des détails à propos des polices et de leurs tailles, si vous avez des problèmes avec.
space permet de changer la taille par défaut du caractère díespacement. Cette valeur peut être négative.
tightness permet de contrôler la quantité díespace entre deux caractères. Cette valeur peut être négative.
angle est en degré.
antialias_steps permet de controler le nombre de couleur du texte anti aliasé. Les valeurs autorisées sont 4 et 16. 16 est
recommandé pour les polices de moins de 20 pixels, car líeffet est alors visible. Avec les tailles plus grandes, utilisez de préférence 4, qui est moins gourmandes en ressources.
Les paramètres space et tightness sont exprimés en unité díespace caractère, ce qui vaut 1/1000ème díun em-carré ( ? ? ?).
Les Paramètres space, tightness, angle et antialiassont optionnels.
Cette fonction retourne un tableau contenant les éléments suivants : 0 Abscisse inférieure gauche
1 Ordonnée inférieure gauche 2 Abscisse supérieure droite 3 Ordonnée supérieure droite
ImagePSBBox
ImagePSBBox -- retourne le rectangle entourant un texte et dessiné avec une police PostScript Type1
Description
array imagepsbbox(string text, int font, int size, int space, int width, float angle);
size est exprimé en pixels.
space permet de changer la valeur par défaut du charactère espace. Cette valeur est ajoutée lors des dessins, et donc, peut être négative.
tightness permet de contrôler la quantité díespace entre les caractères. Cette quantité est ajouté lors des dessins, et peut donc être négative.
angle est en degré
Les paramètres space et tightness sont exprimés en unité díespacement de caractères, avec 1 unité vaut 1/1000 díun em carré ( ? ? ?).
Les paramètres space, tightness et angle sont optionels.
Le rectangle entourant est calculé en utilisant les informations disponibles sur les tailels de caractères, et, malheureusement, ont tendance à être légèrement différent du résultat réel final. Si líangle est de 0 degré, vous pouvez vous attendre à avoir besoin díun rectangle díau moins un pixel plus grand dans toutes les directions.
Cette fonction retourne un tableau contenant les éléments suivants : 0 Abscisse inférieure gauche
1 Ordonnée inférieure gauche 2 Abscisse supérieure droite 3 Ordonnée supérieure droite
XXI. Fonctions IMAP
Pour avoir accès à ces fonctions, vous devez compiler PHP avec l'option --with-imap. Il faut avoir installé la librairie c-client.
Chargez sa dernière version sur le serveur ftp://ftp.cac.washington.edu/imap/ et compilez la. Puis, copiez le fichier client/client.a dans /usr/local/lib ou n'importe quel autre dossier qui soit dans le chemin de link,. Enfin, copiez les fichiers c-client/rfc822.h, mail.h et linkage.h dans /usr/local/include ou n'importe quel autre dossier qui soit dans le chemin d'inclusion