# imagecreatefromxpm

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

imagecreatefromxpm — Crée une nouvelle image depuis un fichier ou une URL

### Description

imagecreatefromxpm(string `$filename`): GdImage|false

imagecreatefromxpm() retourne un identifiant d'image représentant l'image obtenue à partir du fichier `filename`.

Astuce

Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a été activé. Voyez fopen() pour plus de détails sur la façon de spécifier le nom du fichier. Reportez-vous aux Liste des protocoles et des gestionnaires supportés pour plus d'informations sur les capacités des différents gestionnaires, les notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles fournissent.

### Liste de paramètres

`filename`

  Chemin vers l'image XPM.

### Valeurs de retour

Retourne un objet d'image en cas de succès, ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.0.0 | En cas de succès, cette fonction retourne désormais une instance de GDImage ; auparavant, une resource était retournée.

### Exemples

Exemple #1 Création d'une instance d'image en utilisant la fonction imagecreatefromxpm()

`<?php
// Vérifie le support XPM
if(!(imagetypes() & IMG_XPM))
{
die('Le support XPM n\'a pu être vérifié !');
}
// Création de l'instance d'une image
$xpm = imagecreatefromxpm('./example.xpm');
// Quelques opérations sur l'image ici
// PHP n'a pas le support pour l'écriture des images XPM
// aussi, dans ce cas, nous sauvegardons l'image dans un fichier JPEG
// avec une qualité de 100%
imagejpeg($xpm, './example.jpg', 100);
?>`