imagecreatefromjpeg

(PHP 3 >= 3.0.16, PHP 4, PHP 5)

imagecreatefromjpeg -- ファイル又は URL から新規 JPEG 画像を作成する

説明

resource imagecreatefromjpeg ( string filename )

imagecreatefromjpeg() は引数 filename から得られる画像を表すイメージIDを返します。

imagecreatefromjpeg() はエラー時に空の文字列を 返します。エラーメッセージも出力されますが、この場合、残念なことに ブラウザ上のリンクは壊れてしまいます。デバッグを簡単にするために 以下の例ではエラー表示用 JPEG を出力しています。

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

<?php
function LoadJpeg($imgname)
{
    
$im = @imagecreatefromjpeg($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/jpeg");
$img = LoadJpeg("bogus.image");
imagejpeg($img);
?>

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

ティップ: fopen wrappers が有効の場合、この関数のファイル名として URL を使用することができます。ファイル名の指定方法に関する詳細は fopen()、サポートされる URL プロトコルの種類 については、(例えば)付録O を参照してください。

パラメータ

filename

JPEG 画像へのパス。

返り値

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

注意

注意: JPEG サポートは、 PHP が GD-1.8 か、それ以降に対して、コンパイルされている場合のみ使用可能です。

警告

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