imagecreatefromgif

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecreatefromgif — 新しい画像をファイルあるいは URL から作成する

説明

imagecreatefromgif(string$filename): GdImage|false

imagecreatefromgif() は、指定したファイル名の画像を表す画像 ID を返します。

警告

GIF ファイルをメモリに取り込む際、最初のフレームだけが画像オブジェクトで返されます。getimagesize() で報告される画像サイズは必ずしも必要ありません。

ヒント

fopen wrappers が有効の場合、この関数のファイル名として URL を使用することができます。ファイル名の指定方法に関する詳細は fopen() を参照ください。サポートするプロトコル/ラッパーには、さまざまなラッパーの機能やその使用法、提供される定義済み変数などの情報がまとめられています。

パラメータ

filename: GIF 画像へのパス。

戻り値

成功した場合に画像オブジェクト、エラー時に false を返します。

変更履歴

バージョン	説明
8.0.0	成功時には、この関数は GDImage クラスのインスタンスを返すようになりました。これより前のバージョンでは、 resource を返していました。

例

例1 GIF の作成時のエラーを処理する例

<?php
function LoadGif($imgname)
{

$im = @imagecreatefromgif($imgname);


if(!$im)
 {

$im = imagecreatetruecolor (150, 30);
$bgc = imagecolorallocate ($im, 255, 255, 255);
$tc = imagecolorallocate ($im, 0, 0, 0);

imagefilledrectangle ($im, 0, 0, 150, 30, $bgc);


imagestring ($im, 1, 5, 5, 'Error loading ' . $imgname, $tc);
 }

 return $im;
}

header('Content-Type: image/gif');

$img = LoadGif('bogus.image');

imagegif($img);
imagedestroy($img);
?>

上の例の出力は、たとえば以下のようになります。