Génère une image au format XBM

# imagexbm

(PHP 5, PHP 7)

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

### Description

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

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

> Note: imagexbm() n'applique pas de rembourrage, de sorte que la largeur de l'image doit être un multiple de 8. Cette restriction ne s'applique plus à partir de PHP 5.6.24 et 7.0.9, respectivement.

### Liste de paramètres

`image`

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

`filename`

  Chemin d'accès pour lequel enregistrer le fichier. S'il n'est pas défini ou `NULL`, le flux d'images RAW sera directement sorti.

  Le nom de fichier `filename` (sans l'extension .xbm) est également utilisé pour les identificateur C duXBM, auquel cas les caractères non alphanumériques des paramètres régionaux actuels sont remplacés par des soulignements. Si `filename` a la valeur null, image est utilisée pour générer les identificateurs C.

`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. Toutes les autres couleurs sont traitées comme arrière-plan.

### Valeurs de retour

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

Attention

Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne `TRUE`.

### 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