画像処理 (GD)

はじめに

PHPができることは、HTML出力を生成することだけではありません。PHP は、多くの異なるイメージ形式でイメージファイルを作成したり、操作したりすることもできます。このイメージ形式には、GIF, PNG, JPEG, WBMP および XPM が含まれます。さらに便利なことに、PHPはイメージストリームを直接ブラウザに出力することができます。イメージ関数を使用するには、PHP を GD ライブラリとともにコンパイルしなければなりません。使用したいイメージ形式によっては、GD と PHP 以外に他のライブラリも必要となる可能性があります。

PHPのイメージ関数により JPEG、GIF、 PNG、SWF、 TIFF、JPEG2000イメージの大きさを知ることができます。

exif 拡張モジュールを使用すると、 JPEG や TIFF 画像のヘッダに保存された情報を扱うことができます。これにより、デジタルカメラが作成したメタデータを読み込むことができます。 exif 関数は GD ライブラリは必要ありません。

注意: イメージの読み込み、書き込み、修正の機能を拡張するには、要求の節を呼んでください。デジタルカメラで撮影した画像のメタデータを読み込むには、上で説明した exif 拡張モジュールが必要です。

注意: getimagesize() 関数は、GD 拡張モジュールは必要ありません。

警告

バンドルされている GD ライブラリは、メモリを確保するのに Zend メモリマネージャーを使っていますが、システムにインストールされている GD ライブラリは使っていません。よって、後者には memory_limit は適用されません。

GD はさまざまなフォーマットに対応しています。 GD がサポートするフォーマットの一覧と、読み書きの対応状況を含めた注意をまとめました。

GD がサポートするフォーマット

フォーマット読み込みのサポート書き込みのサポート注意

JPEG true true

PNG true true

GIF true true

XBM true true

XPM true false

WBMP true true

WebP true true

BMP true true PHP 7.2.0 以降で利用可能です

**GD がサポートするフォーマット**
フォーマット	読み込みのサポート	書き込みのサポート	注意
JPEG	`true`	`true`
PNG	`true`	`true`
GIF	`true`	`true`
XBM	`true`	`true`
XPM	`true`	`false`
WBMP	`true`	`true`
WebP	`true`	`true`
BMP	`true`	`true`	PHP 7.2.0 以降で利用可能です

ほとんどのフォーマットは読み書きの両方に対応していますが、 PHP をコンパイルするときにそのフォーマットのサポートを組み込んでいるとは限りません。 GD でどのフォーマットを使えるようにコンパイルしたのかを調べるには gd_info() 関数を使いましょう。コンパイル時の設定については、インストール方法のページを参照ください。

インストール/設定
定義済み定数
例
GD および Image 関数
- gd_info — 現在インストールされているGDライブラリに関する情報を取得する
- getimagesize — 画像の大きさを取得する
- getimagesizefromstring — 画像の大きさを文字列から取得する
- image_type_to_extension — 画像形式からファイルの拡張子を取得する
- image_type_to_mime_type — getimagesize, exif_read_data, exif_thumbnail, exif_imagetypeから返される画像形式のMIMEタイプを取得する
- image2wbmp — 画像をブラウザあるいはファイルに出力する
- imageaffine — 元の画像を、オプションのクリッピング領域を使ってアフィン変換した画像を返す
- imageaffinematrixconcat — 二つのアフィン変換行列を連結する
- imageaffinematrixget — アフィン変換行列を取得する
- imagealphablending — イメージのブレンドモードを設定する
- imageantialias — アンチエイリアス機能を使用すべきかどうかを判断する
- imagearc — 部分楕円を描画する
- imageavif — 画像をブラウザあるいはファイルに出力する
- imagebmp — ビットマップ画像をブラウザかファイルに出力する
- imagechar — 水平に文字を描画する
- imagecharup — 垂直に文字を描画する
- imagecolorallocate — 画像で使用する色を作成する
- imagecolorallocatealpha — 画像で使用する色を透過度を指定して作成する
- imagecolorat — ピクセルの色のインデックスを取得する
- imagecolorclosest — 指定した色に最も近い色のインデックスを取得する
- imagecolorclosestalpha — 指定した色+アルファ値に最も近い色のインデックスを取得する
- imagecolorclosesthwb — 色合い、白、黒を有する色のインデックスを得る
- imagecolordeallocate — イメージの色リソースを開放する
- imagecolorexact — 指定した色のインデックスを取得する
- imagecolorexactalpha — 指定した色+アルファ値のインデックスを取得する
- imagecolormatch — パレットイメージの色を True カラーイメージに近づける
- imagecolorresolve — 指定した色または出来るだけ近い色のインデックスを得る
- imagecolorresolvealpha — 指定した色+アルファ値または最も近い色のインデックスを取得する
- imagecolorset — 指定したパレットインデックスの色を設定する
- imagecolorsforindex — カラーインデックスからカラーを取得する
- imagecolorstotal — 画像パレットの色数を検出する
- imagecolortransparent — 透明色を定義する
- imageconvolution — div および offset の係数を使用し、3x3 の畳み込み配列を適用する
- imagecopy — 画像の一部をコピーする
- imagecopymerge — イメージの一部をコピー、マージする
- imagecopymergegray — グレースケールでイメージの一部をコピー、マージする
- imagecopyresampled — 再サンプリングを行いイメージの一部をコピー、伸縮する
- imagecopyresized — 画像の一部をコピーしサイズを変更する
- imagecreate — パレットを使用する新規画像を作成する
- imagecreatefromavif — 新しい画像をファイルあるいは URL から作成する
- imagecreatefrombmp — 新しい画像をファイルあるいは URL から作成する
- imagecreatefromgd — GD ファイルまたは URL から新規イメージを生成する
- imagecreatefromgd2 — GD2 ファイルまたは URL から新規イメージを生成する
- imagecreatefromgd2part — GD2 ファイルまたは URL の指定した部分から新規イメージを生成する
- imagecreatefromgif — 新しい画像をファイルあるいは URL から作成する
- imagecreatefromjpeg — 新しい画像をファイルあるいは URL から作成する
- imagecreatefrompng — 新しい画像をファイルあるいは URL から作成する
- imagecreatefromstring — 文字列の中のイメージストリームから新規イメージを作成する
- imagecreatefromtga — 新しい画像をファイルあるいは URL から作成する
- imagecreatefromwbmp — 新しい画像をファイルあるいは URL から作成する
- imagecreatefromwebp — 新しい画像をファイルあるいは URL から作成する
- imagecreatefromxbm — 新しい画像をファイルあるいは URL から作成する
- imagecreatefromxpm — 新しい画像をファイルあるいは URL から作成する
- imagecreatetruecolor — TrueColor イメージを新規に作成する
- imagecrop — 指定した矩形に画像をクロップする
- imagecropauto — 利用可能なモードを指定して、画像を自動的にクロップする
- imagedashedline — 破線を描画する
- imagedestroy — 画像を破棄する
- imageellipse — 楕円を描画する
- imagefill — 塗り潰す
- imagefilledarc — 楕円弧を描画し、塗りつぶす
- imagefilledellipse — 塗りつぶされた楕円を描画する
- imagefilledpolygon — 塗りつぶした多角形を描画する
- imagefilledrectangle — 塗りつぶした矩形を描画する
- imagefilltoborder — 特定色で塗りつぶす
- imagefilter — 画像にフィルタを適用する
- imageflip — 指定したモードで画像を反転させる
- imagefontheight — フォントの高さを取得する
- imagefontwidth — フォントの幅を取得する
- imageftbbox — freetype2 によるフォントを用いたテキストを囲む箱を取得する
- imagefttext — FreeType 2 によるフォントを用いてイメージにテキストを描画する
- imagegammacorrect — GD イメージにガンマ補正を適用する
- imagegd — GD イメージをブラウザまたはファイルに出力する
- imagegd2 — GD2 イメージをブラウザまたはファイルに出力する
- imagegetclip — 長方形を切り取り、画像として取得する
- imagegetinterpolation — 補間方法を取得する
- imagegif — 画像をブラウザあるいはファイルに出力する
- imagegrabscreen — 画面全体をキャプチャする
- imagegrabwindow — ウィンドウをキャプチャする
- imageinterlace — インターレースを有効もしくは無効にする
- imageistruecolor — 画像が truecolor かどうか調べる
- imagejpeg — 画像をブラウザあるいはファイルに出力する
- imagelayereffect — アルファブレンディングフラグを設定し、レイヤ効果を使用する
- imageline — 直線を描画する
- imageloadfont — 新しいフォントを読み込む
- imageopenpolygon — オープンポリゴンを描画する
- imagepalettecopy — あるイメージから他のイメージにパレットをコピーする
- imagepalettetotruecolor — パレット形式の画像を true color に変換する
- imagepng — PNG イメージをブラウザまたはファイルに出力する
- imagepolygon — 多角形を描画する
- imagerectangle — 矩形を描画する
- imageresolution — 画像の解像度を取得/設定する
- imagerotate — 指定された角度で画像を回転する
- imagesavealpha — 画像を保存する際に、完全なアルファチャネル情報を保存するかどうかを指定する
- imagescale — 幅と高さを指定して、画像の縮尺を変更する
- imagesetbrush — 線の描画用にブラシイメージを設定する
- imagesetclip — 切り取る長方形を設定する
- imagesetinterpolation — 補間方法を設定する
- imagesetpixel — 点を生成する
- imagesetstyle — 線描画用のスタイルを設定する
- imagesetthickness — 線描画用の線幅を設定する
- imagesettile — 塗りつぶし用のイメージを設定する
- imagestring — 文字列を水平に描画する
- imagestringup — 文字列を垂直に描画する
- imagesx — 画像の幅を取得する
- imagesy — 画像の高さを取得する
- imagetruecolortopalette — TrueColor イメージをパレットイメージに変換する
- imagettfbbox — TypeType フォントを使用したテキストの bounding box を生成する
- imagettftext — TrueType フォントを使用してテキストを画像に書き込む
- imagetypes — この PHP がサポートしている画像形式を返す
- imagewbmp — 画像をブラウザあるいはファイルに出力する
- imagewebp — WebP 画像をブラウザあるいはファイルに出力する
- imagexbm — XBM 画像をブラウザあるいはファイルに出力する
- iptcembed — バイナリ IPTC データを JPEG イメージに埋めこむ
- iptcparse — バイナリの IPTC ブロックのタグをパースする
- jpeg2wbmp — JPEG画像をWBMP画像に変換する
- png2wbmp — PNG画像をWBMP画像に変換する
GdImage — GdImage クラス
GdFont — GdFont クラス