# imagebmp

(PHP 7 >= 7.2.0, PHP 8)

imagebmp — Affiche ou enregistre une image BMP au navigateur ou dans un fichier

### Description

imagebmp(GdImage `$image`, resource|string|null `$file` = `null`, bool `$compressed` = `true`): bool

Affiche ou enregistre une version BMP de l'`image` fournit.

### Liste de paramètres

`image`

  Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

`file`

  Le chemin ou un flux de ressource ouvert (qui sera automatiquement fermé après le retour de cette fonction) vers lequel le fichier sera sauvegardé. Si non-défini ou `null`, le flux brute de l'image sera affiché directement.

  > Note:

  > `null` est invalide si l'argument `compressed` est inutilisé.

`compressed`

  Si le BMP doit être compréssé avec `run-length encoding` (RLE), ou pas.

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

### Historique

Version | Description
--- | ---
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.
8.0.0 | Le type de `compressed` est désormais booléen ; auparavant c'était entier.

### Exemples

Exemple #1 Enregistrer un fichier BMP

`<?php
// Créer une image vierge et ajouter du texte
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'BMP with PHP', $text_color);
// Save the image
imagebmp($im, 'php.bmp');
?>`