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

# imagecreatefrompng

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

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

### 説明

function imagecreatefrompng(string `$filename`): GdImage|false

imagecreatefrompng()は引数 filename から得られる画像を表す画像 ID を返します。

ヒント

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

### パラメータ

`filename`

  PNG 画像へのパス。

### 戻り値

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

### 変更履歴

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

### 例

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

    <?php
    function LoadPNG($imgname)
    {
        /* オープンします */
        $im = @imagecreatefrompng($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/png');

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

    imagepng($img);
    ?>

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open