[PHP-DOC] cvs: phpdoc /de/functions image.xml From: Martin Kraemer (Martin.Kraemer <email protected>)
Date: 10/19/00

martin Thu Oct 19 05:46:19 2000 EDT

  Modified files:
    /phpdoc/de/functions image.xml
  Log:
  Add imagegif() portability example from english page
  
Index: phpdoc/de/functions/image.xml
diff -u phpdoc/de/functions/image.xml:1.18 phpdoc/de/functions/image.xml:1.19
--- phpdoc/de/functions/image.xml:1.18 Wed Oct 18 13:00:24 2000
+++ phpdoc/de/functions/image.xml Thu Oct 19 05:46:19 2000
@@ -10,7 +10,7 @@
     Sie können die Grafik-Funktionen von PHP nicht nur benutzen, um
     die Grösse von <acronym>JPEG</acronym>, <acronym>GIF</acronym>,
     <acronym>PNG</acronym> und <acronym>SWF</acronym>-Bild-Dateien zu
- ermitteln, sondern auch - sofern sie die
+ ermitteln, sondern auch - sofern Sie die
     <acronym>GD</acronym>-Bibliothek (verfügbar unter <ulink
     url="&url.gd;">&url.gd;</ulink>) eingebunden haben - Grafiken
     bzw. Bilder dynamisch (also zur Laufzeit ihres Skripts) erzeugen
@@ -23,18 +23,18 @@
     danach unterstützen zwar das PNG- aber nicht mehr das GIF-Format.
    </simpara>
    <simpara>
- Um JPEG-Grafiken lesen und schreiben zu können, benötigen sie
+ Um JPEG-Grafiken lesen und schreiben zu können, benötigen Sie
     jpeg-6b (siehe unter <ulink url="&url.jpeg;">&url.jpeg;</ulink>).
- Anschließend müssen sie gd neu compilieren mit
+ Anschließend müssen Sie gd neu compilieren mit
     <option role="configure">--with-jpeg-dir=/path/to/jpeg-6b</option>.
     Danach muss auch PHP mit der Option
     <option role="configure">--with-jpeg-dir=/path/to/jpeg-6b</option>
     nue compiliert werden.
    </simpara>
    <simpara>
- Die Unterstützung von Type-1-Fonts können sie mit der Installation
+ Die Unterstützung von Type-1-Fonts können Sie mit der Installation
     von t1lib (siehe unter<ulink url="&url.t1lib;">&url.t1lib;</ulink>)
- einbinden. Beim Compilieren müssen sie dann noch die Option
+ einbinden. Beim Compilieren müssen Sie dann noch die Option
     <option role="configure">--with-t1lib[=dir]</option> angeben.
    </simpara>
   </partintro>
@@ -59,7 +59,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Mit <function>GetImageSize</function> ermitteln sie die Daten
+ Mit <function>GetImageSize</function> ermitteln Sie die Daten
      jeder <acronym>GIF</acronym>-, <acronym>JPG</acronym>-,
      <acronym>PNG</acronym> oder <acronym>SWF</acronym>-Datei. Es
      werden die Ausmaße in Abhängigkeit vom Grafik-Typ sowie die Höhe
@@ -84,7 +84,7 @@
     </para>
     <para>
      Mit dem optionalen <parameter>imageinfo</parameter>-Parameter
- können sie weitere Informationen der Grafik-Datei auslesen.
+ können Sie weitere Informationen der Grafik-Datei auslesen.
      Z.Zt. unterstützt dies die verschiedenen <acronym>JPG</acronym>
      APP-Markierungen per assoziativem Array. Einige Programme nutzen
      diese Markierungen, um Text in diese Grafiken einzubinden.
@@ -141,7 +141,7 @@
      <parameter>W</parameter> und <parameter>h</parameter> benennen
      die Breite und Höhe der Ellipse, <parameter>s</parameter> und
      <parameter>e</parameter> den Start- bzw. Endwinkel des Bogens in
- Grad. Mit <parameter>col</parameter> bestimmen sie die Farbe der
+ Grad. Mit <parameter>col</parameter> bestimmen Sie die Farbe der
      Ellipse.
     </para>
    </refsect1>
@@ -180,7 +180,7 @@
      Nummer, desto grösser der Font).
     </para>
     <para>
- Beachten sie auch <function>imageloadfont</function>.
+ Beachten Sie auch <function>imageloadfont</function>.
     </para>
    </refsect1>
   </refentry>
@@ -218,7 +218,7 @@
      Nummer, desto grösser der Font).
     </para>
     <para>
- Beachten sie auch <function>imageloadfont</function>.
+ Beachten Sie auch <function>imageloadfont</function>.
     </para>
    </refsect1>
   </refentry>
@@ -278,7 +278,7 @@
      <parameter>im</parameter> bestimmten Grafik.
     </para>
     <para>
- Beachten sie auch <function>imagecolorset</function> und
+ Beachten Sie auch <function>imagecolorset</function> und
      <function>imagecolorsforindex</function>.
     </para>
    </refsect1>
@@ -431,7 +431,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Hierdurch setzen sie den Farbwert der Palette auf die angegebene
+ Hierdurch setzen Sie den Farbwert der Palette auf die angegebene
      Farbe. Dies ist nützlich bei Aktionen wie "Fülle Farbe X mit
      Farbe Y" (Flood-Fill-Effekt) ohne den sonst notwendigen Aufwand
      für solche Aktionen betreiben zu müssen.
@@ -695,7 +695,7 @@
      <para>
       ACHTUNG: Ab Version 1.6 wurde die komplette GIF-Unterstützung
       aus der GD-Bibliothek entfernt. Diese Funktion ist also nur
- verfügbar, wenn sie eine Version vor 1.6 verwenden.
+ verfügbar, wenn Sie eine Version vor 1.6 verwenden.
      </para>
     </note>
    </refsect1>
@@ -1067,13 +1067,13 @@
     <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
+ 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 Ergebniss der <function>imagecreate</function>-Funktion.
+ das Ergebnis der <function>imagecreate</function>-Funktion.
     </para>
     <para>
- Das Format wird <acronym>GIF87a</acronym> sein, es sei denn, sie
+ 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.
@@ -1082,15 +1082,65 @@
      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
+ "image/gif" können Sie PHP-Skripte erstellen, welche die
      <acronym>GIF</acronym>-Ausgabe direkt vornehmen.
      <note>
       <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.
+ verfügbar, wenn Sie eine Version vor 1.6 verwenden.
       </para>
+ <para>
+ Um trotzdem portable PHP-Anwendungen schreiben zu k&ouml;nnen,
+ kann mit folgendem Codest&uuml;ck automatisch gepr&uuml;ft werden,
+ welches Bildformat in der mitgebundenen GD-Bibliothek
+ nutzbar ist. Ersetzen Sie hierf&uuml;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("No image support in this PHP server");
+?&gt;
+ </programlisting>
+ </informalexample>
+ </para>
      </note>
+ <note>
+ <para>
+ In PHP4 ab Version 4.0.2 haben Sie alternativ zum Test
+ per <function>function_exists</function> auch die
+ M&ouml;glichkeit, mit der
+ <function>imagetypes</function>-Funktion
+ die unterst&uuml;tzten Bildformate abzutesten.
+ <informalexample>
+ <programlisting role="php">
+if (ImageTypes() &amp; IMG_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>
@@ -1127,18 +1177,22 @@
      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
+ 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
+ "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
+ 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>
 
@@ -1163,10 +1217,10 @@
     <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
+ 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 Ergebniss der <function>imagecreate</function>-Funktion.
+ das Ergebnis der <function>imagecreate</function>-Funktion.
      <informalexample>
       <programlisting role="php">
 &lt;?php
@@ -1180,16 +1234,20 @@
      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
+ "image/png" können Sie PHP-Skripte erstellen, welche die
      <acronym>PNG</acronym>-Ausgabe direkt vornehmen.
      <note>
       <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.
+ verfügbar, wenn Sie eine Version ab 1.6 verwenden.
       </para>
      </note>
     </para>
+ <para>
+ Siehe auch <function>imagegif</function>,
+ <function>imagejpeg</function>, <function>imagetypes</function>.
+ </para>
    </refsect1>
   </refentry>
 
@@ -1212,12 +1270,12 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Mit der Funktion <function>imageInterlace</function> setzen sie
+ Mit der Funktion <function>imageInterlace</function> setzen Sie
      das Bit für die interlaced-Darstellung eines Bildes auf An (1)
      oder Aus (0).
     </para>
     <para>
- Als Rückgabewert erhalten sie die aktuelle Einstellung des
+ Als Rückgabewert erhalten Sie die aktuelle Einstellung des
      Interlaced-Modus.
     </para>
    </refsect1>
@@ -1279,7 +1337,7 @@
     <para>
      Das Font-Datei-Format unterliegt binären Abhängigkeiten und
      ist von Rechner-Typ zu Rechner-Typ unterschiedlich. Das
- bedeutet, dass sie die Font-Dateien immer auf dem Rechner-Typ
+ bedeutet, dass Sie die Font-Dateien immer auf dem Rechner-Typ
      erzeugen müssen, auf dem diese Verwendung finden.
     </para>
     <para>
@@ -1355,7 +1413,7 @@
     <para>
      <function>ImagePolygon</function> erzeugt ein Vieleck innerhalb
      von <parameter>im</parameter>. <parameter>Points</parameter>
- ist ein PHP-Array, dass die Werte für die Eckpunkte des Polygons
+ ist ein PHP-Array, das die Werte für die Eckpunkte des Polygons
      enthält, z.B. Points[0] = x0, Points[1] = y0, Points[2]
      = x1, Points[3] = y1 usw. <parameter>Num_points</parameter>
      enthält die Gesamtzahl an Points (Points[n]).
@@ -1373,7 +1431,7 @@
     <refpurpose>
      Ermittelt die Ausmaße des Rechtecks, das für die Ausgabe eines
      Textes unter Verwendung eines PostScript-Fonts (Typ 1) notwendig
- ist
+ ist.
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1421,7 +1479,7 @@
      Das umgebende Rechteck wird berechnet unter Verwendung der für
      die Zeichen-Abmessungen verfügbaren Informationen und
      unterscheidet sich immer etwas von den aktuellen Raster-Werten
- des Textes. Ist der Winkel (angle) mit 0 angegeben, können sie
+ des Textes. Ist der Winkel (angle) mit 0 angegeben, können Sie
      davon ausgehen, dass der Text in jede Richtung immer 1 Pixel
      mehr braucht als sonst.
     </para>
@@ -1479,23 +1537,23 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Falls sie Veränderungen an einem Font (Größe, Dicke usw.)
+ Falls Sie Veränderungen an einem Font (Größe, Dicke usw.)
      vornehmen wollen, den ursprüglichen Font aber noch brauchen,
- sollten sie diese Funktion benutzen. Der zu kopierende Font
+ sollten Sie diese Funktion benutzen. Der zu kopierende Font
      muss über die Funktion <function>ImagePSLoadFont</function>
- vorher geladen worden sein. Eine Kopie dieses Fonts können sie
- nicht verwende. Sie können aber bereits vor dem Kopieren
+ vorher geladen worden sein. Eine Kopie dieses Fonts können Sie
+ nicht verwenden. Sie können aber bereits vor dem Kopieren
      Veränderungen vornehmen.
     </para>
     <para>
- Falls sie diese Funkton benutzen, <emphasis>müssen</emphasis>
- sie die so erzeugten Fonts selbst freigeben und zwar in
+ Falls Sie diese Funkton benutzen, <emphasis>müssen</emphasis>
+ Sie die so erzeugten Fonts selbst freigeben und zwar in
      umgekehrter Reihenfolge, ansonsten <emphasis>wird</emphasis>
      ihr Skript 'hängen'.
     </para>
     <para>
      Falls alles klappt, wird ihnen ein gültiger Font-Index zurück
- gegeben, den sie weiter verwenden können. Falls nicht, wird
+ gegeben, den Sie weiter verwenden können. Falls nicht, wird
      false zurück und eine Fehlermeldung ausgegeben.
     </para>
     <para>
@@ -1523,15 +1581,15 @@
     <para>
      Lädt einen Zeichen-Beschreibungs-Vektor aus einer Datei und
      verändert die Vektor-Beschreibung des Fonts. Da ein PS-Font
- meist Lücken oberhalb des 127. Zeichens aufweist, werden sie
- dies oft anpassen wollen, sofern sie eine andere Sprache als
+ meist Lücken oberhalb des 127. Zeichens aufweist, werden Sie
+ dies oft anpassen wollen, sofern Sie eine andere Sprache als
      Englisch benutzen. Das genaue Dateiformat ist in der
      Dokumentation zu T1Lib beschrieben. T1Lib wird mit zwei
      gebrauchsfertigen Beschreibungsdateien (IsoLatin1.enc und
      IsoLatin2.enc) ausgeliefert.
     </para>
     <para>
- Sollten sie diese Funktion ständig benutzen, ist es besser,
+ Sollten Sie diese Funktion ständig benutzen, ist es besser,
      diese Beschreibungs-Datei innerhalb der
      <link linkend="configuration.file">Konfigurations-Datei</link>
      bei ps.default_encoding anzugeben. Dadurch wird immer die
@@ -1603,7 +1661,7 @@
     </funcsynopsis>
     <para>
      Wenn alles in Ordnung ist, wird ein gültiger Zeiger (Index)
- zurück gegeben, auf den sie immer wieder zurück greifen können;
+ zurück gegeben, auf den Sie immer wieder zurück greifen können;
      ansonsten wird false zurück und eine Fehlermeldung ausgegeben.
     </para>
     <para>
@@ -1694,9 +1752,9 @@
      Ecke). Dies ist anders als bei der
      <function>ImageString</function>-Funktion, wo
      <parameter>x</parameter> und <parameter>y</parameter> die obere
- linke Ecke des ersten Zeichens angeben. Lesen sie in der
+ linke Ecke des ersten Zeichens angeben. Lesen Sie in der
      Dokumentation zu PostScript und seines Maßsystems nach, falls
- sie die Funktionsweise nicht verstehen.
+ Sie die Funktionsweise nicht verstehen.
     </para>
     <para>
      <parameter>Space</parameter> ermöglicht ihnen, die Vorgabe des
@@ -2097,14 +2155,14 @@
     </para>
     <para>
      <parameter>Fontfile</parameter> ist der Pfad zur TTF-Datei, die
- sie verwenden wollen.
+ Sie verwenden wollen.
     </para>
     <para>
      <parameter>Text</parameter> ist der auszugebende String, der
      auch UTF-8-Zeichenfolgen enthalten darf (z.B. &amp;#123;)
     </para>
     <para>
- <parameter>Col</parameter> ist der Farbindex. Verwenden sie den
+ <parameter>Col</parameter> ist der Farbindex. Verwenden Sie den
      negativen Index-Wert, führt das zum Aufheben des Farbüberlaufs
      (Antialiasing).
     </para>
@@ -2166,7 +2224,7 @@
      der in der aktuellen PHP-Kompilation enthaltenen GD-Version
      unterstützten Grafik-Formate dar. Die folgenden Bit-Werte sind
      möglich: IMG_GIF, IMG_JPG, IMG_PNG oder IMG_WBMP. Um das Vorhanden
- sein der GD-Unterstützung zu testen, können sie folgendes machen:
+ sein der GD-Unterstützung zu testen, können Sie folgendes machen:
      <example>
       <title>ImageTypes</title>
       <programlisting role="php">
@@ -2204,7 +2262,7 @@
      häufig in JPEG-Grafiken enthalten, die mit einer Digital-Kamera
      aufgenommen wurden. Jeder Aufnehmende hat aber andere
      Vorstellungen über die Daten einer JPEG-Grafik. Diese Unterschiede
- können sie mit dieser Funktion ermitteln.
+ können Sie mit dieser Funktion ermitteln.
      <example>
       <title>read_exif_data</title>
       <programlisting role="php">
@@ -2242,7 +2300,7 @@
     <para>
      <note>
       <simpara>
- Diese Funktion ist in PHP4 nur verfügbar, wenn sie es mit
+ Diese Funktion ist in PHP4 nur verfügbar, wenn Sie es mit
        --enable-exif compiliert haben.
       </simpara>
       <simpara>