導入

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

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

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

要件

GD ライブラリ( http://www.boutell.com/gd/ で取得可能)があれば、画像の作成と操 作を行なうこともできます。

操作できるイメージの形式は、インストールされている GD とこれらのイメージフォーマットにアクセスする ために GD が必要とするその他のライブラリに依存し ます。gd-1.6より前のバージョンのgdは、GIFイメージ画像をサポートし ていますが、PNGはサポートしていません。一方、gd-1.6以降でgd-2.0.28未満の バージョンはPNGをサポートし、GIFはサポートしていません。 GIFサポートは、gd-2.0.28で再度有効になりました。

より多くのイメージ形式を処理するために GD を拡張したいと思うかもしれません。

別の種類のフォントを処理できるようにGDを拡張したいと思うかもしれ ません。以下にサポートされるフォントライブラリを示します。

インストール手順

PHPでGDサポートを有効にするには、configure に --with-gd[=DIR] を指定します。ただし、DIRは GDのベースインストールディレクトリです。 PHPにバンドルされている推奨のGDライブラリを使用するには --with-gd を指定します。 GD ライブラリをコンパイルするには、 libpng と libjpeg が必要です。

Windowsの場合、GD2 DLL php_gd2.dll を php.ini に エクステンションとして指定してください。 GD1 DLL php_gd.dll はPHP4.3.2で削除されました。 imagecreatetruecolor() のようにTrueカラーが優先される関数 についてはGD2が必須です。

PHP3においてGDサポートを無効にするには --without-gd を指定してください。

より多くの画像フォーマットを扱えるようにGDの能力を高めるには、 --with-XXXX のような形のオプションを指定します。

GDがより多くのフォントを扱えるようにするには --with-XXXX のような形のオプションを指定します。

実行時設定

イメージ関数固有の設定項目はありませんが、 exif 拡張モジュール のディレクティブに興味を持つかも知れません。

リソース型

リソース型は定義されていません。

定義済み定数

以下の定数が定義されています。 この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、 実行時に動的にロードされている場合のみ使用可能です。

例

例 1. PHPによるPNGの生成 <?php header ( "Content-type: image/png" ); $string = $_GET [ 'text' ]; $im      = imagecreatefrompng ( "images/button1.png" ); $orange = imagecolorallocate ( $im , 220 , 210 , 60 ); $px      = ( imagesx ( $im ) - 7.5 * strlen ( $string )) / 2 ; imagestring ( $im , 3 , $px , 9 , $string , $orange ); imagepng ( $im ); imagedestroy ( $im ); ?>

この例のスクリプトは、<img src="button.php?text"> のようなタグによりあるページからコールされるものです。 上のbutton.phpスクリプトは、この "text" 文字列を引数と し、この場合は "images/button1.png" である基本イメージ の最上部にこの文字列を描いた後、描画後ののイメージを出力します。 この方法は、ボタンのテキストを変更する度に新規のボタンを生成する 必要があるのを回避するために便利な手法です。 この方法により、動的にイメージボタンを生成できます。