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

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

&reftitle.setup;

<!-- {{{ Requirements -->

<section xml:id="image.requirements">

&reftitle.required;

<para>

<acronym>GD</acronym>ライブラリ( <link

xlink:href="&url.gd;">&url.gd;</link>で取得可能)があれば、画像の作成と操

作を行なうこともできます。

</para>

<para>

操作できるイメージの形式は、インストールされている

<acronym>GD</acronym>とこれらのイメージフォーマットにアクセスする

ために<acronym>GD</acronym>が必要とするその他のライブラリに依存します。

<note>

<simpara>

libgd-2.1.0 以降が必要です。

もしなければ、PHP に附属する

<acronym>GD</acronym> ライブラリを使います。

</simpara>

</note>

<note>

<simpara>

<acronym>GD</acronym> ライブラリは、zlib &gt;= 1.2.0.4 が必要です。

</simpara>

</note>

</para>

<para>

より多くのイメージ形式を処理するために

<acronym>GD</acronym> を拡張したいと思うかもしれません。

<table>

<title>サポートされるイメージ形式</title>

<tgroup cols="3">

<thead>

<row>

<entry>イメージ形式</entry>

<entry>ダウンロードするライブラリ</entry>

<entry>注記</entry>

</row>

</thead>

<tbody>

<row>

<entry><literal>gif</literal></entry>

<entry></entry>

<entry></entry>

</row>

<row>

<entry><literal>avif</literal></entry>

<entry></entry>

<entry></entry>

</row>

<row>

<entry><literal>jpeg</literal></entry>

<entry><link xlink:href="&url.jpeg;">&url.jpeg;</link></entry>

<entry>

(PHP のビルド前に) jpeg ライブラリをビルドする際、configure で

<option role="configure">--enable-shared</option>

オプションを指定する必要があります。

そうしないと、PHP をビルドする際の configure で

<literal>libjpeg.(a|so) not found</literal> というエラーが発生します。

</entry>

</row>

<row>

<entry><literal>png</literal></entry>

<entry><link xlink:href="&url.libpng;">&url.libpng;</link></entry>

<entry>

</entry>

</row>

<row>

<entry><literal>xpm</literal></entry>

<entry><link xlink:href="&url.libxpm;">&url.libxpm;</link></entry>

<entry>

Xウインドウ環境をインストールしている場合、

このライブラリを既に利用可能と思われます。

</entry>

</row>

<row>

<entry><literal>webp</literal></entry>

<entry></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

</para>

<para>

別の種類のフォントを処理できるように <acronym>GD</acronym> を拡張したいと思うかもしれません。

そうした用途のために、<link xlink:href="&url.freetype;">FreeType 2</link> ライブラリがサポートされています。

</para>

</section>

<!-- }}} -->

<!-- {{{ Installation -->

&reference.image.configure;

<!-- }}} -->

<!-- {{{ Configuration -->

&reference.image.ini;

<!-- }}} -->

<!-- {{{ Resources -->

<section xml:id="image.resources">

&reftitle.resources;

<para>

この拡張モジュールでは、以下のリソース型を定義しています。

<table>

<title>GD におけるリソース型の一覧</title>

<tgroup cols="3">

<thead>

<row>

<entry>名前</entry>

<entry>説明</entry>

<entry>備考</entry>

</row>

</thead>

<tbody>

<row>

<entry><literal>gd</literal></entry>

<entry>画像リソース。<function>imagecreatefrompng</function> などの関数が利用します。</entry>

<entry>PHP 8.0.0 より前</entry>

</row>

<row>

<entry><literal>gd font</literal></entry>

<entry><function>imageloadfont</function> が内部的に生成したフォントリソース。</entry>

<entry>PHP 8.1.0 より前</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

</section>

<!-- }}} -->

</chapter>