imagefttext
(PHP 4 >= 4.0.7, PHP 5)
imagefttext — �crit du texte dans une image avec la police courante FreeType 2
Description
Liste de param�tres
- image
-
Une ressource d'image, retourn� par une des fonctions de cr�ation d'images, comme imagecreatetruecolor().
- size
-
La taille de la police � utiliser, en nombre de points.
- angle
-
L'angle, en degr�s ; 0 degr� pour une lecture du texte de gauche � droite. Les grandes valeurs repr�sentent une rotation dans le sens des aiguilles d'une montre. Par exemple, une valeur de 90 aura pour effet de lire le texte du bas vers le haut.
- x
-
Les coordonn�es, fournies par x et y d�finissent le point de d�part du premier caract�re (et plus pr�cis�ment, le coin en bas � gauche du caract�re). C'est un comportement diff�rent de la fonction imagestring(), o� x et y d�finissent le coin en haut, � gauche du premier caract�re. Par exemple, en haut � gauche vaut 0, 0.
- y
-
L'ordonn�e y-ordinate. Ce param�tre configure la position de base de la police, et non pas le bas de cette derni�re.
- color
-
L'index de la couleur d�sir�e pour le texte, voir la fonction imagecolorexact().
- fontfile
-
Le chemin vers la police TrueType � utiliser.
Suivant la version de GD utilis�e par PHP, il sera recherch� les fichiers qui ne commencent pas par un '/', en y ajoutant l'extension '.ttf', et suivant le chemin des polices d�fini par la biblioth�que.
Lors de l'utilisation d'une version de GD inf�rieure � 2.0.18, un caract�re d'espacement (plut�t qu'un point-virgule) �tait utilis� comment s�parateur dans le chemin pour les diff�rents fichiers de police. Si vous utilisez toujours cette notation, vous obtiendrez le message d'erreur suivant : Warning: Could not find/open font. Pour ces anciennes versions, la seule solution est de d�placer la police dans un dossier qui ne contient pas d'espace.
Dans la plupart des cas, lorsque la police se trouve dans le m�me dossier que le script qui cherche � l'utiliser, la solution suivante permet de s'affranchir de tous les probl�mes relatifs � l'inclusion.
<?php
// D�finit la variable d'environnement pour GD
putenv('GDFONTPATH=' . realpath('.'));
// Nom de la police � utiliser (note qu'il n'y a pas d'extension .ttf)
$font = 'SomeFont';
?> - text
-
Le texte � ins�rer dans l'image.
- extrainfo
-
Indexes possibles pour le tableau extrainfo Cl� Type Signification linespacing float D�finit l'espacement entre les lignes lors du dessin
Valeurs de retour
Cette fonction retourne un tableau d�finissant les 4 points d'une bo�te, en commen�ant par le coin en bas, � gauche, puis, les suivants, dans le sens des aiguilles d'une montre :
0 | x : coordonn�e en bas, � gauche |
1 | y : coordonn�e en bas, � gauche |
2 | x : coordonn�e en haut, � droite |
3 | y : coordonn�e en bas, � droite |
4 | x : coordonn�e en haut, � droite |
5 | y : coordonn�e en haut, � droite |
6 | x : coordonn�e en haut, � gauche |
7 | y : coordonn�e en haut, � gauche |
Exemples
Exemple #1 Exemple avec imagefttext()
<?php
// Cr�ation d'une image de 300x100 pixels
$im = imagecreatetruecolor(300, 100);
$red = imagecolorallocate($im, 0xFF, 0x00, 0x00);
$black = imagecolorallocate($im, 0x00, 0x00, 0x00);
// D�finit l'arri�re-plan en rouge
imagefilledrectangle($im, 0, 0, 299, 99, $red);
// Chemin vers notre fichier de police ttf
$font_file = './arial.ttf';
// Dessine le texte 'PHP Manual' en utilisant une police de taille 13
imagefttext($im, 13, 0, 105, 55, $black, $font_file, 'PHP Manual');
// Affichage de l'image sur le navigateur
header('Content-Type: image/png');
imagepng($im);
imagedestroy($im);
?>
Notes
Note: Cette fonction requiert la biblioth�que GD 2.0.1 ou sup�rieure (2.0.28 ou sup�rieure est recommand�e).
Note: Cette fonction n'est disponible que si si PHP est compil� avec le support Freetype (--with-freetype-dir=DIR)
Historique
Version | Description |
---|---|
4.3.5 | Le param�tre extrainfo est devenu optionnel. |