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

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

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

<title>Bildbearbeitung und GD</title>

<titleabbrev>GD</titleabbrev>

<!-- {{{ preface -->

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

&reftitle.intro;

<para>

Mit PHP können Sie nicht nur HTML ausgeben, sondern auch Grafiken in vielen

Formaten wie <acronym>GIF</acronym>, <acronym>PNG</acronym>,

<acronym>JPEG</acronym>, <acronym>WBMP</acronym> und <acronym>XPM</acronym>

erzeugen und/oder manipulieren. Noch besser, Sie können Grafiken mit PHP

direkt als Datenstrom ausgeben. Damit das funktioniert, müssen Sie PHP mit

der <acronym>GD</acronym>-Bibliothek zur Grafikbearbeitung kompilieren.

<acronym>GD</acronym> und PHP benötigen, je nachdem mit welchen

Grafikformaten Sie arbeiten wollen, zusätzliche Bibliotheken.

</para>

<para>

Sie können die Grafikfunktionen in PHP auch verwenden, um die Größe von

<acronym>JPEG</acronym>-, <acronym>GIF</acronym>-, <acronym>PNG</acronym>-,

<acronym>SWF</acronym>-, <acronym>TIFF</acronym>- und

<acronym>JPEG2000</acronym>-Grafiken zu bestimmen.

</para>

<para>

Mittels der <link linkend="ref.exif">exif-Erweiterung</link> können Sie die

in den Headern von <acronym>JPEG</acronym>- und

<acronym>TIFF</acronym>-Grafiken enthaltenen Informationen verarbeiten. Auf

diese Weise können von Digitalkameras erstellte Metadaten verarbeitet

werden. Die Exif-Funktionen benötigen die <acronym>GD</acronym>-Bibliothek

nicht.

</para>

<para>

<note>

<simpara>

Im Abschnitt über die Anforderungen können Sie nachlesen, wie Sie die

Möglichkeiten der Bildbearbeitung zum Lesen, Schreiben und Manipulieren

von Bildern erweitern können. Um Metadaten von Bildern auszulesen, die

mit einer Digitalkamera aufgenommen wurden, wird die bereits erwähnte

<link linkend="ref.exif">exif-Erweiterung</link> benötigt.

</simpara>

</note>

<note>

<simpara>

Für die Funktion <function>getimagesize</function> wird die GD-Bibliothek

nicht benötigt.

</simpara>

</note>

<caution>

<simpara>

Während die gebündelte Version der GD-Bibliothek den Zend-Speichermanager

zur Allokation von Speicher verwendet, tun dies die Systemversionen

nicht, sodass <link linkend="ini.memory-limit">memory_limit</link>

ignoriert wird.

</simpara>

</caution>

</para>

<para>

GD unterstützt viele Formate. Nachfolgend eine Liste aller von GD

unterstützten Formaten und Hinweise zu Verfügbarkeit und

Lese-/Schreibunterstützung.

</para>

<para>

<table>

<title>Von GD unterstützte Formate</title>

<tgroup cols="4">

<thead>

<row>

<entry>Format</entry>

<entry>Lesen</entry>

<entry>Schreiben</entry>

<entry>Anmerkungen</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>Verfügbar seit PHP 7.2.0</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

<para>

Obwohl die meisten Formate in der obigen Tabelle sowohl zum Lesen als auch

zum Schreiben verfügbar sind, bedeutet dies nicht, dass die Unterstützung

in PHP einkompiliert ist. Welche Formate dies sind und wie PHP mit

Unterstützung für diese kompiliert werden kann, zeigt die Funktion

<function>gd_info</function>. Weitere Informationen zu diesem Thema sind im

Kapitel Installation zu finden.

</para>

</preface>

<!-- }}} -->

&reference.image.setup;

&reference.image.constants;

&reference.image.examples;

&reference.image.reference;

&reference.image.gdimage;

&reference.image.gdfont;

</book>