<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: 213fbd9440a224f9c1da4942c85124ce0c120c52 Maintainer: takagi Status: ready -->

<!-- CREDITS: hirokawa,mumumu -->

<book xml:id="book.image" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<?phpdoc extension-membership="bundled" ?>

<title>画像処理 (GD)</title>

<titleabbrev>GD</titleabbrev>

<!-- {{{ preface -->

<preface xml:id="intro.image">

&reftitle.intro;

<para>

PHPができることは、HTML出力を生成することだけではありません。PHP

は、多くの異なるイメージ形式でイメージファイルを作成したり、操作

したりすることもできます。このイメージ形式には、<acronym>GIF</acronym>, <acronym>PNG</acronym>,

<acronym>JPEG</acronym>, <acronym>WBMP</acronym> および <acronym>XPM</acronym> が含まれます。

さらに便利なことに、PHPはイメージストリームを直接ブラウザに出力することができます。

イメージ関数を使用するには、PHP を

<acronym>GD</acronym> ライブラリとともにコンパイルしなければなりません。

使用したいイメージ形式によっては、<acronym>GD</acronym> と PHP

以外に他のライブラリも必要となる可能性があります。

</para>

<para>

PHPのイメージ関数により

<acronym>JPEG</acronym>、<acronym>GIF</acronym>、

<acronym>PNG</acronym>、<acronym>SWF</acronym>、

<acronym>TIFF</acronym>、<acronym>JPEG2000</acronym>イメージの

大きさを知ることができます。

</para>

<para>

<link linkend="ref.exif">exif 拡張モジュール</link> を使用すると、

<acronym>JPEG</acronym> や <acronym>TIFF</acronym>

画像のヘッダに保存された情報を扱うことができます。

これにより、デジタルカメラが作成したメタデータを読み込むことができます。

exif 関数は <acronym>GD</acronym> ライブラリは必要ありません。

</para>

<para>

<note>

<simpara>

イメージの読み込み、書き込み、修正の機能を拡張するには、

要求の節を呼んでください。

デジタルカメラで撮影した画像のメタデータを読み込むには、

上で説明した <link linkend="ref.exif">exif

拡張モジュール</link> が必要です。

</simpara>

</note>

<note>

<simpara>

<function>getimagesize</function> 関数は、GD 拡張モジュールは必要ありません。

</simpara>

</note>

<caution>

<simpara>

バンドルされている GD ライブラリは、メモリを確保するのに

Zend メモリマネージャーを使っていますが、

システムにインストールされている GD ライブラリは使っていません。

よって、後者には <link

linkend="ini.memory-limit">memory_limit</link> は適用されません。

</simpara>

</caution>

</para>

<para>

GD はさまざまなフォーマットに対応しています。

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

</para>

<para>

<table>

<title>GD がサポートするフォーマット</title>

<tgroup cols="4">

<thead>

<row>

<entry>フォーマット</entry>

<entry>読み込みのサポート</entry>

<entry>書き込みのサポート</entry>

<entry>注意</entry>

</row>

</thead>

<tbody>

<row>

<entry>JPEG</entry>

<entry>&true;</entry>

<entry>&true;</entry>

<entry></entry>

</row>

<row>

<entry>PNG</entry>

<entry>&true;</entry>

<entry>&true;</entry>

<entry></entry>

</row>

<row>

<entry>GIF</entry>

<entry>&true;</entry>

<entry>&true;</entry>

<entry></entry>

</row>

<row>

<entry>XBM</entry>

<entry>&true;</entry>

<entry>&true;</entry>

<entry></entry>

</row>

<row>

<entry>XPM</entry>

<entry>&true;</entry>

<entry>&false;</entry>

<entry></entry>

</row>

<row>

<entry>WBMP</entry>

<entry>&true;</entry>

<entry>&true;</entry>

<entry></entry>

</row>

<row>

<entry>WebP</entry>

<entry>&true;</entry>

<entry>&true;</entry>

<entry></entry>

</row>

<row>

<entry>BMP</entry>

<entry>&true;</entry>

<entry>&true;</entry>

<entry>PHP 7.2.0 以降で利用可能です</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

<para>

ほとんどのフォーマットは読み書きの両方に対応していますが、

PHP をコンパイルするときにそのフォーマットのサポートを組み込んでいるとは限りません。

GD でどのフォーマットを使えるようにコンパイルしたのかを調べるには

<function>gd_info</function> 関数を使いましょう。

コンパイル時の設定については、インストール方法のページを参照ください。

</para>

</preface>

<!-- }}} -->

&reference.image.setup;

&reference.image.constants;

&reference.image.examples;

&reference.image.reference;

&reference.image.gdimage;

&reference.image.gdfont;

</book>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->