File: image.xml

package info (click to toggle)
phpdoc 20020310-1
links: PTS
area: main
in suites: woody
size: 35,272 kB
ctags: 354
sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (2202 lines) | stat: -rw-r--r-- 81,285 bytes
<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.image">
  <title>Grafik-Funktionen</title>
  <titleabbrev>Grafiken</titleabbrev>
  <!-- Anmerkung des bersetzers:
       entspricht en/functions/image.xml 1.26 -->


  <partintro>
   <simpara>
    Sie knnen die Grafik-Funktionen von PHP nicht nur benutzen, um
    die Grsse von <acronym>JPEG</acronym>, <acronym>GIF</acronym>,
    <acronym>PNG</acronym> und <acronym>SWF</acronym>-Bild-Dateien zu
    ermitteln, sondern auch - sofern Sie die
    <acronym>GD</acronym>-Bibliothek (verfgbar unter <ulink
    url="&url.gd;">&url.gd;</ulink>) eingebunden haben - Grafiken
    bzw. Bilder dynamisch (also zur Laufzeit ihres Skripts) erzeugen
    bzw. verndern.
   </simpara>
   <simpara>
    Die mittels dieser Funktionen vernderbaren Grafik-Formate sind
    abhngig von der bei ihnen installierten GD-Version. Versionen vor
    gd-1.6 untersttzen das GIF- aber kein PNG-Format. Die Versionen
    danach untersttzen zwar das PNG- aber nicht mehr das GIF-Format.
   </simpara>
   <simpara>
    Um JPEG-Grafiken lesen und schreiben zu knnen, bentigen Sie 
    jpeg-6b (siehe unter <ulink url="&url.jpeg;">&url.jpeg;</ulink>).
    Anschlieend mssen 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>
    neu compiliert werden.
   </simpara>
   <simpara>
    Die Untersttzung von Type-1-Fonts knnen Sie mit der Installation
    von t1lib (siehe unter<ulink url="&url.t1lib;">&url.t1lib;</ulink>)
    einbinden. Beim Compilieren mssen Sie dann noch die Option
    <option role="configure">--with-t1lib[=dir]</option> angeben.
   </simpara>
  </partintro>

  <refentry id="function.getimagesize">
   <refnamediv>
    <refname>GetImageSize</refname>
    <refpurpose>
     Ermittelt die Ausmae einer GIF-, JPEG-, PNG- oder 
     SWF-Grafik-Datei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>getimagesize</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>imageinfo</parameter></methodparam>
     </methodsynopsis>
    <para>
     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 Ausmae in Abhngigkeit vom Grafik-Typ sowie die Hhe
     und Breite als <emphasis>ein</emphasis> String
     zurckgegeben. Dieser kann innerhalb eines regulren
     <acronym>HTML</acronym> <sgmltag>IMG</sgmltag>-Tags verwendet
     werden.
    </para>
    <para>
     Es wird ein Array aus 4 Elementen zurck gegeben. Im Array-Index
     0 steht die Breite. Index 1 enthlt die Hhe, 2 ein Flag je nach
     Grafik-Typ (1 = GIF, 2 = JPG, 3 = PNG, SWF = 4) und Index 3 die
     richtige Zeichenkette im Format "height=xxx width=xxx" zur
     Verwendung im IMG-Tag von HTML.
     <example>
      <title>Grafik-Ausmae ermitteln per GetImageSize:</title>
      <programlisting role="php">
&lt;?php $size = GetImageSize ("img/flag.jpg"); ?>
&lt;IMG SRC="img/flag.jpg" &lt;?php echo $size[3]; ?>
      </programlisting>
     </example>
    </para>
    <para>
     Mit dem optionalen <parameter>imageinfo</parameter>-Parameter
     knnen Sie weitere Informationen der Grafik-Datei auslesen.
     Z.Zt. untersttzt dies die verschiedenen <acronym>JPG</acronym>
     APP-Markierungen per assoziativem Array. Einige Programme nutzen
     diese Markierungen, um Text in diese Grafiken einzubinden.
     Gebruchlich ist die Einbettung von <acronym>IPTC</acronym>
     <ulink url="&url.iptc;">&url.iptc;</ulink> Informationen in die
     APP13-Marke. Sie knnen <function>iptcparse</function> benutzen,
     um die binre APP13-Marke in ein lesbares Format zu bertragen.
     <example>
      <title>GetImageSize mit IPTC-Informationen</title>
      <programlisting>
&lt;?php 
    $size = GetImageSize ("testimg.jpg",&amp;$info);
    if (isset ($info["APP13"])) {
        $iptc = iptcparse ($info["APP13"]);
        var_dump ($iptc);
    }
?>
      </programlisting>
     </example>
     <note>
      <simpara>
       Dieser Befehl funktioniert auch ohne GD-Bibliothek.
      </simpara>
     </note>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagearc">
   <refnamediv>
    <refname>ImageArc</refname>
    <refpurpose>Zeichnen einer Teil-Ellipse</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagearc</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>cx</parameter></methodparam>
      <methodparam><type>int</type><parameter>cy</parameter></methodparam>
      <methodparam><type>int</type><parameter>w</parameter></methodparam>
      <methodparam><type>int</type><parameter>h</parameter></methodparam>
      <methodparam><type>int</type><parameter>s</parameter></methodparam>
      <methodparam><type>int</type><parameter>e</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageArc</function> zeichnet den Teil einer Ellipse
     mit Mittelpunkt bei <parameter>cx</parameter> und 
     <parameter>cy</parameter> (oben links ist 0, 0) in dem durch den
     <parameter>im</parameter>-Handle definiertem Bild.
     <parameter>W</parameter> und <parameter>h</parameter> benennen
     die Breite und Hhe 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
     Ellipse.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagechar">
   <refnamediv>
    <refname>ImageChar</refname>
    <refpurpose>
     Stellt ein Zeichen mit horizontaler Ausrichtung dar
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagechar</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>font</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam><type>string</type><parameter>c</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageChar</function> zeichnet das erste Zeichen
     (Charakter) des Strings <parameter>c</parameter> in das Bild,
     auf das per <parameter>id</parameter> gezeigt wird. Die linke
     obere Ecke des Zeichens wird durch <parameter>x</parameter> /
     <parameter>y</parameter> bestimmt. Dabei wird von den
     Koordinaten 0 / 0 als Zeichnungsanfang links-oben ausgegangen.
     Die Farbe des Zeichens wird mit <parameter>col</parameter>
     bestimmt. Ist <parameter>font</parameter> als 1, 2, 3, 4 oder 5
     definiert, wird ein eingebauter Font genutzt (je grsser die
     Nummer, desto grsser der Font).
    </para>
    <para>
     Beachten Sie auch <function>imageloadfont</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecharup">
   <refnamediv>
    <refname>ImageCharUp</refname>
    <refpurpose>
     Zeichnet einen vertikal ausgerichteten Charakter
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecharup</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>font</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam><type>string</type><parameter>c</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para> 
     <function>ImageCharUp</function> zeichnet das erste Zeichen
     (Charakter) des Strings <parameter>c</parameter> in das Bild,
     auf das per <parameter>id</parameter> gezeigt wird. Die
     Koordinaten des Zeichens werden durch <parameter>x</parameter> /
     <parameter>y</parameter> bestimmt. Dabei wird von den
     Koordinaten 0 / 0 als Zeichnungsanfang links-oben ausgegangen.
     Die Farbe des Zeichens wird mit <parameter>col</parameter>
     bestimmt. Ist <parameter>font</parameter> als 1, 2, 3, 4 oder 5
     definiert, wird ein eingebauter Font genutzt (je grsser die
     Nummer, desto grsser der Font).
    </para>
    <para>    
     Beachten Sie auch <function>imageloadfont</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolorallocate">
   <refnamediv>
    <refname>ImageColorAllocate</refname>
    <refpurpose>Bestimmt die Farbe einer Grafik</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecolorallocate</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>red</parameter></methodparam>
      <methodparam><type>int</type><parameter>green</parameter></methodparam>
      <methodparam><type>int</type><parameter>blue</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageColorAllocate</function> gibt eine Farb-ID, die
     durch die angegebenen <acronym>RGB</acronym>-Werte bestimmt
     wird, zurck. Der Parameter <parameter>im</parameter> wird ihnen
     von der <function>imagecreate</function>-Funktion zurck gegeben.
     <function>ImageColorAllocate</function> muss fr jede Farbe
     aufgerufen werden, die innerhalb der Grafik
     <parameter>im</parameter> verwendet werden soll.
     <informalexample>
      <programlisting role="php">
$weiss   = ImageColorAllocate ($im, 255, 255, 255);
$schwarz = ImageColorAllocate ($im, 0, 0, 0);
      </programlisting>
     </informalexample>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolorat">
   <refnamediv>
    <refname>ImageColorAt</refname>
    <refpurpose>Ermittelt den Farbwert eines Bildpunktes</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecolorat</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ermittelt den Farb-Wert eines Pixels an den Koordinaten
     <parameter>x</parameter> / <parameter>y</parameter> der mit
     <parameter>im</parameter> bestimmten Grafik.
    </para>
    <para>
     Beachten Sie auch <function>imagecolorset</function> und
     <function>imagecolorsforindex</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolorclosest">
   <refnamediv>
    <refname>ImageColorClosest</refname>
    <refpurpose>
     Ermittelt den Farbwert-Index, der den angegebenen Farben
     am nchsten liegt
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecolorclosest</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>red</parameter></methodparam>
      <methodparam><type>int</type><parameter>green</parameter></methodparam>
      <methodparam><type>int</type><parameter>blue</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den Index der Farbwert-Palette des Bildes 
     <parameter>im</parameter> zurck, der den angegebenen
     <acronym>RGB</acronym>-Werten am nchsten kommt.
    </para>
    <para>
     Die "Entfernung" zwischen der angeforderten Farbe und jedem
     Farb-Paletten-Wert wird berechnet, als ob die angegebenen
     <acronym>RGB</acronym>-Werte Punkte in einem dreidimensionalen
     Raum darstellen.
    </para>
    <para>
     Siehe auch <function>imagecolorexact</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolordeallocate">
   <refnamediv>
    <refname>ImageColorDeAllocate</refname>
    <refpurpose>Lscht eine Farbdefinition</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecolordeallocate</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>index</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>ImageColorDeAllocate</function> lscht
     eine vorher ber <function>ImageColorAllocate</function>
     ermittelte Farbe.
     <informalexample>
      <programlisting role="php">
$weiss = ImageColorAllocate($im, 255, 255, 255);
ImageColorDeAllocate($im, $weiss);
      </programlisting>
     </informalexample>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolorexact">
   <refnamediv>
    <refname>ImageColorExact</refname>
    <refpurpose>
     Ermittelt den Index-Wert der angegebenen Farbe                  
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecolorexact</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>red</parameter></methodparam>
      <methodparam><type>int</type><parameter>green</parameter></methodparam>
      <methodparam><type>int</type><parameter>blue</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den Index der angegebenen Farbe in der Farb-Palette des
     Bildes <parameter>im</parameter> zurck.
    </para>
    <para>
     Existiert die Farbe in der Bild-Farb-Palette nicht, wird -1
     zurck gegeben.
    </para>
    <para>
     Siehe auch <function>imagecolorclosest</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolorresolve">
   <refnamediv>
    <refname>ImageColorResolve</refname>
    <refpurpose>
     Ermittelt den Index-Wert der angegebenen Farbe oder die
     nchst mgliche Alternative dazu
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecolorresolve</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>red</parameter></methodparam>
      <methodparam><type>int</type><parameter>green</parameter></methodparam>
      <methodparam><type>int</type><parameter>blue</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion ermittelt garantiert einen Farb-Index zu der
     angegebenen Farbe, nmlich entweder den exakten oder den
     nchst mglichen Wert.
    </para>
    <para>
     Siehe auch <function>imagecolorclosest</function> und
     <function>imagecolorexact</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolorset">
   <refnamediv>
    <refname>ImageColorSet</refname>
    <refpurpose>
     Setzt die Farbe fr den angegebenen Paletten-Index
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>bool</type><methodname>imagecolorset</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>index</parameter></methodparam>
      <methodparam><type>int</type><parameter>red</parameter></methodparam>
      <methodparam><type>int</type><parameter>green</parameter></methodparam>
      <methodparam><type>int</type><parameter>blue</parameter></methodparam>
     </methodsynopsis>
    <para>
     Hierdurch setzen Sie den Farbwert der Palette auf die angegebene
     Farbe. Dies ist ntzlich bei Aktionen wie "Flle Farbe X mit
     Farbe Y" (Flood-Fill-Effekt) ohne den sonst notwendigen Aufwand
     fr solche Aktionen betreiben zu mssen.
    </para>
    <para>
     Siehe auch <function>imagecolorat</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolorsforindex">
   <refnamediv>
    <refname>ImageColorsForIndex</refname>
    <refpurpose>
     Ermittelt die Farbwerte einer angegebenen Farb-Palette
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>imagecolorsforindex</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>index</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt ein assoziatives Array mit Rot-, Grn- und Blau-Werten
     zurck, die die Werte des Farb-Paletten-Index von
     <parameter>im</parameter> darstellen.
    </para>
    <para>
     Siehe auch <function>imagecolorat</function> und
     <function>imagecolorexact</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolorstotal">
   <refnamediv>
    <refname>ImageColorsTotal</refname>
    <refpurpose>
     Ermittelt die Anzahl der definierten Farben eines Bildes
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecolorstotal</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ergibt die Anzahl der Farben der Palette des angegebenen
     Bildes <parameter>im</parameter>.
    </para>
    <para>
     Siehe auch <function>imagecolorat</function> und
     <function>imagecolorsforindex</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecolortransparent">
   <refnamediv>
    <refname>ImageColorTransparent</refname>
    <refpurpose>Definiert eine Farbe als transparent</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecolortransparent</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageColorTransparent</function> setzt die
     transparente Farbe des Bildes <parameter>im</parameter> auf die
     Farbe <parameter>col</parameter>. <parameter>Im</parameter> ist
     der Bild-Pointer, der von <function>ImageCreate</function>
     zurck gegeben wird und <parameter>col</parameter> ist ein
     Zeiger auf die Farbe, die von
     <function>ImageColorAllocate</function> ermittelt wird.
    </para>
    <para>
     Es wird ein Zeiger auf die neue - jetzt transparente - Farbe
     (oder die aktuelle, falls keine Farbe angegeben wurde) zurck
     gegeben.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecopy">
   <refnamediv>
    <refname>ImageCopy</refname>
    <refpurpose>Kopiert einen Bildausschnitt</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ImageCopy</methodname>
      <methodparam><type>int</type><parameter>dst_im</parameter></methodparam>
      <methodparam><type>int</type><parameter>src_im</parameter></methodparam>
      <methodparam><type>int</type><parameter>dst_x</parameter></methodparam>
      <methodparam><type>int</type><parameter>dst_y</parameter></methodparam>
      <methodparam><type>int</type><parameter>src_x</parameter></methodparam>
      <methodparam><type>int</type><parameter>src_y</parameter></methodparam>
      <methodparam><type>int</type><parameter>src_w</parameter></methodparam>
      <methodparam><type>int</type><parameter>src_h</parameter></methodparam>
     </methodsynopsis>
    <para>
     Kopiert einen Teil des Quellbildes <parameter>src_im</parameter>
     nach <parameter>dst_im</parameter>. Der zu kopierende Teil wird
     angegeben ber die x/y-Koordinaten <parameter>src_x</parameter>
     und <parameter>src_y</parameter>. Die Breite wird in<parameter>
     src_w</parameter> und die Hhe in <parameter>src_h</parameter>
     angegeben. Der Ausschnitt wird an die x/y-Koordinaten<parameter>
     dst_x</parameter> und <parameter>dst_y</parameter> kopiert.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecopyresized">
   <refnamediv>
    <refname>ImageCopyResized</refname>
    <refpurpose>
     Kopieren und ndern der Grsse eines Bild-Teiles
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecopyresized</methodname>
      <methodparam><type>int</type><parameter>dst_im</parameter></methodparam>
      <methodparam><type>int</type><parameter>src_im</parameter></methodparam>
      <methodparam><type>int</type><parameter>dstX</parameter></methodparam>
      <methodparam><type>int</type><parameter>dstY</parameter></methodparam>
      <methodparam><type>int</type><parameter>srcX</parameter></methodparam>
      <methodparam><type>int</type><parameter>srcY</parameter></methodparam>
      <methodparam><type>int</type><parameter>dstW</parameter></methodparam>
      <methodparam><type>int</type><parameter>dstH</parameter></methodparam>
      <methodparam><type>int</type><parameter>srcW</parameter></methodparam>
      <methodparam><type>int</type><parameter>srcH</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageCopyResized</function> kopiert einen rechteckigen
     Ausschnitt eines Bildes in ein anderes.
     <parameter>Dst_im</parameter> gibt das Zielbild,
     <parameter>src_im</parameter> die Bildquelle an. Unterscheiden
     sich die Angaben der Quelle und des Ziels bezogen auf die
     Koordinaten, Hhe oder Breite, wird das Teilbild entsprechend
     gedehnt oder geschrumpft. Die Koordinaten beziehen sich auf die
     linke obere Ecke. Sie knnen hiermit auch Teilbilder innerhalb
     ein- und desselben Bildes kopieren, sofern
     <parameter>dst_im</parameter> und <parameter>src_im</parameter>
     gleich sind. Falls sich dabei aber die kopierten Teile
     berlappen, fhrt das zu unvorhersehbaren Ergebnissen.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecreate">
   <refnamediv>
    <refname>ImageCreate</refname>
    <refpurpose>Erzeugt ein neues Bild</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecreate</methodname>
      <methodparam><type>int</type><parameter>x_size</parameter></methodparam>
      <methodparam><type>int</type><parameter>y_size</parameter></methodparam>
     </methodsynopsis>
    <para> 
     <function>ImageCreate</function> gibt den Zeiger auf ein neues
     Bild zurck. Dieser Zeiger stellt ein leeres Bild mit der Gre
     <parameter>x_size</parameter> und <parameter>y_size</parameter>
     dar.
     <example>
      <title>
       Erzeugung eines neuen GD-Bild-Streams und Ausgabe des Bildes:
      </title>
      <programlisting role="php">
&lt;?php
header ("Content-type: image/png");
$im = @ImageCreate (50, 100)
      or die ("Kann keinen neuen GD-Bild-Stream erzeugen");
$background_color = ImageColorAllocate ($im, 255, 255, 255);
$text_color = ImageColorAllocate ($im, 233, 14, 91);
ImageString ($im, 1, 5, 5, "Ein Test-String", $text_color);
ImagePNG ($im);
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagecreatefromgif">
   <refnamediv>
    <refname>ImageCreateFromGIF</refname>
    <refpurpose>
     Erzeugt ein neues Bild im GIF-Format, welches aus einer Datei
     oder von einer URL gelesen wird
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecreatefromgif</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageCreateFromGIF</function> gibt den Bezeichner auf
     ein Bild zurck, der das aus der angegebenen Datei eingelesene
     Bild darstellt.
    </para>
    <para> 
     Im Fehlerfall gibt <function>ImageCreateFromGIF</function> eine
     leere Zeichenkette zurck. Zudem wird eine Fehlermeldung
     erzeugt, die im Browser als Verbindungsabbruch dargestellt wird.
     Zum besseren Debuggen wird das folgende Beispiel einen 
     GIF-Fehler erzeugen:
    </para>
    <example>
     <title>
      Beispiel, um die Handhabung eines Fehlers bei der Bilderzeugung
      zu sehen (Dank an vic@zymsys.com):
     </title>
     <programlisting role="php">
function LoadGif ($imgname) {
    $im = @ImageCreateFromGIF ($imgname); /* Versuch, Datei zu ffnen */
    if (!$im) {                           /* Prfen, ob fehlgeschlagen */
        $im = ImageCreate (150, 30);      /* Erzeugen eines leeren Bildes */
        $bgc = ImageColorAllocate ($im, 255, 255, 255);
        $tc  = ImageColorAllocate ($im, 0, 0, 0);
        ImageFilledRectangle ($im, 0, 0, 150, 30, $bgc); 
        /* Ausgabe einer Fehlermeldung */
        ImageString($im, 1, 5, 5, "Fehler beim ffnen von: $imgname", $tc); 
    }
    return $im;
}
     </programlisting>
    </example>
    <note>
     <para>
      ACHTUNG: Ab Version 1.6 wurde die komplette GIF-Untersttzung
      aus der GD-Bibliothek entfernt. Diese Funktion ist also nur
      verfgbar, wenn Sie eine Version vor 1.6 verwenden.
     </para>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.imagecreatefromjpeg">
   <refnamediv>
    <refname>ImageCreateFromJPEG</refname>
    <refpurpose>
     Erzeugt ein neues Bild im JPEG-Format, welches aus einer Datei
     oder von einer URL gelesen wird
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecreatefromjpeg</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageCreateFromJPEG</function> gibt den Bezeichner auf
     ein Bild zurck, der das aus der angegebenen Datei eingelesene
     Bild darstellt.
    </para>
    <para> 
     Im Fehlerfall gibt <function>ImageCreateFromJPEG</function> eine
     leere Zeichenkette zurck. Zudem wird eine Fehlermeldung erzeugt,
     die im Browser als Verbindungsabbruch dargestellt wird. Zum
     besseren Debuggen wird das folgende Beispiel einen JPEG-Fehler
     erzeugen:
    </para>
    <example>
     <title>
      Beispiel, um die Handhabung eines Fehlers bei der Bilderzeugung
      zu sehen (Dank an vic@zymsys.com):
     </title>
     <programlisting role="php">
function LoadJpeg ($imgname) {
    $im = @ImageCreateFromJPEG ($imgname); /* Versuch, Datei zu ffnen */
    if (!$im) {                            /* Prfen, ob fehlgeschlagen */
        $im = ImageCreate (150, 30);       /* Erzeugen eines leeren Bildes */
        $bgc = ImageColorAllocate ($im, 255, 255, 255);
        $tc  = ImageColorAllocate ($im, 0, 0, 0);
        ImageFilledRectangle ($im, 0, 0, 150, 30, $bgc); 
        /* Ausgabe einer Fehlermeldung */
        ImageString($im, 1, 5, 5, "Fehler beim ffnen von: $imgname", $tc); 
    }
    return $im;
}
     </programlisting>
    </example>
   </refsect1>
  </refentry>

  <refentry id="function.imagecreatefrompng">
   <refnamediv>
    <refname>ImageCreateFromPNG</refname>
    <refpurpose>
     Erzeugt ein neues Bild im PNG-Format, welches aus einer Datei
     oder von einer URL gelesen wird
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagecreatefrompng</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageCreateFromPNG</function> gibt den Bezeichner auf
     ein Bild zurck, der das aus der angegebenen Datei eingelesene
     Bild darstellt.
    </para>
    <para> 
     Im Fehlerfall gibt <function>ImageCreateFromPNG</function> eine
     leere Zeichenkette zurck. Zudem wird eine Fehlermeldung
     erzeugt, die im Browser als Verbindungsabbruch dargestellt wird.
     Zum besseren Debuggen wird das folgende Beispiel einen
     JPEG-Fehler erzeugen:
    </para>
    <example>
     <title>
      Beispiel, um die Handhabung eines Fehlers bei der Bilderzeugung
      zu sehen (Dank an vic@zymsys.com):
     </title>
     <programlisting role="php">
function Loadpng ($imgname) {
    $im = @ImageCreateFromPNG ($imgname); /* Versuch, Datei zu ffnen */
    if (!$im) {                           /* Prfen, ob fehlgeschlagen */
        $im = ImageCreate (150, 30);      /* Erzeugen eines leeren Bildes */
        $bgc = ImageColorAllocate ($im, 255, 255, 255);
        $tc  = ImageColorAllocate ($im, 0, 0, 0);
        ImageFilledRectangle ($im, 0, 0, 150, 30, $bgc); 
        /* Ausgabe einer Fehlermeldung */
        ImageString($im, 1, 5, 5, "Fehler beim ffnen von: $imgname", $tc); 
    }
    return $im;
}
     </programlisting>
    </example>
   </refsect1>
  </refentry>

  <refentry id="function.imagedashedline">
   <refnamediv>
    <refname>ImageDashedLine</refname>
    <refpurpose>Zeichnen einer gestrichelten Linie</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagedashedline</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>x1</parameter></methodparam>
      <methodparam><type>int</type><parameter>y1</parameter></methodparam>
      <methodparam><type>int</type><parameter>x2</parameter></methodparam>
      <methodparam><type>int</type><parameter>y2</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>    
     <function>ImageDashedLine</function> zeichnet eine gestrichelte
     Linie, beginnend am Punkt <parameter>x1</parameter>,
     <parameter>y1</parameter> bis zum Punkt
     <parameter>x2</parameter>, <parameter>y2</parameter> (oben
     links ist 0, 0) in das Bild image <parameter>im</parameter> mit
     der Farbe <parameter>col</parameter>.
    </para>
    <para>    
     Siehe auch <function>imageline</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagedestroy">
   <refnamediv>
    <refname>ImageDestroy</refname>
    <refpurpose>Lscht ein Bild</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagedestroy</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
     </methodsynopsis>
    <para>    
     <function>ImageDestroy</function> gibt den durch das Bild
     <parameter>im</parameter> belegten Speicher wieder frei.
     <parameter>Im</parameter> ist der Bezeichner, der ihnen beim
     Aufruf der Funktion <function>ImageCreate</function> zurck
     gegeben worden ist.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagefill">
   <refnamediv>
    <refname>ImageFill</refname>
    <refpurpose>Fllen mit Farbe ("flood fill")</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagefill</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>    
     <function>ImageFill</function> bewirkt das Fllen eines Bildes
     beginnend bei der Koordinate <parameter>x</parameter>,
     <parameter>y</parameter> (oben links ist 0, 0) mit der Farbe
     <parameter>col</parameter> im Bild <parameter>im</parameter>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagefilledpolygon">
   <refnamediv>
    <refname>ImageFilledPolygon</refname>
    <refpurpose>Zeichnet ein geflltes Vieleck (Polygon)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagefilledpolygon</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>array</type><parameter>points</parameter></methodparam>
      <methodparam><type>int</type><parameter>num_points</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para> 
     <function>ImageFilledPolygon</function> erzeugt ein Vieleck
     im Bild <parameter>im</parameter>, gefllt mit der Farbe
     <parameter>col</parameter>. <parameter>Points</parameter>
     ist ein PHP-Array, das die Eckpunkte des Vielecks enthlt.
     Points[0] ist die X-Koordinate (x0), points[1] die Y-Koordinate
     (y0) des ersten Eckunktes. Points[2] ist x1, points[3] = y1 usw.
     <parameter>Num_points</parameter> enthlt die Anzahl der Punkte.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagefilledrectangle">
   <refnamediv>
    <refname>ImageFilledRectangle</refname>
    <refpurpose>Zeichnet ein geflltes Rechteck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagefilledrectangle</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>x1</parameter></methodparam>
      <methodparam><type>int</type><parameter>y1</parameter></methodparam>
      <methodparam><type>int</type><parameter>x2</parameter></methodparam>
      <methodparam><type>int</type><parameter>y2</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para> 
     <function>ImageFilledRectangle</function> erzeugt ein mit der
     Farbe <function>col</function> geflltes Rechteck innerhalb des
     Bildes <parameter>im</parameter>. Die obere linke Eck-Koordinate
     wird mittels <parameter>x1</parameter> und
     <parameter>y1</parameter>, die untere rechte Eck-Koordinate
     mittels <parameter>x2</parameter> und <parameter>y2</parameter>
     definiert. 0, 0 ist dabei die linke obere Ecke des Bildes
     <parameter>im</parameter>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagefilltoborder">
   <refnamediv>
    <refname>ImageFillToBorder</refname>
    <refpurpose>
     Flchen-Farbfllung ("flood fill") mit einer angegebenen Farbe
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagefilltoborder</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam><type>int</type><parameter>border</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>    
     <function>ImageFillToBorder</function> bewirkt eine Farb-Fllung
     in einem Bereich, dessen Grenze durch die Farbe in
     <parameter>border</parameter> definiert wird. Der Startpunkt
     wird durch <parameter>x</parameter> und <parameter>y</parameter>
     angegeben (oben links ist 0, 0). Der Bereich wird gefllt mit
     der Farbe <parameter>col</parameter>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagefontheight">
   <refnamediv>
    <refname>ImageFontHeight</refname>
    <refpurpose>Ermittelt die Font-Hhe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagefontheight</methodname>
      <methodparam><type>int</type><parameter>font</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ermittelt die Hhe eines Zeichens (in Pixel) im angegebenen
     Font.
    </para>
    <para>
     Siehe auch <function>imagefontwidth</function> und
     <function>imageloadfont</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagefontwidth">
   <refnamediv>
    <refname>ImageFontWidth</refname>
    <refpurpose>Ermittelt die Font-Breite</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagefontwidth</methodname>
      <methodparam><type>int</type><parameter>font</parameter></methodparam>
     </methodsynopsis>
    <para>    
     Gibt die Zeichenbreite des angegebenen Fonts in Pixeln zurck.
    </para>
    <para> 
     Siehe auch <function>imagefontheight</function> und
     <function>imageloadfont</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagegammacorrect">
    <refnamediv>
      <refname>ImageGammaCorrect</refname>
      <refpurpose>
        Anwendung einer Gamma-Korrektur auf ein GD-Bild
      </refpurpose>
    </refnamediv>
    <refsect1>
      <title>Beschreibung:</title>
     <methodsynopsis>
         <type>int</type><methodname>imagegammacorrect</methodname>
         <methodparam><type>int</type><parameter>im</parameter></methodparam>
         <methodparam><type>double</type><parameter>inputgamma</parameter></methodparam>
         <methodparam><type>double</type><parameter>outputgamma</parameter></methodparam>
     </methodsynopsis>
      <para>
       Die Funktion <function>ImageGammaCorrect</function> bewirkt die
       Anwendung einer Gamma-Korrektur auf das mittels Bezeichner
       <parameter>im</parameter> angegebene GD-Bild. Anzugeben ist der
       Eingabe-Gammawert <parameter>inputgamma</parameter> und der
       Ausgabe-Gammawert <parameter>outputgamma</parameter>.
      </para>
    </refsect1>
  </refentry>

  <refentry id="function.imagegif">
   <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>int</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" knnen Sie PHP-Skripte erstellen, welche die
     <acronym>GIF</acronym>-Ausgabe direkt vornehmen.
     <note>
      <para>
       ACHTUNG: Ab Version 1.6 wurde die GIF-Untersttzung komplett
       aus der GD-Bibliothek entfernt. Diese Funktion ist also nur
       verfgbar, wenn Sie eine Version vor 1.6 verwenden.
      </para>
      <para>
       Um trotzdem portable PHP-Anwendungen schreiben zu knnen,
       kann mit folgendem Code-Stck automatisch geprft werden,
       welches Bildformat in der mitgebundenen GD-Bibliothek
       nutzbar ist. Ersetzen Sie hierfr 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-Untersttzung 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&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>

  <refentry id="function.imagejpeg">
   <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>int</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, knnen Sie einen
     Leerstring ('') benutzen. Durch Verwendung der Funktion
     <function>header</function> mit der "content-type"-Angabe
     "image/jpeg" knnen Sie PHP-Skripte erstellen, welche die
     <acronym>JPEG</acronym>-Ausgabe direkt vornehmen.
    </para>
    <note>
     <para>
      Die JPEG-Untersttzung knnen 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>

  <refentry id="function.imagepng">
   <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>int</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" knnen Sie PHP-Skripte erstellen, welche die
     <acronym>PNG</acronym>-Ausgabe direkt vornehmen.
     <note>
      <para>
       ACHTUNG: Die PNG-Untersttzung ersetzt die GIF-Funktionen ab
       der GD-Bibliothek Version 1.6. Diese Funktion ist also nur
       verfgbar, 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>

  <refentry id="function.imageinterlace">
   <refnamediv>
    <refname>ImageInterlace</refname>
    <refpurpose>
     Schaltet die Interlaced-Darstellung eines Bildes an oder aus
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imageinterlace</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>interlace</parameter></methodparam>
     </methodsynopsis>
    <para>
     Mit der Funktion <function>imageInterlace</function> setzen Sie
     das Bit fr die interlaced-Darstellung eines Bildes auf An (1)
     oder Aus (0).
    </para>
    <para>
     Als Rckgabewert erhalten Sie die aktuelle Einstellung des
     Interlaced-Modus.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imageline">
   <refnamediv>
    <refname>ImageLine</refname>
    <refpurpose>Zeichnen einer Linie</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imageline</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>x1</parameter></methodparam>
      <methodparam><type>int</type><parameter>y1</parameter></methodparam>
      <methodparam><type>int</type><parameter>x2</parameter></methodparam>
      <methodparam><type>int</type><parameter>y2</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>    
     <function>ImageLine</function> zeichnet eine Linie von der
     <parameter>x1</parameter> / <parameter>y1</parameter>
     Koordinate bis zur Kordinate <parameter>x2</parameter> /
     <parameter>y2</parameter> (die Koordinate 0 / 0 ist die
     obere linke Ecke von <parameter>im</parameter>). Die
     Linienfarbe wird durch <parameter>col</parameter>
     festgelegt.  
    </para>
    <para> 
     Siehe auch <function>imagecreate</function> und
     <function>imagecolorallocate</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imageloadfont">
   <refnamediv>
    <refname>ImageLoadFont</refname>
    <refpurpose>Ldt einen neuen Font</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imageloadfont</methodname>
      <methodparam><type>string</type><parameter>file</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageLoadFont</function> ldt einen vom Benutzer
     definierten Bitmap-Font und gibt einen Zeiger auf diesen
     zurck. Dessen Wert ist immer grsser als 5, um Konflikte
     mit den eingebauten Fonts zu vermeiden.
    </para>
    <para>
     Das Font-Datei-Format unterliegt binren Abhngigkeiten und
     ist von Rechner-Typ zu Rechner-Typ unterschiedlich. Das
     bedeutet, dass Sie die Font-Dateien immer auf dem Rechner-Typ
     erzeugen mssen, auf dem diese Verwendung finden.
    </para>
    <para>
     <table>
      <title>Font-Datei-Format</title>
      <tgroup cols="3">
       <thead>
	<row>
	 <entry>Byte-Position</entry>
	 <entry>C Daten-Typ</entry>
	 <entry>Beschreibung</entry>
	</row>
       </thead>
       <tbody>
	<row>
	 <entry>Byte 0-3</entry>
	 <entry>int</entry>
	 <entry>Anzahl der Zeichen des Font</entry>
	</row>
	<row>
	 <entry>Byte 4-7</entry>
	 <entry>int</entry>
	 <entry>
    Wert des ersten Zeichens des Fonts (meist 32 fr Leerzeichen)
	 </entry>
	</row>
	<row>
	 <entry>Byte 8-11</entry>
	 <entry>int</entry>
	 <entry>Pixel-Breite jedes Zeichens</entry>
	</row>
	<row>
	 <entry>Byte 12-15</entry>
	 <entry>int</entry>
	 <entry>Pixel-Hhe jedes Zeichens</entry>
	</row>
	<row>
	 <entry>Byte 16-</entry>
	 <entry>Zeichen</entry>
	 <entry>
    Zeichen-Daten als Array, ein Byte je Pixel fr jedes
    Zeichen; in der Summe also (Anzahl-Zeichen * Breite *
    Hhe)-Bytes.
	 </entry>
	</row>
       </tbody>
      </tgroup>
     </table>
    </para>
    <para>
     Siehe auch <function>imagefontwidth</function> und
     <function>imagefontheight</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagepolygon">
   <refnamediv>
    <refname>ImagePolygon</refname>
    <refpurpose>Zeichnen eines Vielecks (Polygon)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagepolygon</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>array</type><parameter>points</parameter></methodparam>
      <methodparam><type>int</type><parameter>num_points</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para> 
     <function>ImagePolygon</function> erzeugt ein Vieleck innerhalb
     von <parameter>im</parameter>. <parameter>Points</parameter>
     ist ein PHP-Array, das die Werte fr die Eckpunkte des Polygons
     enthlt, z.B. Points[0] = x0, Points[1] = y0, Points[2]
     = x1, Points[3] = y1 usw. <parameter>Num_points</parameter>
     enthlt die Gesamtzahl an Points (Points[n]).
    </para>
    <para> 
     Siehe auch <function>imagecreate</function> und
     <function>imagefilledpolygon</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagepsbbox">
   <refnamediv>
    <refname>ImagePSBBox</refname>
    <refpurpose>
     Ermittelt die Ausmae des Rechtecks, das fr die Ausgabe eines
     Textes unter Verwendung eines PostScript-Fonts (Typ 1) notwendig
     ist.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>imagepsbbox</methodname>
      <methodparam><type>string</type><parameter>text</parameter></methodparam>
      <methodparam><type>int</type><parameter>font</parameter></methodparam>
      <methodparam><type>int</type><parameter>size</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>space</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>tightness</parameter></methodparam>
      <methodparam choice="opt"><type>float</type><parameter>angle</parameter></methodparam>
     </methodsynopsis>
    <para><parameter>Size</parameter> ist die Gre in Pixel.
    </para>
    <para>
     <parameter>Space</parameter> ermglicht ihnen, den vorgegebenen
     Wert fr den Zeichen-Zwischenraum eines Fonts anzugeben. Dieser
     Wert wird zum Normal-Wert hinzu gezhlt und kann auch negativ
     sein.
    </para>
    <para>
     <parameter>Tightness</parameter> ermglicht ihnen die Kontrolle
     ber die Breite eines Leerzeichens. Der angegebene Wert wird zur
     normalen Zeichenbreite hinzu gezhlt und kann auch negativ sein.
    </para>
    <para>
     <parameter>Angle</parameter> (Winkel) wird in Grad angegeben und
     beinhaltet den Drehungswinkel des auszugebenden Textes.
    </para>
    <para>
     Die Parameter <parameter>space</parameter> und
     <parameter>tightness</parameter> haben als Einheit die
     Zeichenbreite, wobei der Wert 1 gleich 1/1000stel der Breite des
     Zeichens 'm' entspricht (Ma 'em').
    </para>
    <para>
     Die Parameter <parameter>space</parameter>,
     <parameter>tightness</parameter> und
     <parameter>angle</parameter> sind optional.
    </para>
    <para>
     Das umgebende Rechteck wird berechnet unter Verwendung der fr
     die Zeichen-Abmessungen verfgbaren Informationen und
     unterscheidet sich immer etwas von den aktuellen Raster-Werten
     des Textes. Ist der Winkel (angle) mit 0 angegeben, knnen Sie
     davon ausgehen, dass der Text in jede Richtung immer 1 Pixel
     mehr braucht als sonst.
    </para>
    <para>
     Diese Funktion gibt ein Array zurck, welches die folgenden
     Elemente enthlt:
     <informaltable>
      <tgroup cols="2">
       <tbody>
	<row>
	 <entry>0</entry>
	 <entry>untere linke x-Koordinate</entry>
	</row>
	<row>
	 <entry>1</entry>
	 <entry>untere linke y-Koordinate</entry>
	</row>
	<row>
	 <entry>2</entry>
	 <entry>obere rechte x-Koordinate</entry>
	</row>
	<row>
	 <entry>3</entry>
	 <entry>obere rechte y-Koordinate</entry>
	</row>
       </tbody>
      </tgroup>
     </informaltable>
    </para>
    <para>
     Siehe auch <function>imagepstext</function>.
    </para>
   </refsect1>
  </refentry>

<!-- Die Funktion in t1lib, die von der folgenden Funktion gebraucht
wird, scheint 'buggy' zu sein...
Dieser Abschnitt sollte erst auskommentiert werden, sobald eine
Lsung fr das Problem gefunden wurde.

  <refentry id="function.imagepscopyfont">
   <refnamediv>
    <refname>ImagePSCopyFont</refname>
    <refpurpose>
     Erstellt eine Kopie eines bereits geladenen Fonts fr weitere
     Vernderungen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagepscopyfont</methodname>
      <methodparam><type>int</type><parameter>fontindex</parameter></methodparam>
     </methodsynopsis>
    <para>
     Falls Sie Vernderungen an einem Font (Gre, Dicke usw.)
     vornehmen wollen, den ursprglichen Font aber noch brauchen,
     sollten Sie diese Funktion benutzen. Der zu kopierende Font
     muss ber die Funktion <function>ImagePSLoadFont</function>
     vorher geladen worden sein. Eine Kopie dieses Fonts knnen Sie
     nicht verwenden. Sie knnen aber bereits vor dem Kopieren
     Vernderungen vornehmen.
    </para>
    <para>
     Falls Sie diese Funkton benutzen, <emphasis>mssen</emphasis>
     Sie die so erzeugten Fonts selbst freigeben und zwar in
     umgekehrter Reihenfolge, ansonsten <emphasis>wird</emphasis>
     ihr Skript 'hngen'.
    </para>
    <para>
     Falls alles klappt, wird ihnen ein gltiger Font-Index zurck
     gegeben, den Sie weiter verwenden knnen. Falls nicht, wird
     &false; zurck und eine Fehlermeldung ausgegeben.
    </para>
    <para>
     Siehe auch <function>imagepsloadfont</function>.
    </para>
   </refsect1>
  </refentry>
-->

  <refentry id="function.imagepsencodefont">
   <refnamediv>
    <refname>ImagePSEncodeFont</refname>
    <refpurpose>
     ndert die Vektor-Beschreibung eines Fonts
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagepsencodefont</methodname>
      <methodparam><type>string</type><parameter>encodingfile</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ldt einen Zeichen-Beschreibungs-Vektor aus einer Datei und
     verndert die Vektor-Beschreibung des Fonts. Da ein PS-Font
     meist Lcken 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 stndig 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
     richtige Datei geladen und die Zeichen haben damit die richtige
     Beschreibung.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagepsextendfont">
   <refnamediv>
    <refname>ImagePsExtendFont</refname>
    <refpurpose>Vergrert oder komprimiert einen Font</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>bool</type><methodname>imagepsextendfont</methodname>
      <methodparam><type>int</type><parameter>font_index</parameter></methodparam>
      <methodparam><type>double</type><parameter>extend</parameter></methodparam>
     </methodsynopsis>
    <para>
     Der mit <parameter>font_index</parameter> angegebene Font wird
     gedehnt (<parameter>extend</parameter> ist grer als der Font)
     oder verkleinert (<parameter>extend</parameter> ist kleiner als
     der Font).
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagepsfreefont">
   <refnamediv>
    <refname>ImagePSFreeFont</refname>
    <refpurpose>
     Gibt den durch einen Typ 1 PostScript-Font belegten Speicher
     wieder frei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>void</type><methodname>imagepsfreefont</methodname>
      <methodparam><type>int</type><parameter>fontindex</parameter></methodparam>
     </methodsynopsis>
    <para>
     Siehe auch <function>imagepsloadfont</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagepsloadfont">
   <refnamediv>
    <refname>ImagePSLoadFont</refname>
    <refpurpose>
     Ldt einen Typ 1 PostScript-Font aus einer Datei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagepsloadfont</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Wenn alles in Ordnung ist, wird ein gltiger Zeiger (Index)
     zurck gegeben, auf den Sie immer wieder zurck greifen knnen;
     ansonsten wird &false; zurck und eine Fehlermeldung ausgegeben.
    </para>
    <para>
     Siehe auch <function>imagepsfreefont</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagepsslantfont">
   <refnamediv>
    <refname>ImagePsSlantFont</refname>
    <refpurpose>Setzt einen Font schrg</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>bool</type><methodname>imagepsslantfont</methodname>
      <methodparam><type>int</type><parameter>font_index</parameter></methodparam>
      <methodparam><type>double</type><parameter>slant</parameter></methodparam>
     </methodsynopsis>
    <para>
     Der mit <parameter>font_index</parameter> angegebene Font wird
     um den Faktor <parameter>slant</parameter> "verschrgt" (italic!).
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagepstext">
   <refnamediv>
    <refname>ImagePSText</refname>
    <refpurpose>
     Ausgabe eines Textes auf einem Bild unter Verwendung von
     Typ 1 PostScript-Fonts
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>imagepstext</methodname>
      <methodparam><type>int</type><parameter>image</parameter></methodparam>
      <methodparam><type>string</type><parameter>text</parameter></methodparam>
      <methodparam><type>int</type><parameter>font</parameter></methodparam>
      <methodparam><type>int</type><parameter>size</parameter></methodparam>
      <methodparam><type>int</type><parameter>foreground</parameter></methodparam>
      <methodparam><type>int</type><parameter>background</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        space
       </parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        tightness
       </parameter></methodparam>
      <methodparam choice="opt"><type>float</type><parameter>
        angle
       </parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        antialias_steps
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>Size</parameter> wird in Pixel ausgedrckt.
    </para>
    <para>
     <parameter>Foreground</parameter> ist die Text-Ausgabefarbe
     (Vordergrund). <parameter>Background</parameter> ist die Farbe,
     zu der ein Farbbergang versucht werden soll. Dabei wird kein
     Pixel mit der Farbe <parameter>Background</parameter>
     ausgegeben, so dass das Bild im Hintergrund keine festen Farben
     bentigt.
    </para>
    <para>
     Die Koordinaten <parameter>x</parameter> und 
     <parameter>y</parameter> definieren den Ursprung (bzw. den
     Referenz-Punkt) des ersten Zeichens (ungefhr die linke untere
     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
     Dokumentation zu PostScript und seines Masystems nach, falls
     Sie die Funktionsweise nicht verstehen.
    </para>
    <para>
     <parameter>Space</parameter> ermglicht ihnen, die Vorgabe des
     Wertes fr den Zeichen-Zwischenraum zu verndern. Der angegebene
     Wert wird addiert und kann auch negativ sein.
    </para>
    <para>
     <parameter>Tightness</parameter> ermglicht die Kontrolle ber
     die Breite des Leerzeichens. Der Wert wird addiert und kann auch
     negativ sein.
    </para>
    <para>
     <parameter>Angle</parameter> wird in Grad angegeben und hat die
     entsprechende Drehung des Ausgabetextes zur Folge.
    </para>
    <para>
     <parameter>Antialias_steps</parameter> erlaubt die Kontrolle
     ber die Anzahl der Farben, mit der der Farbbergang vom Text
     zum Hintergrundbild vorgenommen werden soll. Mglich sind
     Werte von 4 bis 16. Der hhere Wert wird empfohlen bei
     Textgrssen kleiner als 20, wo der Effekt bei der Textqualitt
     deutlich sichtbar ist. Bei grsseren Werten als 20 werden 4
     Farben empfohlen. Das ist weniger rechenintensiv.
    </para>
    <para>
     Die Parameter <parameter>space</parameter> und
     <parameter>tightness</parameter> werden in 1/1000-stel der
     Breite des Buchstabens "m" (Einheit 'em') angegeben.
    </para>
    <para>
     Die Parameter <parameter>space</parameter>,
     <parameter>tightness</parameter>, <parameter>angle</parameter>
     und <parameter>antialias</parameter> sind optional.
    </para>
    <para>
     Diese Funktion gibt ein Array mit den folgenden Werten zurck:
     <informaltable>
      <tgroup cols="2">
       <tbody>
	<row>
	 <entry>0</entry>
	 <entry>untere linke X-Koordinate</entry>
	</row>
	<row>
	 <entry>1</entry>
	 <entry>untere linke Y-Koordinate</entry>
	</row>
	<row>
	 <entry>2</entry>
	 <entry>obere rechte X-Koordinate</entry>
	</row>
	<row>
	 <entry>3</entry>
	 <entry>obere rechte Y-Koordinate</entry>
	</row>
       </tbody>
      </tgroup>
     </informaltable></para>
    <para>
     Siehe auch <function>imagepsbbox</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagerectangle">
   <refnamediv>
    <refname>ImageRectangle</refname>
    <refpurpose>Zeichnet ein Rechteck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagerectangle</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>x1</parameter></methodparam>
      <methodparam><type>int</type><parameter>y1</parameter></methodparam>
      <methodparam><type>int</type><parameter>x2</parameter></methodparam>
      <methodparam><type>int</type><parameter>y2</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>    
     <function>ImageRectangle</function> erzeugt ein Rechteck mit
     der Linienfarbe <parameter>col</parameter>, beginnend bei der
     oberen linken Koordinate X1 und Y1. Das Ende liegt bei der
     unteren rechten Koordinate X2 und Y2. Dabei ist 0, 0 die
     linke obere Ecke des Bildes <parameter>im</parameter>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagesetpixel">
   <refnamediv>
    <refname>ImageSetPixel</refname>
    <refpurpose>Setzt ein einzelnes Pixel</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagesetpixel</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para> 
     <function>ImageSetPixel</function> zeichnet ein Pixel an der
     Koordinate <parameter>x</parameter> / <parameter>y</parameter>.
     Dabei ist die Koordinate 0, 0 die linke obere Ecke des Bildes
     <parameter>im</parameter>. Die Pixelfarbe wird durch
     <parameter>col</parameter> bestimmt.
    </para> 
    <para> 
     Siehe auch <function>imagecreate</function> und
     <function>imagecolorallocate</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagestring">
   <refnamediv>
    <refname>ImageString</refname>
    <refpurpose>Zeichnet einen horizontalen String</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagestring</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>font</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam><type>string</type><parameter>s</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>    
     <function>ImageString</function> gibt den String
     <parameter>s</parameter> in dem durch den Parameter
     <parameter>im</parameter> bezeichneten Bild an den 
     Koordinaten <parameter>x</parameter> und
     <parameter>y</parameter> aus. Die Koordinaten 0, 0 geben die
     linke obere Ecke des Bildes <parameter>im</parameter> an. Der
     Font erscheint in der Farbe <parameter>col</parameter>. Hat
     <parameter>font</parameter> den Wert 1, 2, 3, 4 oder 5 wird
     ein interner Font benutzt.
    </para> 
    <para> 
     Siehe auch <function>imageloadfont</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagestringup">
   <refnamediv>
    <refname>ImageStringUp</refname>
    <refpurpose>Zeichnet einen vertikalen String</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagestringup</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>font</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam><type>string</type><parameter>s</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
     </methodsynopsis>
    <para>    
     <function>ImageStringUp</function> gibt den String
     <parameter>s</parameter> vertikal innerhalb des Bildes
     <parameter>im</parameter> an den Koordinaten
     <parameter>x</parameter> und <parameter>y</parameter> aus.
     Die linke obere Ecke von <parameter>im</parameter> ist dabei
     0, 0. Der Text wird in der Farbe <parameter>col</parameter>
     ausgegeben. Hat <parameter>font</parameter> den Wert 1, 2, 3,
     4 oder 5 wird ein interner Font benutzt.
    </para> 
    <para> 
     Siehe auch <function>imageloadfont</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagesx">
   <refnamediv>
    <refname>ImageSX</refname>
    <refpurpose>Ermittelt die Bild-Breite</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagesx</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
     </methodsynopsis>
    <para> 
     <function>ImageSX</function> ermittelt die Breite des Bildes,
     das durch <parameter>im</parameter> referenziert wird.
    </para>
    <para> 
     Siehe auch <function>imagecreate</function> und
     <function>imagesy</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagesy">
   <refnamediv>
    <refname>ImageSY</refname>
    <refpurpose>Ermittelt die Bild-Hhe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagesy</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageSY</function> ermittelt die Hhe des Bildes,
     das durch <parameter>im</parameter> referenziert wird.
    </para> 
    <para>
     Siehe auch <function>imagecreate</function> und
     <function>imagesx</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagettfbbox">
   <refnamediv>
    <refname>ImageTTFBBox</refname>
    <refpurpose>
     Ermittelt die Rahmenmae fr die Ausgabe eines Textes
     im True-Type-Format
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>imagettfbbox</methodname>
      <methodparam><type>int</type><parameter>size</parameter></methodparam>
      <methodparam><type>int</type><parameter>angle</parameter></methodparam>
      <methodparam><type>string</type><parameter>fontfile</parameter></methodparam>
      <methodparam><type>string</type><parameter>text</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion errechnet die Grsse des Bereichs fr eine
     True-Type-Textausgabe.
     <variablelist>
      <varlistentry>
       <term>
	<parameter>text</parameter>
       </term>
       <listitem>
	<simpara>Der zu messende Text</simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>
	<parameter>size</parameter>
       </term>
       <listitem>
	<simpara>Die Font-Gre</simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>
	<parameter>fontfile</parameter>
       </term>
       <listitem>
	<simpara>
	 Der Name der TTF-Datei (kann auch eine URL sein)
	</simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>
	<parameter>angle</parameter>
       </term>
       <listitem>
	<simpara>
	 Der Winkel, in dem <parameter>text</parameter> ausgegeben wird
	</simpara>
       </listitem>
      </varlistentry>
     </variablelist>
     <function>ImageTTFBBox</function> gibt ein Array mit acht
     Werten zurck. Diese enthalten die vier Punkte, durch die
     der Ausgabebereich markiert wird:
     <informaltable>
      <tgroup cols="2">
       <tbody>
	<row>
	 <entry>0</entry>
	 <entry>untere linke Ecke, X-Position</entry>
	</row>
	<row>
	 <entry>1</entry>
	 <entry>untere linke Ecke, Y-Position</entry>
	</row>
	<row>
	 <entry>2</entry>
	 <entry>untere rechte Ecke, X-Position</entry>
	</row>
	<row>
	 <entry>3</entry>
	 <entry>untere rechte Ecke, Y-Position</entry>
	</row>
	<row>
	 <entry>4</entry>
	 <entry>obere rechte Ecke, X-Position</entry>
	</row>
	<row>
	 <entry>5</entry>
	 <entry>obere rechte Ecke, Y-Position</entry>
	</row>
	<row>
	 <entry>6</entry>
	 <entry>obere linke Ecke, X-Position</entry>
	</row>
	<row>
	 <entry>7</entry>
	 <entry>obere linke Ecke, Y-Position</entry>
	</row>
       </tbody>
      </tgroup>
     </informaltable>
     Die Punkte sind relativ zum <emphasis>text</emphasis>. Ohne
     Rcksicht auf den Winkel ist oben-links also die obere linke
     Ecke, wobei die Textausgabe horizontal gesehen wird.
    </para>
    <para>
     Diese Funktion erfordert sowohl die GD- als auch die
     <ulink url="&url.freetype;">FreeType</ulink>-Bibliothek.
    </para>
    <para>
     Siehe auch <function>imagettftext</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagettftext">
   <refnamediv>
    <refname>ImageTTFText</refname>
    <refpurpose>Erzeugt TTF-Text im Bild</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>imagettftext</methodname>
      <methodparam><type>int</type><parameter>im</parameter></methodparam>
      <methodparam><type>int</type><parameter>size</parameter></methodparam>
      <methodparam><type>int</type><parameter>angle</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam><type>int</type><parameter>col</parameter></methodparam>
      <methodparam><type>string</type><parameter>fontfile</parameter></methodparam>
      <methodparam><type>string</type><parameter>text</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ImageTTFText</function> zeichnet den Text
     <parameter>text</parameter> in das per
     <parameter>im</parameter> angegebene Bild, beginnend bei den
     Koordinaten <parameter>x</parameter> und
     <parameter>y</parameter> (oben links ist 0, 0) mit einem
     Ausgabewinkel von <parameter>angle</parameter> in der Farbe
     <parameter>col</parameter> unter Verwendung der TTF-Datei,
     die mittels <parameter>fontfile</parameter> benannt wurde.
    </para>
    <para>
     Die per <parameter>x</parameter> und <parameter>y</parameter>
     angegebenen Koordinaten definieren den Startpunkt des ersten
     Zeichens (in etwa die linke untere Ecke). Das ist anders als
     bei der <function>ImageString</function>-Funktion, bei der x
     und y die obere rechte Ecke des ersten Zeichens darstellen.
    </para>
    <para>
     <parameter>Angle</parameter> ist in Grad anzugeben. 0 ist eine
     normale Ausrichtung von links nach rechts (von 9 nach 3 Uhr).
     Hhere Werte entsprechen einer immer weiteren Drehung entgegen
     dem Uhrzeiger-Sinn. Eine Drehung von 90 Grad entspricht also
     einer Text-Ausrichtung von unten nach oben (von 6 nach 12 Uhr).
    </para>
    <para>
     <parameter>Fontfile</parameter> ist der Pfad zur TTF-Datei, die 
     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
     negativen Index-Wert, fhrt das zum Aufheben des Farbberlaufs
     (Antialiasing).
    </para>
    <para>
     <function>ImageTTFText</function> gibt ein Array aus acht
     Elementen zurck, das die vier Ecken des Textausgabe-Bereichs
     enthlt (wie <function>ImageTTFBBox</function>). Die Reihenfolge
     ist dabei oben links, oben rechts, unten rechts und unten links.
     Die Punkte sind dabei relativ zum Text. Deshalb gibt oben links
     die linke Ecke bei horizontaler Sichtweise an.
    </para>
    <para>
     Das Beispiel-Skript erzeugt eine schwarze GIF-Grafik von 400x30
     Pixel mit dem weissen Text "Teste..." im TT-Font Arial.
     <example>
      <title>ImageTTFText</title>
      <programlisting role="php">
&lt;?php
Header ("Content-type: image/gif");
$im = imagecreate (400, 30);
$black = ImageColorAllocate ($im, 0, 0, 0);
$white = ImageColorAllocate ($im, 255, 255, 255);
ImageTTFText ($im, 20, 0, 10, 20, $white, "/path/arial.ttf", 
              "Teste... Omega: &amp;#937;");
ImageGif ($im);
ImageDestroy ($im);
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Diese Funktion erfordert sowohl die GD- als auch die
     <ulink url="&url.freetype;">FreeType</ulink>-Bibliothek.
    </para>
    <para>
     Siehe auch <function>imagettfbbox</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.imagetypes">
   <refnamediv>
    <refname>ImageTypes</refname>
    <refpurpose>
	   Gibt die von der aktuell verwendeten PHP-Version untersttzten
     Grafik-Formate zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>imagetypes</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Der von dieser Funktion zurck gegebene Bit-Wert stellt die von
     der in der aktuellen PHP-Kompilation enthaltenen GD-Version
     untersttzten Grafik-Formate dar. Die folgenden Bit-Werte sind
     mglich: IMG_GIF, IMG_JPG, IMG_PNG oder IMG_WBMP. Um das Vorhanden
     sein der GD-Untersttzung zu testen, knnen Sie folgendes machen:
     <example>
      <title>ImageTypes</title>
      <programlisting role="php">
&lt;?php
if (ImageTypes() &amp; IMG_PNG) {
    echo "PNG-Untersttzung ist vorhanden.";
}
?&gt;
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.read-exif-data">
   <refnamediv>
    <refname>read_exif_data</refname>
    <refpurpose>
     Liest die EXIF Header-Infos einer JPEG-Grafik
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>read_exif_data</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>read_exif_data</function> liest die EXIF
     Datei-Kopf-Informationen aus einer JPEG-Grafik-Datei. Es wird ein
     assoziatives Array in dem die Indizes die EXIF-Kopf-Bezeichnungen
     und die Werte die Inhalte dieser Kopf-Infos sind. EXIF-Infos sind
     hufig 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
     knnen Sie mit dieser Funktion ermitteln.
     <example>
      <title>read_exif_data</title>
      <programlisting role="php">
&lt;?php
 $exif = read_exif_data ('p0001807.jpg');
 while(list($k,$v)=each($exif)) {
   echo "$k: $v&lt;br>\n";
 }
?>

Ausgabe:
FileName: p0001807.jpg
FileDateTime: 929353056
FileSize: 378599
CameraMake: Eastman Kodak Company
CameraModel: KODAK DC265 ZOOM DIGITAL CAMERA (V01.00)
DateTime: 1999:06:14 01:37:36
Height: 1024
Width: 1536
IsColor: 1
FlashUsed: 0
FocalLength:  8.0mm
RawFocalLength: 8
ExposureTime:  0.004 s (1/250)
RawExposureTime: 0.0040000001899898
ApertureFNumber: f/ 9.5
RawApertureFNumber: 9.5100002288818
FocusDistance: 16.66m
RawFocusDistance: 16.659999847412
Orientation: 1
ExifVersion: 0200
      </programlisting>
     </example>
    </para>
    <para>
     <note>
      <simpara>
       Diese Funktion ist in PHP 4 nur verfgbar, wenn Sie es mit
       --enable-exif compiliert haben.
      </simpara>
      <simpara>
       Diese Funktion erfordert nicht die GD-Library.
      </simpara>
     </note>
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->