imagecreatefromgif

(PHP 4, PHP 5)

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

説明

resource imagecreatefromgif ( string $filename )

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

ヒント

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

パラメータ

filename: GIF 画像へのパス。

返り値

成功した場合に画像リソース ID、エラー時に FALSE を返します。

例

例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);
?>

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

注意

注意:
GIF サポートは GD ライブラリのバーション 1.6 以降で削除され、バージョン 2.0.28 で復活しました。その間のバージョンでは、この関数を使用できません。

注意:
アニメーション GIF ファイルをメモリに取り込むときには、画像リソースポインタで返されるのが最初のフレームだけになります。

警告

PHP 4.3.0 より前のバージョンの Windows 版 PHP は、現在この関数に関してリモートファイルアクセス機能をサポートしていません。これは、allow_url_fopen を有効にした場合でも同様です。