imagepsslantfont
imagerectangle
Fonctions GD et images
PHP Manual

# imagepstext

(PHP 4, PHP 5)

imagepstext — Dessine un texte sur une image avec une police PostScript Type1

### Description

array imagepstext ( resource `$image` , string `$text` , resource `$font_index` , int `$size` , int `$foreground` , int `$background` , int `$x` , int `$y` [, int `$space` = 0 [, int `$tightness` = 0 [, float `$angle` = 0.0 [, int `$antialias_steps` = 4 ]]]] )

Dessine un texte sur une image avec une police PostScript Type1.

Reportez-vous à la documentation PostScript pour avoir des détails à propos des polices et de leurs tailles.

### Liste de paramètres

`image`

  Une ressource d'image, retourné par une des fonctions de création d'images, comme imagecreatetruecolor().

`text`

  Le texte à écrire.

`font_index`

  Une ressource de police, retournée par la fonction imagepsloadfont().

`size`

  `size` est exprimé en pixels.

`foreground`

  La couleur avec laquelle le texte va être dessiné.

`background`

  La couleur d'antialiasing. 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.

`x`

  X : coordonnée du coin en bas, à gauche du premier caractère.

`y`

  Y : coordonnée du coin en bas, à gauche du premier caractère.

`space`

  Permet de changer la taille par défaut du caractère d'espacement. Cette valeur peut être négative. Exprimé en unité d'espaces caractère, ce qui vaut 1/1000ème d'un em-carré (un em : unité de mesure représentée par un carré dont la dimension horizontale est la même que le corps du caractère).

`tightness`

  Permet de contrôler la quantité d'espace entre deux caractères. Cette valeur peut être négative. Exprimé en unité d'espaces caractère, ce qui vaut 1/1000ème d'un em-carré.

`angle`

  `angle` est en degrés.

`antialias_steps`

  Permet de contrôler le nombre de couleurs du texte antialiasé. Les valeurs autorisées sont 4 et 16. 16 est recommandée 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 gourmande en ressources.

### Valeurs de retour

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

### Exemples

Exemple #1 Exemple avec imagepstext()

`<?php
// Création d'une nouvelle image
$im = imagecreatetruecolor(200, 200);
// Alloue les couleurs
$black = imagecolorallocate($im, 0, 0, 0);
$white = imagecolorallocate($im, 255, 255, 255);
// Charge la police PostScript
$font = imagepsloadfont('font.pfm');
// Dessine un texte dans l'image
imagepstext($im, 'Un texte simple', $font, 12, $black, $white, 50, 50);
// Affichage et libération de la mémoire
header('Content-type: image/png');
imagepng($im);
imagedestroy($im);
?>`

### Notes

> Note: Cette fonction n'est disponible que si PHP est compilé en utilisant --enable-t1lib[=DIR].

### Voir aussi

- imagepsbbox() - Retourne le rectangle entourant un texte et dessiné avec une police PostScript Type1

imagepsslantfont
imagerectangle
Fonctions GD et images
PHP Manual