imagewbmp
iptcembed
Fonctions GD et images
PHP Manual

# imagexbm

(PHP 5)

imagexbm — Génère une image au format XBM

### Description

bool imagexbm ( resource `$image` , string `$filename` [, int `$foreground` ] )

Affiche ou sauvegarde une version XBM de l'image `image`.

### Liste de paramètres

`image`

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

`filename`

  Le chemin vers le fichier de sauvegarde. S'il n'est pas défini ou s'il vaut `NULL`, le flux brut de l'image sera directement affiché.

`foreground`

  Vous pouvez définir le premier plan avec ce paramètre en définissant un identifiant obtenu depuis la fonction imagecolorallocate(). Par défaut, la couleur du premier plan est noir.

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès ou `FALSE` si une erreur survient.

### Exemples

Exemple #1 Sauvegarde d'un fichier XBM

`<?php
// Création d'une image vide et ajout d'un texte
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'Un texte simple', $text_color);
// Sauvegarde de l'image
imagexbm($im, 'simpletext.xbm');
// Libération de la mémoire
imagedestroy($im);
?>`

Exemple #2 Sauvegarde d'un fichier XBM avec une couleur de premier-plan différente

`<?php
// Création d'une image vide et ajout d'un texte
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'Un texte simple', $text_color);
// Définit la couleur de premier-plan
$foreground_color = imagecolorallocate($im, 255, 0, 0);
// Sauvegarde de l'image
imagexbm($im, NULL, $foreground_color);
// Libération de la mémoire
imagedestroy($im);
?>`

### Notes

> Note: Cette fonction n'est disponible que si PHP est compilé avec la version embarquée de la bibliothèque GD.

imagewbmp
iptcembed
Fonctions GD et images
PHP Manual