svn: /phpdoc/de/trunk/reference/image/ book.xml examples.xml reference.xml setup.xml

Modified: phpdoc/de/trunk/reference/image/book.xml
===================================================================
--- phpdoc/de/trunk/reference/image/book.xml	2010-09-30 19:48:27 UTC (rev 303904)
+++ phpdoc/de/trunk/reference/image/book.xml	2010-09-30 20:27:54 UTC (rev 303905)
@@ -1,23 +1,25 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 288721 Maintainer: jaenecke Status: ready -->
 <!-- Purpose: utilspec.image -->
 <!-- Membership: bundled -->

 <book xml:id="book.image" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>Image</title>
+ <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 gif, png, jpg, wbmp, und xpm - 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 GD-Bibliothek zur Grafikbearbeitung kompilieren. GD und PHP
-   benötigen, je nachdem mit welchen Grafikformaten Sie arbeiten wollen,
-   zusätzliche Bibliotheken.
+   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
@@ -31,17 +33,26 @@
     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
-    nicht die GD-Bibliothek.
+    nicht die <acronym>GD</acronym>-Bibliothek.
   </para>
+
   <para>
    <note>
     <simpara>
      Im Abschnitt über die Anforderungen können Sie nachlesen, wie Sie die
      Möglichkeiten zur Grafikbearbeitung erweitern können: lesen, schreiben
-     und manipulieren von Grafiken, und auslesen von Metadaten, bei Bildern
-     die mit einer Digitalkamera aufgenommen wurden.
+     und manipulieren von Grafiken, und auslesen von Metadaten bei Bildern
+     die mit einer Digitalkamera aufgenommen wurden. Für letzteres 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>
   </para>
  </preface>
  <!-- }}} -->

Modified: phpdoc/de/trunk/reference/image/examples.xml
===================================================================
--- phpdoc/de/trunk/reference/image/examples.xml	2010-09-30 19:48:27 UTC (rev 303904)
+++ phpdoc/de/trunk/reference/image/examples.xml	2010-09-30 20:27:54 UTC (rev 303905)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 294527 Maintainer: jaenecke Status: ready -->

 <chapter xml:id="image.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
@@ -25,17 +25,108 @@
 ]]>
     </programlisting>
    </example>
-   Dieses Beispiel würde von einer Seite über einen Link wie
-   &lt;img src=&quot;button.php?text=text&quot;&gt; aufgerufen.
-   Das oben aufgezeigte Beispielskript button.php nimmt den Text &quot;text&quot;
-   entgegen und legt diesen über ein vorhandenes Bild, in diesem Fall
-   &quot;images/button1.png&quot; und gibt die resultierende Grafik aus.
+   Dieses Beispiel würde von einer Seite über einen Link wie <literal>&lt;img
+   src=&quot;button.php?text=text&quot;&gt;</literal> aufgerufen.
+   Das oben aufgezeigte Beispielskript <filename>button.php</filename> nimmt den
+   Text <literal>&quot;text&quot;</literal> entgegen und legt diesen über ein
+   vorhandenes Bild, in diesem Fall <literal>&quot;images/button1.png&quot;</literal>
+   und gibt die resultierende Grafik aus.
    Diese Vorgehensweise ist sehr zweckmäßig, wenn Sie vermeiden wollen, dass
    Sie immer wieder neue Button-Grafiken erstellen müssen, falls Sie die
    Beschriftung eines Buttons ändern wollen. Mit der vorgestellten Methode
    werden Ihre Buttons, samt Beschriftung, dynamisch generiert.
   </para>
  </section>
+ <section xml:id="image.examples-watermark">
+  <para>
+   <example>
+    <title>Wasserzeichen mit Hilfe von Alpha-Kanälen zufügen</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Wasserzeichen und Foto laden
+$stamp = imagecreatefrompng('stamp.png');
+$im = imagecreatefromjpeg('photo.jpeg');
+
+// Ränder für Wasserzeichen festlegen, dessen Höhe und Breite bestimmen
+$marge_right = 10;
+$marge_bottom = 10;
+$sx = imagesx($stamp);
+$sy = imagesy($stamp);
+
+// Wasserzeichen auf das Foto kopieren, die Position berechnet sich dabei aus
+// den Rändern und der Bildbreite
+imagecopy($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp));
+
+// Ausgeben und aufräumen
+header('Content-type: image/png');
+imagepng($im);
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+    <mediaobject>
+     <alt>Wasserzeichen mit Hilfe von Alpha-Kanälen zufügen</alt>
+     <imageobject>
+      <imagedata fileref="en/reference/image/figures/watermarks.png" />
+     </imageobject>
+    </mediaobject>
+   </example>
+   Dieses Beispiel zeigt eine übliche Vorgehensweise um ein Wasserzeichen auf
+   Fotos oder urheberrechtlich geschützten Bildern anzubringen. Beachten Sie, daß
+   die Wasserzeichen-Grafik einen Alphakanal enthält. Dieser wird beim Kopiervorgang
+   beibehalten.
+  </para>
+ </section>
+ <section xml:id="image.examples.merged-watermark">
+  <para>
+   <example>
+    <title>Erstellen eines transparenten Wasserzeichens mit <function>imagecopymerge</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Foto laden
+$im = imagecreatefromjpeg('photo.jpeg');
+
+// wir erstellen ein Wasserzeichen mit GD
+$stamp = imagecreatetruecolor(100, 70);
+imagefilledrectangle($stamp, 0, 0, 99, 69, 0x0000FF);
+imagefilledrectangle($stamp, 9, 9, 90, 60, 0xFFFFFF);
+$im = imagecreatefromjpeg('photo.jpeg');
+imagestring($stamp, 5, 20, 20, 'libGD', 0x0000FF);
+imagestring($stamp, 3, 20, 40, '(c) 2007-9', 0x0000FF);
+
+// Ränder setzen, Dimensionen ermitteln
+$marge_right = 10;
+$marge_bottom = 10;
+$sx = imagesx($stamp);
+$sy = imagesy($stamp);
+
+// Wasserzeichen mit einer Transparenz von 50% über das Foto legen
+imagecopymerge($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp), 50);
+
+// Bild speichern, aufräumen
+imagepng($im, 'photo_stamp.png');
+imagedestroy($im);
+
+?>
+]]>
+    </programlisting>
+    <mediaobject>
+     <alt>Erstellen eines transparenten Wasserzeichens mit imagecopymerge()</alt>
+     <imageobject>
+      <imagedata fileref="en/reference/image/figures/watermark-merged.png" />
+     </imageobject>
+    </mediaobject>
+   </example>
+   Dieses Beispiel nutzt <function>imagecopymerge</function> um das Wasserzeichen
+   über das Original-Bild zu legen. Dabei können wir die Transparenz des Wasserzeichens
+   frei bestimmen - im Beispiel werden 50% gesetzt.
+   In der Praxis wäre dies ein sinnvolles Vorgehen zum Urheberschutz, da halbtransparente
+   Wasserzeichen schwierig zu entfernen sind, dem Betrachter aber trotzdem erlauben
+   das Bild zu sehen.
+  </para>
+ </section>
 </chapter>

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

Modified: phpdoc/de/trunk/reference/image/reference.xml
===================================================================
--- phpdoc/de/trunk/reference/image/reference.xml	2010-09-30 19:48:27 UTC (rev 303904)
+++ phpdoc/de/trunk/reference/image/reference.xml	2010-09-30 20:27:54 UTC (rev 303905)
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 297028 Maintainer: jaenecke Status: ready -->

 <reference xml:id="ref.image" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>Image-&Functions;</title>
+ <title>GD- und Image-&Functions;</title>

  &reference.image.entities.functions;


Modified: phpdoc/de/trunk/reference/image/setup.xml
===================================================================
--- phpdoc/de/trunk/reference/image/setup.xml	2010-09-30 19:48:27 UTC (rev 303904)
+++ phpdoc/de/trunk/reference/image/setup.xml	2010-09-30 20:27:54 UTC (rev 303905)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: jaenecke Status: ready -->
+<!-- EN-Revision: 300426 Maintainer: jaenecke Status: ready -->

 <chapter xml:id="image.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
@@ -16,28 +16,31 @@
   <para>
    Die mittels dieser Funktionen veränderbaren Grafik-Formate hängen davon
    ab, welche Version von <acronym>GD</acronym> Sie installieren und welche
-   zusätzlich Bibliotheken <acronym>GD</acronym> benötigt, um mit diesen
+   zusätzlichen Bibliotheken <acronym>GD</acronym> benötigt, um mit diesen
    Formaten umgehen zu können. <acronym>GD</acronym>-Versionen älter als
-   gd-1.6 unterstützen GIF, aber kein PNG. Neuere Versionen als gd-1.6 und
-   ältere als gd-2.0.28 unterstützen PNG, aber kein GIF. In gd-2.0.28 gibt
-   es erstmals wieder Unterstützung für GIF.
+   gd-1.6 unterstützen <acronym>GIF</acronym>, aber kein <acronym>PNG</acronym>.
+   Neuere Versionen als gd-1.6 und ältere als gd-2.0.28 unterstützen
+   <acronym>PNG</acronym>, aber kein <acronym>GIF</acronym>. In gd-2.0.28 gibt
+   es erstmals wieder Unterstützung für <acronym>GIF</acronym>.
    <note>
     <simpara>
-     Seit PHP 4.3 ist eine Version der GD-Bibliothek in PHP enthalten.
+     Seit PHP 4.3 ist eine Version der <acronym>GD</acronym>-Bibliothek in PHP enthalten.
      Diese gebündelte Version bietet zusätzliche Möglichkeiten, wie z.B.
      alpha blending und sollte der externen Version immer vorgezogen werden
      (der Code wird besser betreut und ist stabiler).
     </simpara>
    </note>
   </para>
+  <!-- FIXME PHP_6 FIXME
   <note>
    <para>
     Mit PHP 6.0.0 wurde die Unterstützung von GD 1.x eingestellt; es wird
     eine Bibliothek ab Version 2.0.33 benötigt.
    </para>
   </note>
+  -->
   <para>
-   Sie können GD erweitern, um mehr Grafikformate zu verwenden.
+   Sie können <acronym>GD</acronym> erweitern, um mehr Grafikformate zu verwenden.
    <table>
    <title>Unterstützte Grafikformate</title>
     <tgroup cols="3">
@@ -54,29 +57,30 @@
        <entry></entry>
        <entry>
         Wird nur von GD-Versionen älter als gd-1.6 und neuer als gd-2.0.28
-        unterstützt. <emphasis>Nur-lesende</emphasis> Unterstützung von GIF
-        gibt es ab PHP 4.3.0 und der gebündelten GD-Version.
+        unterstützt. <emphasis>Nur-lesende</emphasis> Unterstützung von
+        <acronym>GIF</acronym> gibt es ab PHP 4.3.0 und der gebündelten
+        <acronym>GD</acronym>-Version.
         <emphasis>Schreibende</emphasis> Unterstützung steht ab den
         Versionen PHP 4.3.9 und PHP 5.0.1 zur Verfügung.
        </entry>
       </row>
       <row>
-       <entry><literal>jpeg-6b</literal></entry>
+       <entry><literal>jpeg</literal></entry>
        <entry><link xlink:href="&url.jpeg;">&url.jpeg;</link></entry>
        <entry>
-        Wenn Sie die jpeg-v6b library übersetzen (vor dem Übersetzen
-        von PHP), müssen Sie die <option
-        role="configure">--enable-shared</option>-Option im
-        configure-Schritt benutzen. Wenn Sie dies nicht tun, werden
-        Sie den Felder <literal>libjpeg.(a|so) not found</literal>
-        beim configure-Schritt der PHP-Übersetzung erhalten.
+        Wenn Sie die jpeg-Bibliothek übersetzen (vor dem Übersetzen
+        von PHP), müssen Sie die Option
+        <option role="configure">--enable-shared</option>im configure-Schritt
+        benutzen. Wenn Sie dies nicht tun, werden Sie den Fehler
+        <literal>libjpeg.(a|so) not found</literal> beim configure-Schritt der
+        PHP-Übersetzung erhalten.
        </entry>
       </row>
       <row>
        <entry><literal>png</literal></entry>
        <entry><link xlink:href="&url.libpng;">&url.libpng;</link></entry>
        <entry>
-        Nur von GD-Versionen neuer als gd-1.6 unterstützt.
+        Nur von <acronym>GD</acronym>-Versionen neuer als gd-1.6 unterstützt.
        </entry>
       </row>
       <row>
@@ -91,9 +95,10 @@
     </tgroup>
    </table>
   </para>
+
   <para>
-   Sie können GD erweitern, um unterschiedliche Schriften zu verwenden. Die
-   folgenden Schriftbibliotheken werden unterstützt.
+   Sie können <acronym>GD</acronym> erweitern, um unterschiedliche Schriften zu
+   verwenden. Die folgenden Schriftbibliotheken werden unterstützt.
    <table>
    <title>Unterstützte Schriftbibliotheken</title>
     <tgroup cols="3">
@@ -108,7 +113,7 @@
       <row>
        <entry><literal>FreeType 1.x</literal></entry>
        <entry><link xlink:href="&url.freetype;">&url.freetype;</link></entry>
-       <entry>Unterstützung mit PHP 6.0.0 eingestellt</entry>
+       <entry>&removed.php.future;</entry>
       </row>
       <row>
        <entry><literal>FreeType 2</literal></entry>