svn: /phpdoc/de/trunk/reference/image/functions/ imagecolortransparent.xml imagecopy.xml imagecreate.xml imagecreatefromjpeg.xml imagecreatefrompng.xml
[email protected] (Christoph Michael Becker)
| Newsgroups | php.doc.de |
|---|---|
| Message-ID | <[email protected]> |
cmb Fri, 30 Mar 2018 15:42:37 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=344591
Log:
Sync with EN
Changed paths:
U phpdoc/de/trunk/reference/image/functions/imagecolortransparent.xml
U phpdoc/de/trunk/reference/image/functions/imagecopy.xml
U phpdoc/de/trunk/reference/image/functions/imagecreate.xml
U phpdoc/de/trunk/reference/image/functions/imagecreatefromjpeg.xml
U phpdoc/de/trunk/reference/image/functions/imagecreatefrompng.xml
svn-diffs-344591.txt
(text/x-diff, 26.1 KB)
Modified: phpdoc/de/trunk/reference/image/functions/imagecolortransparent.xml
===================================================================
--- phpdoc/de/trunk/reference/image/functions/imagecolortransparent.xml 2018-03-30 11:17:34 UTC (rev 344590)
+++ phpdoc/de/trunk/reference/image/functions/imagecolortransparent.xml 2018-03-30 15:42:37 UTC (rev 344591)
@@ -1,38 +1,110 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- splitted from ./de/functions/image.xml, last change in rev 1.2 -->
-<!-- last change to 'imagecolortransparent' in en/ tree in rev 1.36 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.26/EN.1.36 -->
- <refentry xml:id="function.imagecolortransparent" xmlns="http://docbook.org/ns/docbook">
- <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>resource</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>
- zurück 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) zurück
- gegeben.
- </para>
- </refsect1>
- </refentry>
+<!-- EN-Revision: 325917 Maintainer: nobody Status: ready -->
+<refentry xml:id="function.imagecolortransparent" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>imagecolortransparent</refname>
+ <refpurpose>Definiert eine Farbe als transparent</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>imagecolortransparent</methodname>
+ <methodparam><type>resource</type><parameter>image</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>color</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Setzt die transparente Farbe des angegebenen <parameter>image</parameter>.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &gd.image.description;
+ <varlistentry>
+ <term><parameter>color</parameter></term>
+ <listitem>
+ <para>
+ Eine Farbkennung, die mit <function>imagecolorallocate</function>
+ erzeugt wurde.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Die Kennung der neuen (oder der aktuellen, falls keine Farbe angegeben wurde)
+ transparenten Farbe wird zurückgegeben. Wird <parameter>color</parameter>
+ nicht angegeben, und das Bild hat keine transparente Farbe, ist die
+ zurückgegebene Kennung -1.
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>imagecolortransparent</function> Beispiel</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Erzeuge ein 55x30 Bild
+$im = imagecreatetruecolor(55, 30);
+$red = imagecolorallocate($im, 255, 0, 0);
+$black = imagecolorallocate($im, 0, 0, 0);
+
+// Mache den Hintergrund transparent
+imagecolortransparent($im, $black);
+
+// Zeichne ein rotes Rechteck
+imagefilledrectangle($im, 4, 4, 50, 25, $red);
+
+// Speichere das Bild
+imagepng($im, './imagecolortransparent.png');
+imagedestroy($im);
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <mediaobject>
+ <alt>Ausgabe des Beispiels : imagecolortransparent()</alt>
+ <imageobject>
+ <imagedata fileref="en/reference/image/figures/imagecolortransparent.png"/>
+ </imageobject>
+ </mediaobject>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ Transparenz wird nur mit <function>imagecopymerge</function>
+ und Echtfarbbildern kopiert, aber nicht mit
+ <function>imagecopy</function> oder Palettenbildern.
+ </para>
+ </note>
+ <note>
+ <para>
+ Die transparente Farbe ist eine Eigenschaft des Bildes, nicht der Farbe.
+ Sobald eine Farbe als transparente Farbe definiert wurde, werden alle
+ Bereiche eines Bildes mit dieser Farbe, die zuvor gezeichnet wurden,
+ transparent sein.
+ </para>
+ </note>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/de/trunk/reference/image/functions/imagecopy.xml
===================================================================
--- phpdoc/de/trunk/reference/image/functions/imagecopy.xml 2018-03-30 11:17:34 UTC (rev 344590)
+++ phpdoc/de/trunk/reference/image/functions/imagecopy.xml 2018-03-30 15:42:37 UTC (rev 344591)
@@ -1,39 +1,146 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- splitted from ./de/functions/image.xml, last change in rev 1.9 -->
-<!-- last change to 'imagecopy' in en/ tree in rev 1.36 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.26/EN.1.36 -->
- <refentry xml:id="function.imagecopy" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>imagecopy</refname>
- <refpurpose>Kopiert einen Bildausschnitt</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung:</title>
- <methodsynopsis>
- <type>int</type><methodname>ImageCopy</methodname>
- <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam>
- <methodparam><type>resource</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 Höhe 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>
+<!-- EN-Revision: 309972 Maintainer: nobody Status: ready -->
+<refentry xml:id="function.imagecopy" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>imagecopy</refname>
+ <refpurpose>Kopiert einen Bildausschnitt</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>ImageCopy</methodname>
+ <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam>
+ <methodparam><type>resource</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 Höhe 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>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>dst_im</parameter></term>
+ <listitem>
+ <para>&gd.image.destination;</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>src_im</parameter></term>
+ <listitem>
+ <para>&gd.image.source;</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>dst_x</parameter></term>
+ <listitem>
+ <para>
+ x-Koordinate des Zielpunktes.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>dst_y</parameter></term>
+ <listitem>
+ <para>
+ y-Koordinate des Zielpunkts.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>src_x</parameter></term>
+ <listitem>
+ <para>
+ x-Koordinate des Quellpunkts.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>src_y</parameter></term>
+ <listitem>
+ <para>
+ y-Koordinate des Quellpunkts.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>src_w</parameter></term>
+ <listitem>
+ <para>&gd.source.width;</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>src_h</parameter></term>
+ <listitem>
+ <para>&gd.source.height;</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+
+ <example>
+ <title>Beschneiden des PHP.net Logos</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Erzeuge die Bilder
+$src = imagecreatefromgif('php.gif');
+$dest = imagecreatetruecolor(80, 40);
+
+// Kopiere
+imagecopy($dest, $src, 0, 0, 20, 13, 80, 40);
+
+// Ausgeben und Speicher freigeben
+header('Content-Type: image/gif');
+imagegif($dest);
+
+imagedestroy($dest);
+imagedestroy($src);
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <mediaobject>
+ <alt>Ausgabe des Beispiels : Beschneiden des PHP.net Logos</alt>
+ <imageobject>
+ <imagedata fileref="en/reference/image/figures/imagecopy.gif"/>
+ </imageobject>
+ </mediaobject>
+ </example>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/de/trunk/reference/image/functions/imagecreate.xml
===================================================================
--- phpdoc/de/trunk/reference/image/functions/imagecreate.xml 2018-03-30 11:17:34 UTC (rev 344590)
+++ phpdoc/de/trunk/reference/image/functions/imagecreate.xml 2018-03-30 15:42:37 UTC (rev 344591)
@@ -1,56 +1,108 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- splitted from ./de/functions/image.xml, last change in rev 1.2 -->
-<!-- last change to 'imagecreate' in en/ tree in rev 1.36 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.26/EN.1.36 -->
- <refentry xml:id="function.imagecreate" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>imagecreate</refname>
- <refpurpose>Erzeugt ein neues Bild</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung:</title>
- <methodsynopsis>
- <type>resource</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 zurück. Dieser Zeiger stellt ein leeres Bild mit der Größe
- <parameter>x_size</parameter> und <parameter>y_size</parameter>
- dar.
- </para>
- <para>
- Es wird empfohlen, die Funktion <function>imagecreatetruecolor</function>
- zu verwenden.
- </para>
- <para>
- <example>
- <title>
- Erzeugung eines neuen GD-Bild-Streams und Ausgabe des Bildes:
- </title>
- <programlisting role="php">
-<?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);
+<!-- EN-Revision: 331628 Maintainer: nobody Status: ready -->
+
+<refentry xml:id="function.imagecreate" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>imagecreate</refname>
+ <refpurpose>Erzeugt ein neues Paletten-Bild</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>resource</type><methodname>imagecreate</methodname>
+ <methodparam><type>int</type><parameter>width</parameter></methodparam>
+ <methodparam><type>int</type><parameter>height</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>imagecreate</function> gibt eine Bildkennung zurück, die eine
+ leeres Bild mit der angegebene Größe repräsentiert.
+ </para>
+ <para>
+ Im Allgemeinen wird empfohlen, die Funktion
+ <function>imagecreatetruecolor</function> anstelle von
+ <function>imagecreate</function> zu verwenden, so dass die Bildverarbeitung
+ mit der bestmöglichen Qualität erfolgt. Sollen Palettenbilder ausgegeben
+ werden, dann sollte <function>imagetruecolortopalette</function> unmittelbar
+ vor dem Speichern des Bildes mit <function>imagepng</function> oder
+ <function>imagegif</function> aufgerufen werden.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>width</parameter></term>
+ <listitem>
+ <para>
+ Die Breite des Bildes.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>height</parameter></term>
+ <listitem>
+ <para>
+ Die Höhe des Bildes.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>&gd.return.identifier;</para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>
+ Erzeugung eines neuen GD-Bild-Streams und Ausgabe des Bildes:
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+header("Content-type: image/png");
+$im = @imagecreate(50, 100)
+ or die("Kann keinen neuen GD-Bild-Stream erzeugen");
+$background_color = imagecolorallocate($im, 0, 0, 0);
+$text_color = imagecolorallocate($im, 233, 14, 91);
+imagestring($im, 1, 5, 5, "Ein Test-String", $text_color);
+imagepng($im);
+imagedestroy($im);
?>
- </programlisting>
- </example>
- </para>
- <para>
- Siehe auch <function>imagedestroy</function> und
- <function>imagecreatetruecolor</function>.
- </para>
- </refsect1>
- </refentry>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <mediaobject>
+ <alt>Ausgabe des Beispiels : Erzeugung eines neuen GD-Bild-Streams und Ausgabe des Bildes.</alt>
+ <imageobject>
+ <imagedata fileref="en/reference/image/figures/imagecreate.png"/>
+ </imageobject>
+ </mediaobject>
+ </example>
+ </para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>imagedestroy</function></member>
+ <member><function>imagecreatetruecolor</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/de/trunk/reference/image/functions/imagecreatefromjpeg.xml
===================================================================
--- phpdoc/de/trunk/reference/image/functions/imagecreatefromjpeg.xml 2018-03-30 11:17:34 UTC (rev 344590)
+++ phpdoc/de/trunk/reference/image/functions/imagecreatefromjpeg.xml 2018-03-30 15:42:37 UTC (rev 344591)
@@ -1,58 +1,98 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- splitted from ./de/functions/image.xml, last change in rev 1.3 -->
-<!-- last change to 'imagecreatefromjpeg' in en/ tree in rev 1.4 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.26/EN.1.4 -->
- <refentry xml:id="function.imagecreatefromjpeg" xmlns="http://docbook.org/ns/docbook">
- <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>resource</type><methodname>imagecreatefromjpeg</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>ImageCreateFromJPEG</function> gibt den Bezeichner auf
- ein Bild zurück, der das aus der angegebenen Datei eingelesene
- Bild darstellt.
- </para>
- <para>
- Im Fehlerfall gibt <function>ImageCreateFromJPEG</function> eine
- leere Zeichenkette zurück. 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 [email protected]):
- </title>
- <programlisting role="php">
-function LoadJpeg ($imgname) {
- $im = @ImageCreateFromJPEG ($imgname); /* Versuch, Datei zu öffnen */
- if (!$im) { /* Prüfen, 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);
+<!-- EN-Revision: 339875 Maintainer: nobody Status: ready -->
+
+<refentry xml:id="function.imagecreatefromjpeg" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>imagecreatefromjpeg</refname>
+ <refpurpose>&gd.image.new;</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>resource</type><methodname>imagecreatefromjpeg</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>imagecreatefromjpeg</function> gibt den Bezeichner auf
+ ein Bild zurück, der das aus der angegebenen Datei eingelesene
+ Bild darstellt.
+ </para>
+ &tip.fopen-wrapper;
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ Pfad des JPEG-Bilds.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>&gd.return.identifier;</para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <example>
+ <title>Beispiel für Fehlerbehandlung beim Laden eines JPEG</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function LoadJpeg($imgname)
+{
+ /* Versuche zu öffnen */
+ $im = @imagecreatefromjpeg($imgname);
+
+ /* Prüfe, ob das fehlschlug */
+ if(!$im)
+ {
+ /* Erzeuge ein schwarzes Bild */
+ $im = imagecreatetruecolor(150, 30);
+ $bgc = imagecolorallocate($im, 255, 255, 255);
+ $tc = imagecolorallocate($im, 0, 0, 0);
+
+ imagefilledrectangle($im, 0, 0, 150, 30, $bgc);
+
+ /* Gib eine Fehlermeldung aus */
+ imagestring($im, 1, 5, 5, 'Fehler beim Laden von ' . $imgname, $tc);
}
+
return $im;
}
- </programlisting>
- </example>
- </refsect1>
- </refentry>
+header('Content-Type: image/jpeg');
+
+$img = LoadJpeg('bogus.image');
+
+imagejpeg($img);
+imagedestroy($img);
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <mediaobject>
+ <alt>Ausgabe des Beispiels : Beispiel für Fehlerbehandlung beim Laden eines JPEG</alt>
+ <imageobject>
+ <imagedata fileref="en/reference/image/figures/imagecreatefromjpeg.jpg"/>
+ </imageobject>
+ </mediaobject>
+ </example>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/de/trunk/reference/image/functions/imagecreatefrompng.xml
===================================================================
--- phpdoc/de/trunk/reference/image/functions/imagecreatefrompng.xml 2018-03-30 11:17:34 UTC (rev 344590)
+++ phpdoc/de/trunk/reference/image/functions/imagecreatefrompng.xml 2018-03-30 15:42:37 UTC (rev 344591)
@@ -1,58 +1,98 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- splitted from ./de/functions/image.xml, last change in rev 1.2 -->
-<!-- last change to 'imagecreatefrompng' in en/ tree in rev 1.4 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.26/EN.1.4 -->
- <refentry xml:id="function.imagecreatefrompng" xmlns="http://docbook.org/ns/docbook">
- <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>resource</type><methodname>imagecreatefrompng</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>ImageCreateFromPNG</function> gibt den Bezeichner auf
- ein Bild zurück, der das aus der angegebenen Datei eingelesene
- Bild darstellt.
- </para>
- <para>
- Im Fehlerfall gibt <function>ImageCreateFromPNG</function> eine
- leere Zeichenkette zurück. 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 [email protected]):
- </title>
- <programlisting role="php">
-function Loadpng ($imgname) {
- $im = @ImageCreateFromPNG ($imgname); /* Versuch, Datei zu öffnen */
- if (!$im) { /* Prüfen, 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);
+<!-- EN-Revision: 336340 Maintainer: nobody Status: ready -->
+
+<refentry xml:id="function.imagecreatefrompng" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>imagecreatefrompng</refname>
+ <refpurpose>&gd.image.new;</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>resource</type><methodname>imagecreatefrompng</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>imagecreatefrompng</function> gibt den Bezeichner auf
+ ein Bild zurück, der das aus der angegebenen Datei eingelesene
+ Bild darstellt.
+ </para>
+ &tip.fopen-wrapper;
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ Pfad des PNG-Bilds.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>&gd.return.identifier;</para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <example>
+ <title>Beispiel für Fehlerbehandlung beim Laden eines PNG</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function LoadPNG($imgname)
+{
+ /* Versuche zu öffnen */
+ $im = @imagecreatefrompng($imgname);
+
+ /* Prüfe, ob das fehlschlug */
+ if(!$im)
+ {
+ /* Erzeuge ein schwarzes Bild */
+ $im = imagecreatetruecolor(150, 30);
+ $bgc = imagecolorallocate($im, 255, 255, 255);
+ $tc = imagecolorallocate($im, 0, 0, 0);
+
+ imagefilledrectangle($im, 0, 0, 150, 30, $bgc);
+
+ /* Gib eine Fehlermeldung aus */
+ imagestring($im, 1, 5, 5, 'Fehler beim Laden von ' . $imgname, $tc);
}
+
return $im;
}
- </programlisting>
- </example>
- </refsect1>
- </refentry>
+header('Content-Type: image/png');
+
+$img = LoadPNG('bogus.image');
+
+imagepng($img);
+imagedestroy($img);
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <mediaobject>
+ <alt>imagecreatefrompng() Beispiel</alt>
+ <imageobject>
+ <imagedata fileref="en/reference/image/figures/imagecreatefrompng.png"/>
+ </imageobject>
+ </mediaobject>
+ </example>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml