imagecreatefrompng
(PHP 3 >= 3.0.13, PHP 4, PHP 5)
imagecreatefrompng -- ファイルまたは URL から新規 PNG 画像を作成する
説明
resource
imagecreatefrompng ( string filename )
imagecreatefrompng()は引数 filename
から得られる画像を表す画像 ID を返します。
imagecreatefrompng() はエラー時に空の文字列を
返します。エラーメッセージも出力されますが、この場合、残念なことに
ブラウザ上のリンクは壊れてしまいます。
デバッグを簡単にするために以下の例ではエラー表示用 PNG
を出力しています。
例 1. 作成時のエラーを処理する例
<?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); ?>
|
上の例の出力は、たとえば
以下のようになります。 |
ティップ: fopen wrappers が有効の場合、この関数のファイル名として
URL を使用することができます。ファイル名の指定方法に関する詳細は
fopen()、サポートされる URL プロトコルの種類
については、(例えば)付録O を参照してください。
返り値
成功した場合に画像リソース ID、エラー時に FALSE を返します。
注意
警告 |
PHP 4.3.0 より前のバージョンの
Windows 版 PHP は、現在この関数に関してリモートファイルアクセス機能を
サポートしていません。これは、allow_url_fopen を
有効にした場合でも同様です。 |