svn: /phpdoc/de/trunk/reference/image/functions/ imagegif.xml imagejpeg.xml imagepng.xml

Modified: phpdoc/de/trunk/reference/image/functions/imagegif.xml
===================================================================
--- phpdoc/de/trunk/reference/image/functions/imagegif.xml	2010-04-26 18:35:54 UTC (rev 298608)
+++ phpdoc/de/trunk/reference/image/functions/imagegif.xml	2010-04-26 19:18:12 UTC (rev 298609)
@@ -1,104 +1,216 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- splitted from ./de/functions/image.xml, last change in rev 1.3 -->
-<!-- last change to 'imagegif' in en/ tree in rev 1.3 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.26/EN.1.3 -->
-  <refentry xml:id="function.imagegif" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>imagegif</refname>
-    <refpurpose>
-     Ausgabe eines Bildes an den Browser oder in eine Datei
-    </refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Beschreibung:</title>
-     <methodsynopsis>
-      <type>int</type><methodname>imagegif</methodname>
-      <methodparam><type>resource</type><parameter>im</parameter></methodparam>
-      <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam>
-     </methodsynopsis>
-    <para>
-     <function>ImageGIF</function> erzeugt eine Datei im Format
-     <acronym>GIF</acronym> aus <parameter>im</parameter>. Falls
-     Sie <optional>filename</optional> angegeben haben, wird die
-     Ausgabe in diese Datei geschrieben, ansonsten wird die Ausgabe
-     direkt an den Browser geleitet. <parameter>Im</parameter> ist
-     das Ergebnis der <function>imagecreate</function>-Funktion.
-    </para>
-    <para>
-     Das Format wird <acronym>GIF87a</acronym> sein, es sei denn, Sie
-     haben das Bild per <function>ImageColorTransparent</function>
-     als transparent formatiert. In diesem Fall wird das Bild im
-     <acronym>GIF89a</acronym>-Format ausgegeben.
-    </para>
-    <para>
-     Die Angabe des Dateinamens ist optional. Falls er fehlt, werden
-     die Bilddaten direkt ausgegeben. Durch Verwendung der Funktion
-     <function>header</function> mit der "content-type"-Angabe
-     "image/gif" können Sie PHP-Skripte erstellen, welche die
-     <acronym>GIF</acronym>-Ausgabe direkt vornehmen.
-     <note>
+<!-- EN-Revision: 297028 Maintainer: simp Status: ready -->
+<refentry xml:id="function.imagegif" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>imagegif</refname>
+  <refpurpose>Ausgabe des Bildes im Browser oder als Datei</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>imagegif</methodname>
+   <methodparam><type>resource</type><parameter>image</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+
+   <function>imagegif</function> erzeugt eine <acronym>GIF</acronym>-Datei aus dem
+   übergebenen <parameter>image</parameter>. Der Inhalt des Parameters
+   <parameter>image</parameter> ist die Rückgabe der Funktionen
+   <function>imagecreate</function> oder <literal>imagecreatefrom*</literal>
+  </para>
+  <para>
+   Das Dateiformat wird <acronym>GIF87a</acronym> sein, es sei denn
+   das Bild wurde mittels <function>imagecolortransparent</function>
+   transparent gemacht. In diesem Fall wird das Dateiformat
+   <acronym>GIF89a</acronym> sein.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    &gd.image.description;
+    <varlistentry>
+     <term><parameter>filename</parameter></term>
+     <listitem>
       <para>
-       ACHTUNG: Ab Version 1.6 wurde die GIF-Unterstützung komplett
-       aus der GD-Bibliothek entfernt. Diese Funktion ist also nur
-       verfügbar, wenn Sie eine Version vor 1.6 verwenden.
+       Der Pfad der Datei, in die geschrieben werden soll. Wenn dies nicht gesetzt
+       oder &null; ist, so wird die Bilddatei direkt ausgegeben.
       </para>
-      <para>
-       Um trotzdem portable PHP-Anwendungen schreiben zu können,
-       kann mit folgendem Code-Stück automatisch geprüft werden,
-       welches Bildformat in der mitgebundenen GD-Bibliothek
-       nutzbar ist. Ersetzen Sie hierfür die Codesequenz
-       <literal>Header("Content-type: image/gif");
-       ImageGif($im);</literal> durch die flexiblere Folge:
-       <informalexample>
-        <programlisting role="php">
-&lt;?php
-  if (function_exists("imagegif")) {
-    Header("Content-type: image/gif");
-    ImageGif($im);
-  }
-  elseif (function_exists("imagejpeg")) {
-    Header("Content-type: image/jpeg");
-    ImageJpeg($im, "", 0.5);
-  }
-  elseif (function_exists("imagepng")) {
-    Header("Content-type: image/png");
-    ImagePng($im);
-  }
-  else
-    die("Keine Grafik-Unterstützung vorhanden");
-?&gt;
-        </programlisting>
-       </informalexample>
-      </para>
-     </note>
-     <note>
-      <para>
-       In PHP 4 ab Version 4.0.2 haben Sie alternativ zum Test
-       per <function>function_exists</function> auch die
-       Möglichkeit, mit der
-       <function>imagetypes</function>-Funktion
-       die unterstützten Bildformate abzutesten.
-       <informalexample>
-        <programlisting role="php">
-if (ImageTypes() &amp; IMG_GIF) {
-    Header("Content-type: image/gif");
-    ImageGif($im);
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Ein Bild mittels <function>imagegif</function> ausgeben</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Erzeugt ein neues Bild
+$im = imagecreatetruecolor(100, 100);
+
+// Den Hintergrund weiß machen
+imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF);
+
+// Einen Text im Bild ausgeben
+imagestring($im, 3, 40, 20, 'GD Library', 0xFFBA00);
+
+// Das Bild an den Browser ausgeben
+header('Content-type: image/gif');
+
+imagegif($im);
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+   </example>
+   <example>
+    <title>Eine PNG-Datei mit <function>imagegif</function> in GIF konvertieren</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+// Die PNG-Datei laden
+$png = imagecreatefrompng('./php.png');
+
+// Die Datei im GIF-Format speichern
+imagegif($png, './php.gif');
+
+// Den Speicher freigeben
+imagedestroy($png);
+
+// Wir sind fertig
+echo 'Die PNG-Datei wurde erfolgreich nach GIF konvertiert!';
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Die Unterstützung des <acronym>GIF</acronym>-Dateiformates wurde in der
+    Version 1.6 der <acronym>GD</acronym>-Bibliothek entfernt und in der
+    Version 2.0.28 wieder hinzugefügt. Nähere Angaben finden Sie auf der
+    Webseite des <link xlink:href="&url.gd;">GD Projekts</link>.
+   </para>
+   <para>
+    Der folgende Codeauszug erlaubt es Ihnen leichter umzuziehende
+    PHP-Anwendungen zu schreiben, indem die von GD unterstützten
+    Dateiformat automatisch erkannt werden. Ersetzen Sie den
+    Abschnitt <literal>header ("Content-type: image/gif");
+    imagegif ($im);</literal> durch den folgenden Abschnitt:
+    <informalexample>
+     <programlisting role="php">
+<![CDATA[
+<?php
+// Ein neues Bild erzeugen
+$im = imagecreatetruecolor(100, 100);
+
+// Hier wird das Bild bearbeitet
+
+// Ausgabebehandlung
+if(function_exists('imagegif'))
+{
+    // Für GIF
+    header('Content-type: image/gif');
+
+    imagegif($im);
 }
-elseif (ImageTypes() &amp; IMG_JPG) {
-... etc.</programlisting>
-       </informalexample>
-      </para>
-     </note>
-    </para>
-    <para>
-     Siehe auch <function>imagepng</function>,
-     <function>imagejpeg</function>, <function>imagetypes</function>.
-    </para>
-   </refsect1>
-  </refentry>
+elseif(function_exists('imagejpeg'))
+{
+    // Für JPEG
+    header('Content-type: image/jpeg');

+    imagejpeg($im, NULL, 100);
+}
+elseif(function_exists('imagepng'))
+{
+    // Für PNG
+    header('Content-type: image/png');
+
+    imagepng($im);
+}
+elseif(function_exists('imagewbmp'))
+{
+    // Für WBMP
+    header('Content-type: image/vnd.wap.wbmp');
+
+    imagewbmp($im);
+}
+else
+{
+    imagedestroy($im);
+
+    die('Auf diesem Server gibt es keine untersützten Bildformate');
+}
+
+// Falls Unterstützung für eines von diesen Formaten
+// gefunden wurde geben wir den Speicher frei
+if($im)
+{
+    imagedestroy($im);
+}
+?>
+]]>
+     </programlisting>
+    </informalexample>
+   </para>
+  </note>
+  <note>
+   <para>
+    Seit der PHP-Version 4.0.2 kann die Funktion
+    <function>imagetypes</function> anstelle der Funktiom
+    <function>function_exists</function> zur Prüfung der
+    Unterstützung der verschiedenen Dateiformate
+    verwendet werden:
+    <informalexample>
+     <programlisting role="php">
+<![CDATA[
+<?php
+if(imagetypes() & IMG_GIF)
+{
+    header('Content-type: image/gif');
+    imagegif($im);
+}
+elseif(imagetypes() & IMG_JPG)
+{
+    /* ... etc. */
+}
+?>
+]]>
+     </programlisting>
+    </informalexample>
+   </para>
+  </note>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>imagepng</function></member>
+    <member><function>imagewbmp</function></member>
+    <member><function>imagejpeg</function></member>
+    <member><function>imagetypes</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -110,7 +222,7 @@
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil

Modified: phpdoc/de/trunk/reference/image/functions/imagejpeg.xml
===================================================================
--- phpdoc/de/trunk/reference/image/functions/imagejpeg.xml	2010-04-26 18:35:54 UTC (rev 298608)
+++ phpdoc/de/trunk/reference/image/functions/imagejpeg.xml	2010-04-26 19:18:12 UTC (rev 298609)
@@ -1,54 +1,166 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- splitted from ./de/functions/image.xml, last change in rev 1.2 -->
-<!-- last change to 'imagejpeg' in en/ tree in rev 1.30 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.26/EN.1.30 -->
-  <refentry xml:id="function.imagejpeg" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>imagejpeg</refname>
-    <refpurpose>
-     Ausgabe des Bildes im Browser oder als Datei
-    </refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Beschreibung:</title>
-     <methodsynopsis>
-      <type>int</type><methodname>imagejpeg</methodname>
-      <methodparam><type>resource</type><parameter>im</parameter></methodparam>
-      <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>quality</parameter></methodparam>
-     </methodsynopsis>
-    <para>
-     <function>ImageJPEG</function> erzeugt die Datei
-     <parameter>filename</parameter> im <acronym>JPEG</acronym>-Format
-     aus dem Zeiger auf <parameter>im</parameter>. Das Argument
-     <parameter>im</parameter> wurde ihnen vorher durch den Aufruf der
-     Funktion <function>ImageCreate</function> mitgeteilt.
-    </para>
-    <para>
-     Die Angabe des Dateinamens <parameter>filename</parameter> ist
-     optional. Fehlt er, werden die erzeugten Bilddaten direkt
-     ausgegeben. Um die Angabe des Dateinamen zu umgehen, dennoch
-     aber den Parameter als solchen zu nutzen, können Sie einen
-     Leerstring ('') benutzen. Durch Verwendung der Funktion
-     <function>header</function> mit der "content-type"-Angabe
-     "image/jpeg" können Sie PHP-Skripte erstellen, welche die
-     <acronym>JPEG</acronym>-Ausgabe direkt vornehmen.
-    </para>
-    <note>
-     <para>
-      Die JPEG-Unterstützung können Sie nur verwenden, wenn Sie PHP
-      mit einer GD-Bibliothek ab Version 1.8 kompiliert haben.
-     </para>
-    </note>
-    <para>
-     Siehe auch <function>imagepng</function>,
-     <function>imagegif</function>, <function>imagetypes</function>.
-    </para>
-   </refsect1>
-  </refentry>
+<!-- EN-Revision: 297028 Maintainer: simp Status: ready -->
+<refentry xml:id="function.imagejpeg" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>imagejpeg</refname>
+  <refpurpose>Ausgabe des Bildes im Browser oder als Datei</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>imagejpeg</methodname>
+   <methodparam><type>resource</type><parameter>image</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>quality</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>imagejpeg</function> erzeugt eine <acronym>JPEG</acronym>-Datei aus dem
+   übergebenen <parameter>image</parameter>.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    &gd.image.description;
+    <varlistentry>
+     <term><parameter>filename</parameter></term>
+     <listitem>
+      <para>
+       Der Pfad der Datei, in die geschrieben werden soll. Wenn dies nicht gesetzt
+       oder &null; ist, so wird die Bilddatei direkt ausgegeben.
+      </para>
+      <para>
+       Um diesen Parameter zu übergehen, um den Parameter
+       <parameter>quality</parameter> anzugeben kann &null; verwendet werden.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>quality</parameter></term>
+     <listitem>
+      <para>
+       <parameter>quality</parameter> ist optional und es kann ein Wert zwischen
+       0 (schlechteste Qualität, kleine Datei) und 100 (beste Qualität, größte Datei)
+       übergeben werden. Der Standardwert ist der standardmäßige
+       IJG-Qualitätswert (ungefähr 75).
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Ein Bild ausgeben</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Erzeut ein leeres Bild und fügt ein wenig Text hinzu
+$im = imagecreatetruecolor(120, 20);
+$text_color = imagecolorallocate($im, 233, 14, 91);
+imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

+// Die Content-Type-Kopfzeile senden, in diesem Fall image/jpeg
+header('Content-type: image/jpeg');
+
+// Das Bild ausgeben
+imagejpeg($im);
+
+// Den Speicher freigeben
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <mediaobject>
+     <alt>Ausgabe des Beispiels: Ein Bild ausgeben</alt>
+     <imageobject>
+      <imagedata fileref="en/reference/image/figures/imagejpeg.jpg"/>
+     </imageobject>
+    </mediaobject>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>Ein Bild speichern</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Erzeugt ein leeres Bild und fügt ein wenig Text hinzu
+$im = imagecreatetruecolor(120, 20);
+$text_color = imagecolorallocate($im, 233, 14, 91);
+imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);
+
+// Das Bild als 'simpletext.jpg' speichern
+imagejpeg($im, 'simpletext.jpg');
+
+// Den Speicher freigeben
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>Das Bild mit 75% Qualität ausgeben</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Erzeugt ein leeres Bild und fügt ein wenig Text hinzu
+$im = imagecreatetruecolor(120, 20);
+$text_color = imagecolorallocate($im, 233, 14, 91);
+imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);
+
+// Die Content-Type-Kopfzeile senden, in diesem Fall image/jpeg
+header('Content-type: image/jpeg');
+
+// Der Dateiname wird übergangen indem NULL verwendet wird
+// dann wird die Qualität auf 75% gesetzt
+imagejpeg($im, NULL, 75);
+
+// Den Speicher freigeben
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+ <refsect1 role="notes">
+  &reftitle.notes;
+  &note.config.jpeg;
+  <note>
+   <para>
+    Falls Progessive JPEGs ausgegeben werden sollen, so muss Interlacing
+    mittels <function>imageinterlace</function> eingeschaltet werden.
+   </para>
+  </note>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>imagepng</function></member>
+    <member><function>imagegif</function></member>
+    <member><function>imagewbmp</function></member>
+    <member><function>imageinterlace</function></member>
+    <member><function>imagetypes</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -60,7 +172,7 @@
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil

Modified: phpdoc/de/trunk/reference/image/functions/imagepng.xml
===================================================================
--- phpdoc/de/trunk/reference/image/functions/imagepng.xml	2010-04-26 18:35:54 UTC (rev 298608)
+++ phpdoc/de/trunk/reference/image/functions/imagepng.xml	2010-04-26 19:18:12 UTC (rev 298609)
@@ -1,60 +1,140 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- splitted from ./de/functions/image.xml, last change in rev 1.6 -->
-<!-- last change to 'imagepng' in en/ tree in rev 1.7 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.26/EN.1.7 -->
-  <refentry xml:id="function.imagepng" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>imagepng</refname>
-    <refpurpose>
-     Ausgabe eines Bildes an den Browser oder in eine Datei
-    </refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Beschreibung:</title>
-     <methodsynopsis>
-      <type>int</type><methodname>imagepng</methodname>
-      <methodparam><type>resource</type><parameter>im</parameter></methodparam>
-      <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam>
-     </methodsynopsis>
-    <para>
-     <function>ImagePNG</function> erzeugt eine Datei im Format
-     <acronym>PNG</acronym> aus <parameter>im</parameter>. Falls
-     Sie <optional>filename</optional> angegeben haben, wird die
-     Ausgabe in diese Datei geschrieben, ansonsten wird die Ausgabe
-     direkt an den Browser geleitet. <parameter>Im</parameter> ist
-     das Ergebnis der <function>imagecreate</function>-Funktion.
-     <informalexample>
-      <programlisting role="php">
-&lt;?php
-$im = ImageCreateFromPNG("test.png");
-ImagePNG($im);
-?>
-      </programlisting>
-     </informalexample>
-    </para>
-    <para>
-     Die Angabe des Dateinamens ist optional. Fehlt er, werden die
-     Bilddaten direkt ausgegeben. Durch Verwendung der Funktion
-     <function>header</function> mit der "content-type"-Angabe
-     "image/png" können Sie PHP-Skripte erstellen, welche die
-     <acronym>PNG</acronym>-Ausgabe direkt vornehmen.
-     <note>
+<!-- EN-Revision: 297028 Maintainer: simp Status: ready -->
+<refentry xml:id="function.imagepng" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>imagepng</refname>
+  <refpurpose>Ausgabe eines Bildes im Browser oder als Datei im PNG-Format</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>imagepng</methodname>
+   <methodparam><type>resource</type><parameter>image</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>quality</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>filters</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Erzeugt eine <acronym>PNG</acronym>-Datei aus dem übergebenen
+   <parameter>image</parameter> oder gibt diese direkt aus.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    &gd.image.description;
+    <varlistentry>
+     <term><parameter>filename</parameter></term>
+     <listitem>
       <para>
-       ACHTUNG: Die PNG-Unterstützung ersetzt die GIF-Funktionen ab
-       der GD-Bibliothek Version 1.6. Diese Funktion ist also nur
-       verfügbar, wenn Sie eine Version ab 1.6 verwenden.
+       Der Pfad der Datei, in die geschrieben werden soll. Wenn dies nicht übergeben
+       oder auf &null; gesetzt wird, so wird die Bilddatei direkt ausgegeben.
       </para>
-     </note>
-    </para>
-    <para>
-     Siehe auch <function>imagegif</function>,
-     <function>imagejpeg</function>, <function>imagetypes</function>.
-    </para>
-   </refsect1>
-  </refentry>
+      <note>
+       <para>
+        &null; ist ungültig, wenn die Parameter
+        <parameter>quality</parameter> und
+        <parameter>filters</parameter> nicht übergeben werden.
+       </para>
+      </note>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>quality</parameter></term>
+     <listitem>
+      <para>
+       Kompressionsstufe: Von 0 (keine Kompression) bis 9.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>filters</parameter></term>
+     <listitem>
+      <para>
+       Erlaubt einer Verkleinerung der PNG-Dateigröße. Dies ist
+       ein Bitfeld, welches beliebig aus den
+       <literal>PNG_FILTER_XXX</literal>-Konstanten zusammengesetzt
+       werden kann. <constant>PNG_NO_FILTER</constant> oder
+       <constant>PNG_ALL_FILTERS</constant> können verwendet werden,
+       um entweder alle Filter aus- oder einzuschalten.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>5.1.3</entry>
+       <entry>
+        Der <parameter>filters</parameter>-Parameter wurde hinzugefügt.
+       </entry>
+      </row>
+      <row>
+       <entry>5.1.2</entry>
+       <entry>
+        Der <parameter>quality</parameter>-Parameter wurde hinzugefügt.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <informalexample>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$im = imagecreatefrompng("test.png");
+
+header('Content-type: image/png');
+
+imagepng($im);
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+   </informalexample>
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>imagegif</function></member>
+    <member><function>imagewbmp</function></member>
+    <member><function>imagejpeg</function></member>
+    <member><function>imagetypes</function></member>
+    <member><function>imagesavealpha</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -66,7 +146,7 @@
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil