imagefttext

(PHP 4 >= 4.0.7, PHP 5)

imagefttext�crit du texte dans une image avec la police courante FreeType 2

Description

array imagefttext ( resource $image , float $size , float $angle , int $x , int $y , int $color , string $fontfile , string $text [, array $extrainfo ] )

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(300100);
$red imagecolorallocate($im0xFF0x000x00);
$black imagecolorallocate($im0x000x000x00);

// D�finit l'arri�re-plan en rouge
imagefilledrectangle($im0029999$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($im13010555$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.