cvs: phpdoc-fr /reference/image examples.xml /reference/image/functions imagesettile.xml imagestringup.xml imagetruecolortopalette.xml
imagettfbbox.xml imagewbmp.xml imagexbm.xml iptcembed.xml iptcparse.xml jpeg2wbmp.xml png2wbmp.xml
| From: | Yannick Torres | Date: | Mon, 29 Dec 2008 21:40:27 +0000 |
| Subject: | cvs: phpdoc-fr /reference/image examples.xml /reference/image/functions imagesettile.xml imagestringup.xml imagetruecolortopalette.xml imagettfbbox.xml imagewbmp.xml imagexbm.xml iptcembed.xml iptcparse.xml jpeg2wbmp.xml png2wbmp.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6200@lists.php.net to get a copy of this message | ||
yannick Mon Dec 29 21:40:27 2008 UTC
Modified files:
/phpdoc-fr/reference/image/functions imagesettile.xml
imagestringup.xml
imagetruecolortopalette.xml
imagettfbbox.xml imagewbmp.xml
imagexbm.xml iptcembed.xml
iptcparse.xml jpeg2wbmp.xml
png2wbmp.xml
/phpdoc-fr/reference/image examples.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagesettile.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagesettile.xml diff -u phpdoc-fr/reference/image/functions/imagesettile.xml:1.14 phpdoc-fr/reference/image/functions/imagesettile.xml:1.15 --- phpdoc-fr/reference/image/functions/imagesettile.xml:1.14 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagesettile.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagesettile" xmlns="http://docbook.org/ns/docbook"> @@ -48,19 +48,60 @@ <term><parameter>tile</parameter></term> <listitem> <para> - La ressource de l'image à utiliser en tant que carrelage + La ressource de l'image à utiliser en tant que carrelage. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagesettile</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chargement d'une image externe +$zend = imagecreatefromgif('./zend.gif'); + +// Création d'une image de 200x200 pixels +$im = imagecreatetruecolor(200, 200); + +// Définition du carrelage +imagesettile($im, $zend); + +// Répétition de l'image +imagefilledrectangle($im, 0, 0, 199, 199, IMG_COLOR_TILED); + +// Affichage vers le navigateur +header('Content-Type: image/png'); + +imagepng($im); +imagedestroy($im); +imagedestroy($zend); +?> +]]> + </programlisting> + &example.outputs.similar; + <mediaobject> + <imageobject> + <imagedata fileref="figures/image.imagesettile.png"/> + </imageobject> + </mediaobject> + </example> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagestringup.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/image/functions/imagestringup.xml diff -u phpdoc-fr/reference/image/functions/imagestringup.xml:1.15 phpdoc-fr/reference/image/functions/imagestringup.xml:1.16 --- phpdoc-fr/reference/image/functions/imagestringup.xml:1.15 Mon Apr 14 18:30:07 2008 +++ phpdoc-fr/reference/image/functions/imagestringup.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagestringup" xmlns="http://docbook.org/ns/docbook"> @@ -34,7 +34,7 @@ <term><parameter>x</parameter></term> <listitem> <para> - X : coordonnée du coin en haut, à gauche + X : coordonnée du coin en haut, à gauche. </para> </listitem> </varlistentry> @@ -42,7 +42,7 @@ <term><parameter>y</parameter></term> <listitem> <para> - Y : coordonnée du coin en haut, à gauche + Y : coordonnée du coin en haut, à gauche. </para> </listitem> </varlistentry> @@ -50,7 +50,7 @@ <term><parameter>string</parameter></term> <listitem> <para> - La &string; à écrire + La &string; à écrire. </para> </listitem> </varlistentry> @@ -59,19 +59,52 @@ <listitem> <para> Un identifiant de couleur créé par la fonction - <function>imagecolorallocate</function> + <function>imagecolorallocate</function>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagestring</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image de 100*100 pixels +$im = imagecreatetruecolor(100, 100); + +// Dessine un texte +$textcolor = imagecolorallocate($im, 0xFF, 0xFF, 0xFF); +imagestringup($im, 3, 40, 80, 'gd library', $textcolor); + +// Sauvegarde l'image +imagepng($im, './stringup.png'); +imagedestroy($im); +?> +]]> + </programlisting> + &example.outputs.similar; + <mediaobject> + <imageobject> + <imagedata fileref="figures/image.imagestringup.png"/> + </imageobject> + </mediaobject> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml?r1=1.19&r2=1.20&diff_format=u Index: phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml diff -u phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml:1.19 phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml:1.20 --- phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml:1.19 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.20 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagetruecolortopalette" xmlns="http://docbook.org/ns/docbook"> @@ -28,6 +28,7 @@ meilleur rendu. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -54,12 +55,38 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Convertion d'une image truecolor en une palette</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image truecolor +$im = new imagecreatetruecolor(100, 100); + +// Convertion en palette de 255 couleurs +imagetruecolortopalette($im, false, 255); + +// Sauvegarde de l'image +imagepng($im, './paletteimage.png'); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.gd.2; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagettfbbox.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/image/functions/imagettfbbox.xml diff -u phpdoc-fr/reference/image/functions/imagettfbbox.xml:1.18 phpdoc-fr/reference/image/functions/imagettfbbox.xml:1.19 --- phpdoc-fr/reference/image/functions/imagettfbbox.xml:1.18 Sat Jun 21 20:51:34 2008 +++ phpdoc-fr/reference/image/functions/imagettfbbox.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagettfbbox" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -30,7 +30,8 @@ <term><parameter>size</parameter></term> <listitem> <para> - La taille de la police, en pixels + La taille de la police. Suivant votre version de GD, ce + paramètre devra être spécifié en pixels (GD1) ou en point (GD2). </para> </listitem> </varlistentry> @@ -38,7 +39,8 @@ <term><parameter>angle</parameter></term> <listitem> <para> - L'angle, en degrés, dans lequel le paramètre <parameter>text</parameter> sera mesuré + L'angle, en degrés, dans lequel le paramètre <parameter>text</parameter> + sera mesuré. </para> </listitem> </varlistentry> @@ -47,9 +49,10 @@ <listitem> <para> Le nom de la police TrueType (peut être une URL). - Suivant la version de la bibliothèque GD utilisée par PHP, ce paramètre peut chercher des fichiers - qui ne commence pas par un slash ("<literal>/</literal>") de fin mais plutôt - <literal>.ttf</literal> et cherchera tout le long des chemins de fonts définis. + Suivant la version de la bibliothèque GD utilisée par PHP, ce paramètre + peut chercher des fichiers qui ne commence pas par un slash + ("<literal>/</literal>") de fin mais plutôt <literal>.ttf</literal> et + cherchera tout le long des chemins de fonts définis. </para> </listitem> </varlistentry> @@ -57,13 +60,14 @@ <term><parameter>text</parameter></term> <listitem> <para> - La chaîne à mesurer + La chaîne à mesurer. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -116,8 +120,60 @@ horizontalement. </para> </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>imagettfbbox</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image de 300x150 pixels +$im = imagecreatetruecolor(300, 150); +$black = imagecolorallocate($im, 0, 0, 0); +$white = imagecolorallocate($im, 255, 255, 255); + +// Définit l'arrière-plan en blanc +imagefilledrectangle($im, 0, 0, 299, 299, $white); + +// Chemin vers le fichier de police +$font = './arial.ttf'; + +// Tout d'abord, nous créons notre rectangle entourant notre premier texte +$bbox = imagettfbbox(10, 45, $font, 'Powered by PHP ' . phpversion()); + +// Nos coordonnées en X et en Y +$x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) - 25; +$y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5; + +// Dessin du texte +imagettftext($im, 10, 45, $x, $y, $black, $font, 'Powered by PHP ' . phpversion()); + +// Nous créons notre rectangle entourant notre second texte +$bbox = imagettfbbox(10, 45, $font, 'and Zend Engine ' . zend_version()); + +// Définit les coordonnées afin que le second text suive le premier +$x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) + 10; +$y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5; + +// Dessin du texte +imagettftext($im, 10, 45, $x, $y, $black, $font, 'and Zend Engine ' . zend_version()); + +// Affichage vers le navigateur +header('Content-type: image/png'); + +imagepng($im); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Cette fonction nécessite la bibliothèque GD et la bibliothèque http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagewbmp.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/image/functions/imagewbmp.xml diff -u phpdoc-fr/reference/image/functions/imagewbmp.xml:1.18 phpdoc-fr/reference/image/functions/imagewbmp.xml:1.19 --- phpdoc-fr/reference/image/functions/imagewbmp.xml:1.18 Sat Jun 21 20:51:34 2008 +++ phpdoc-fr/reference/image/functions/imagewbmp.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.imagewbmp" xmlns="http://docbook.org/ns/docbook"> @@ -21,6 +21,7 @@ <acronym>WBMP</acronym> de l'image <parameter>image</parameter>. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -48,12 +49,89 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Affichage d'une image WBMP</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Définit le contenu de l'en-tête - dans ce cas, image/vnd.wap.wbmp +// Hint: see image_type_to_mime_type() for content-types +header('Content-type: image/vnd.wap.wbmp'); + +// Affichage de l'image +imagewbmp($im); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Sauvegarde de l'image WBMP</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Sauvegarde de l'image +imagewbmp($im, 'simpletext.wbmp'); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Affichage de l'image avec un premier-plan différent</title> + <programlisting role="php"> +<![CDATA[ +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Définit le contenu de l'en-tête - dans ce cas, image/vnd.wap.wbmp +// Astuce : voir la fonction image_type_to_mime_type() pour les types de contenu +header('Content-type: image/vnd.wap.wbmp'); + +// Définit un premier-plan +$foreground_color = imagecolorallocate($im, 255, 0, 0); + +imagewbmp($im, NULL, $foreground_color); + +// Libération de la mémoire +imagedestroy($im); +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> @@ -63,6 +141,7 @@ </para> </note> </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagexbm.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/image/functions/imagexbm.xml diff -u phpdoc-fr/reference/image/functions/imagexbm.xml:1.10 phpdoc-fr/reference/image/functions/imagexbm.xml:1.11 --- phpdoc-fr/reference/image/functions/imagexbm.xml:1.10 Mon Apr 14 18:30:07 2008 +++ phpdoc-fr/reference/image/functions/imagexbm.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagexbm" xmlns="http://docbook.org/ns/docbook"> @@ -21,6 +21,7 @@ de l'image <parameter>image</parameter>. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -48,12 +49,63 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Sauvegarde d'un fichier XBM</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Sauvegarde de l'image +imagexbm($im, 'simpletext.xbm'); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Sauvegarde d'un fichier XBM avec une couleur de premier-plan différente</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Définit la couleur de premier-plan +$foreground_color = imagecolorallocate($im, 255, 0, 0); + +// Sauvegarde de l'image +imagexbm($im, NULL, $foreground_color); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.bundled.gd; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/iptcembed.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/image/functions/iptcembed.xml diff -u phpdoc-fr/reference/image/functions/iptcembed.xml:1.11 phpdoc-fr/reference/image/functions/iptcembed.xml:1.12 --- phpdoc-fr/reference/image/functions/iptcembed.xml:1.11 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/iptcembed.xml Mon Dec 29 21:40:27 2008 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry xml:id='function.iptcembed' xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -16,10 +16,8 @@ <methodparam><type>string</type><parameter>jpeg_file_name</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>spool</parameter></methodparam> </methodsynopsis> - <para> - &warn.undocumented.func; - </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -28,6 +26,7 @@ <term><parameter>iptcdata</parameter></term> <listitem> <para> + Les données à écrire. </para> </listitem> </varlistentry> @@ -35,6 +34,7 @@ <term><parameter>jpeg_file_name</parameter></term> <listitem> <para> + Chemin vers le fichier JPEG. </para> </listitem> </varlistentry> @@ -42,12 +42,96 @@ <term><parameter>spool</parameter></term> <listitem> <para> + La bobine. Si la bobine est supérieure à 2, alors le fichier JPEG + sera retourné sous la forme d'une chaîne de caractères. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + En cas de succès et si la bobine est supérieure à 2, alors le fichier JPEG + sera retourné sous la forme d'une chaîne de caractères, ou &false; si une + erreur survient. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Embarquement de données IPTC dans une image JPEG</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Fonction iptc_make_tag() par Thies C. Arntzen +function iptc_make_tag($rec, $data, $value) +{ + $length = strlen($value); + $retval = chr(0x1C) . chr($rec) . chr($data); + + if($length < 0x8000) + { + $retval .= chr($length >> 8) . chr($length & 0xFF); + } + else + { + $retval .= chr(0x80) . + chr(0x04) . + chr(($length >> 24) & 0xFF) . + chr(($length >> 16) & 0xFF) . + chr(($length >> 8) & 0xFF) . + chr($length & 0xFF); + } + + return $retval . $value; +} + +// Chemin vers le fichier JPEG +$path = './phplogo.jpg'; + +// Nous devons vérifier s'il y a des données IPTC dans l'image JPEG. S'il y en +// a, alors nous stoppons le script car nous ne pouvons intégrer une image +// contenant déjà des données IPTC ! +$image = getimagesize($path, $info); + +if(isset($info['APP13'])) +{ + die('Erreur : Données IPTC trouvées dans l\'image, nous ne pouvons continuer'); +} + +// Définit le drapeau IPTC +$iptc = array( + '2#120' => 'Test image', + '2#116' => 'Copyright 2008, The PHP Group' +); + +// Convertion du drapeau IPTC en code binaire +$data = ''; + +foreach($iptc as $tag => $string) +{ + $tag = substr($tag, 2); + $data .= iptc_make_tag(2, substr($tag, 2), $string); +} + +// Intégration des données IPTC +$content = iptcembed($data, $path); +?> +]]> + </programlisting> + </example> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Cette fonction ne nécessite pas la bibliothèque GD. + </para> + </note> + </refsect1> </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/iptcparse.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/image/functions/iptcparse.xml diff -u phpdoc-fr/reference/image/functions/iptcparse.xml:1.13 phpdoc-fr/reference/image/functions/iptcparse.xml:1.14 --- phpdoc-fr/reference/image/functions/iptcparse.xml:1.13 Mon Apr 14 23:58:18 2008 +++ phpdoc-fr/reference/image/functions/iptcparse.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.iptcparse" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -18,6 +18,7 @@ Analyse un bloc binaire <link xlink:href="&url.iptc;">IPTC</link> et recherche les balises simples. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -26,13 +27,14 @@ <term><parameter>iptcblock</parameter></term> <listitem> <para> - Un bloc binaire IPTC + Un bloc binaire IPTC. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -42,14 +44,35 @@ fonction retourne &false;. </para> </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; + + <refsect1 role="examples"> + &reftitle.examples; <para> - <simplelist> - <member>Voyez un exemple sur <function>getimagesize</function></member> - </simplelist> + <example> + <title>Exemple avec iptcparse() et <function>getimagesize</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$size = getimagesize('./test.jpg', $info); +if(isset($info['APP13'])) +{ + $iptc = iptcparse($info['APP13']); + var_dump($iptc); +} +?> +]]> + </programlisting> + </example> </para> </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Cette fonction ne nécessite pas la bibliothèque GD. + </para> + </note> + </refsect1> </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/jpeg2wbmp.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/jpeg2wbmp.xml diff -u phpdoc-fr/reference/image/functions/jpeg2wbmp.xml:1.14 phpdoc-fr/reference/image/functions/jpeg2wbmp.xml:1.15 --- phpdoc-fr/reference/image/functions/jpeg2wbmp.xml:1.14 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/jpeg2wbmp.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.jpeg2wbmp" xmlns="http://docbook.org/ns/docbook"> @@ -30,7 +30,7 @@ <term><parameter>jpegname</parameter></term> <listitem> <para> - Le chemin vers le fichier JPEG + Le chemin vers le fichier JPEG. </para> </listitem> </varlistentry> @@ -38,7 +38,7 @@ <term><parameter>wbmpname</parameter></term> <listitem> <para> - Chemin vers le fichier final WBMP + Chemin vers le fichier final WBMP. </para> </listitem> </varlistentry> @@ -46,7 +46,7 @@ <term><parameter>dest_height</parameter></term> <listitem> <para> - Hauteur de l'image de destination + Hauteur de l'image de destination. </para> </listitem> </varlistentry> @@ -54,7 +54,7 @@ <term><parameter>dest_width</parameter></term> <listitem> <para> - Largeur de l'image de destination + Largeur de l'image de destination. </para> </listitem> </varlistentry> @@ -62,23 +62,50 @@ <term><parameter>threshold</parameter></term> <listitem> <para> + Valeur du seuil, entre 0 et 8 inclus. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>jpeg2wbmp</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chemin vers la cible jpeg +$path = './test.jpg'; + +// Récupération de la taille de l'image +$image = getimagesize($path); + +// Convertion de l'image +jpeg2wbmp($path, './test.wbmp', $image[1], $image[0], 5); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.config.wbmp; ¬e.config.jpeg; </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/png2wbmp.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/image/functions/png2wbmp.xml diff -u phpdoc-fr/reference/image/functions/png2wbmp.xml:1.15 phpdoc-fr/reference/image/functions/png2wbmp.xml:1.16 --- phpdoc-fr/reference/image/functions/png2wbmp.xml:1.15 Mon Apr 14 23:58:18 2008 +++ phpdoc-fr/reference/image/functions/png2wbmp.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.png2wbmp" xmlns="http://docbook.org/ns/docbook"> @@ -30,7 +30,7 @@ <term><parameter>pngname</parameter></term> <listitem> <para> - Chemin vers le fichier PNG + Chemin vers le fichier PNG. </para> </listitem> </varlistentry> @@ -38,7 +38,7 @@ <term><parameter>wbmpname</parameter></term> <listitem> <para> - Chemin vers le fichier final WBMP + Chemin vers le fichier final WBMP. </para> </listitem> </varlistentry> @@ -46,7 +46,7 @@ <term><parameter>dest_height</parameter></term> <listitem> <para> - Hauteur de l'image de destination + Hauteur de l'image de destination. </para> </listitem> </varlistentry> @@ -54,7 +54,7 @@ <term><parameter>dest_width</parameter></term> <listitem> <para> - Largeur de l'image de destination + Largeur de l'image de destination. </para> </listitem> </varlistentry> @@ -62,22 +62,49 @@ <term><parameter>threshold</parameter></term> <listitem> <para> + Valeur du seuil, entre 0 et 8 inclus. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>png2wbmp</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chemin vers la cible png +$path = './test.png'; + +// Récupération de la taille de l'image +$image = getimagesize($path); + +// Convertion de l'image +png2wbmp($path, './test.wbmp', $image[1], $image[0], 7); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.config.wbmp; </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/examples.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/image/examples.xml diff -u phpdoc-fr/reference/image/examples.xml:1.4 phpdoc-fr/reference/image/examples.xml:1.5 --- phpdoc-fr/reference/image/examples.xml:1.4 Sat Jun 21 20:51:34 2008 +++ phpdoc-fr/reference/image/examples.xml Mon Dec 29 21:40:27 2008 @@ -1,14 +1,14 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <chapter xml:id="image.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <section xml:id="image.examples-png"> <para> <example> - <title>Création d'une image PNG avec PHP</title> + <title>Création d'une image PNG avec PHP</title> <programlisting role="php"> <![CDATA[ <?php @@ -26,14 +26,104 @@ ]]> </programlisting> </example> - Cet exemple doit être appelé depuis une page HTML avec une balise + Cet exemple doit être appelé depuis une page HTML avec une balise image telle que : <literal><img src="button.php?text"></literal>. - Le script ci-dessus, <filename>button.php</filename>, prend la chaîne + Le script ci-dessus, <filename>button.php</filename>, prend la chaîne <literal>"texte"</literal> et l'inscrit - sur le fond d'image appelé <literal>"images/button1.png"</literal>, - puis l'affiche. C'est une méthode très pratique pour éviter de redessinner un - nouveau bouton, dès que vous changez son texte. De cette façon, ils sont - générés dynamiquement. + sur le fond d'image appelé <literal>"images/button1.png"</literal>, + puis l'affiche. C'est une méthode très pratique pour éviter de redessinner un + nouveau bouton, dès que vous changez son texte. De cette façon, ils sont + générés dynamiquement. + </para> + </section> + <section xml:id="image.examples-watermark"> + <para> + <example> + <title>Ajout d'un tatouage numérique sur des images en utilisant un canal Alpha</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Charge le cachet et la photo afin d'y appliquer le tatouage numérique +$stamp = imagecreatefrompng('stamp.png'); +$im = imagecreatefromjpeg('photo.jpeg'); + +// Définit les marges pour le cachet et récupère la hauteur et la largeur de celui-ci +$marge_right = 10; +$marge_bottom = 10; +$sx = imagesx($stamp); +$sy = imagesy($stamp); + +// Copie le cachet sur la photo en utilisant les marges et la largeur de la +// photo originale afin de calculer la position du cachet +imagecopy($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp)); + +// Affichage et libération de la mémoire +header('Content-type: image/png'); +imagepng($im); +imagedestroy($im); +?> +]]> + </programlisting> + <mediaobject> + <imageobject> + <imagedata fileref="figures/image.watermarks.png" /> + </imageobject> + </mediaobject> + </example> + Cet exemple montre un moyen simple d'appliquer un tatouage numérique + et un cachet à vos photos et vos images sous licence. + Notez la présence d'un canal Alpha dans le cachet ainsi que du texte + anti-aliasé. Ces 2 éléments seront préservés lors de la copie. + </para> + </section> + <section xml:id="image.examples.merged-watermark"> + <para> + <example> + <title>Exemple avec <function>imagecopymerge</function> pour créer un + tatouage numérique translucide</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Charge le cachet et la photo afin d'y appliquer le tatouage numérique +$im = imagecreatefromjpeg('photo.jpeg'); + +// Tout d'abord, nous créons un cachet manuellement grâce à GD +$stamp = imagecreatetruecolor(100, 70); +imagefilledrectangle($stamp, 0,0, 99, 99, 0x0000FF); +imagefilledrectangle($stamp, 9,9, 90,60, 0xFFFFFF); +$im = imagecreatefromjpeg('photo.jpeg'); +imagestring($stamp, 5, 20, 20, 'libGD', 0x0000FF); +imagestring($stamp, 3, 20, 40, '(c) 2007-8', 0x0000FF); + +// Définit les marges du cachet et récupère la largeur et la hauteur du cachet +$marge_right = 10; +$marge_bottom = 10; +$sx = imagesx($stamp); +$sy = imagesy($stamp); + +// Fusionne le cachet dans notre photo avec une opacité (transparence) de 50% +imagecopymerge($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp), 50); + +// Sauvegarde l'image dans un fichier et libère la mémoire +imagepng($im, 'photo_stamp.png'); +imagedestroy($im); + +?> +]]> + </programlisting> + <mediaobject> + <imageobject> + <imagedata fileref="figures/image.watermark-merged.png" /> + </imageobject> + </mediaobject> + </example> + Cet exemple utilise la fonction <function>imagecopymerge</function> + pour fusionner le cachet avec notre image original. En utilisant cette + fonction, nous pouvons définir l'opacité de notre cachet - dans notre + exemple, nous l'avons défini à 50%. En pratique, il est plus judicieux + de rendre notre protection semi-transparente, la rendant plus difficile à + enlever mais permettant également aux visionneuses d'images de la lire sans + problème. </para> </section> </chapter>
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagesettile.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagesettile.xml diff -u phpdoc-fr/reference/image/functions/imagesettile.xml:1.14 phpdoc-fr/reference/image/functions/imagesettile.xml:1.15 --- phpdoc-fr/reference/image/functions/imagesettile.xml:1.14 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagesettile.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagesettile" xmlns="http://docbook.org/ns/docbook"> @@ -48,19 +48,60 @@ <term><parameter>tile</parameter></term> <listitem> <para> - La ressource de l'image à utiliser en tant que carrelage + La ressource de l'image à utiliser en tant que carrelage. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagesettile</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chargement d'une image externe +$zend = imagecreatefromgif('./zend.gif'); + +// Création d'une image de 200x200 pixels +$im = imagecreatetruecolor(200, 200); + +// Définition du carrelage +imagesettile($im, $zend); + +// Répétition de l'image +imagefilledrectangle($im, 0, 0, 199, 199, IMG_COLOR_TILED); + +// Affichage vers le navigateur +header('Content-Type: image/png'); + +imagepng($im); +imagedestroy($im); +imagedestroy($zend); +?> +]]> + </programlisting> + &example.outputs.similar; + <mediaobject> + <imageobject> + <imagedata fileref="figures/image.imagesettile.png"/> + </imageobject> + </mediaobject> + </example> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagestringup.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/image/functions/imagestringup.xml diff -u phpdoc-fr/reference/image/functions/imagestringup.xml:1.15 phpdoc-fr/reference/image/functions/imagestringup.xml:1.16 --- phpdoc-fr/reference/image/functions/imagestringup.xml:1.15 Mon Apr 14 18:30:07 2008 +++ phpdoc-fr/reference/image/functions/imagestringup.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagestringup" xmlns="http://docbook.org/ns/docbook"> @@ -34,7 +34,7 @@ <term><parameter>x</parameter></term> <listitem> <para> - X : coordonnée du coin en haut, à gauche + X : coordonnée du coin en haut, à gauche. </para> </listitem> </varlistentry> @@ -42,7 +42,7 @@ <term><parameter>y</parameter></term> <listitem> <para> - Y : coordonnée du coin en haut, à gauche + Y : coordonnée du coin en haut, à gauche. </para> </listitem> </varlistentry> @@ -50,7 +50,7 @@ <term><parameter>string</parameter></term> <listitem> <para> - La &string; à écrire + La &string; à écrire. </para> </listitem> </varlistentry> @@ -59,19 +59,52 @@ <listitem> <para> Un identifiant de couleur créé par la fonction - <function>imagecolorallocate</function> + <function>imagecolorallocate</function>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagestring</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image de 100*100 pixels +$im = imagecreatetruecolor(100, 100); + +// Dessine un texte +$textcolor = imagecolorallocate($im, 0xFF, 0xFF, 0xFF); +imagestringup($im, 3, 40, 80, 'gd library', $textcolor); + +// Sauvegarde l'image +imagepng($im, './stringup.png'); +imagedestroy($im); +?> +]]> + </programlisting> + &example.outputs.similar; + <mediaobject> + <imageobject> + <imagedata fileref="figures/image.imagestringup.png"/> + </imageobject> + </mediaobject> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml?r1=1.19&r2=1.20&diff_format=u Index: phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml diff -u phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml:1.19 phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml:1.20 --- phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml:1.19 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagetruecolortopalette.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.20 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagetruecolortopalette" xmlns="http://docbook.org/ns/docbook"> @@ -28,6 +28,7 @@ meilleur rendu. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -54,12 +55,38 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Convertion d'une image truecolor en une palette</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image truecolor +$im = new imagecreatetruecolor(100, 100); + +// Convertion en palette de 255 couleurs +imagetruecolortopalette($im, false, 255); + +// Sauvegarde de l'image +imagepng($im, './paletteimage.png'); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.gd.2; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagettfbbox.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/image/functions/imagettfbbox.xml diff -u phpdoc-fr/reference/image/functions/imagettfbbox.xml:1.18 phpdoc-fr/reference/image/functions/imagettfbbox.xml:1.19 --- phpdoc-fr/reference/image/functions/imagettfbbox.xml:1.18 Sat Jun 21 20:51:34 2008 +++ phpdoc-fr/reference/image/functions/imagettfbbox.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagettfbbox" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -30,7 +30,8 @@ <term><parameter>size</parameter></term> <listitem> <para> - La taille de la police, en pixels + La taille de la police. Suivant votre version de GD, ce + paramètre devra être spécifié en pixels (GD1) ou en point (GD2). </para> </listitem> </varlistentry> @@ -38,7 +39,8 @@ <term><parameter>angle</parameter></term> <listitem> <para> - L'angle, en degrés, dans lequel le paramètre <parameter>text</parameter> sera mesuré + L'angle, en degrés, dans lequel le paramètre <parameter>text</parameter> + sera mesuré. </para> </listitem> </varlistentry> @@ -47,9 +49,10 @@ <listitem> <para> Le nom de la police TrueType (peut être une URL). - Suivant la version de la bibliothèque GD utilisée par PHP, ce paramètre peut chercher des fichiers - qui ne commence pas par un slash ("<literal>/</literal>") de fin mais plutôt - <literal>.ttf</literal> et cherchera tout le long des chemins de fonts définis. + Suivant la version de la bibliothèque GD utilisée par PHP, ce paramètre + peut chercher des fichiers qui ne commence pas par un slash + ("<literal>/</literal>") de fin mais plutôt <literal>.ttf</literal> et + cherchera tout le long des chemins de fonts définis. </para> </listitem> </varlistentry> @@ -57,13 +60,14 @@ <term><parameter>text</parameter></term> <listitem> <para> - La chaîne à mesurer + La chaîne à mesurer. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -116,8 +120,60 @@ horizontalement. </para> </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>imagettfbbox</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image de 300x150 pixels +$im = imagecreatetruecolor(300, 150); +$black = imagecolorallocate($im, 0, 0, 0); +$white = imagecolorallocate($im, 255, 255, 255); + +// Définit l'arrière-plan en blanc +imagefilledrectangle($im, 0, 0, 299, 299, $white); + +// Chemin vers le fichier de police +$font = './arial.ttf'; + +// Tout d'abord, nous créons notre rectangle entourant notre premier texte +$bbox = imagettfbbox(10, 45, $font, 'Powered by PHP ' . phpversion()); + +// Nos coordonnées en X et en Y +$x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) - 25; +$y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5; + +// Dessin du texte +imagettftext($im, 10, 45, $x, $y, $black, $font, 'Powered by PHP ' . phpversion()); + +// Nous créons notre rectangle entourant notre second texte +$bbox = imagettfbbox(10, 45, $font, 'and Zend Engine ' . zend_version()); + +// Définit les coordonnées afin que le second text suive le premier +$x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) + 10; +$y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5; + +// Dessin du texte +imagettftext($im, 10, 45, $x, $y, $black, $font, 'and Zend Engine ' . zend_version()); + +// Affichage vers le navigateur +header('Content-type: image/png'); + +imagepng($im); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Cette fonction nécessite la bibliothèque GD et la bibliothèque http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagewbmp.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/image/functions/imagewbmp.xml diff -u phpdoc-fr/reference/image/functions/imagewbmp.xml:1.18 phpdoc-fr/reference/image/functions/imagewbmp.xml:1.19 --- phpdoc-fr/reference/image/functions/imagewbmp.xml:1.18 Sat Jun 21 20:51:34 2008 +++ phpdoc-fr/reference/image/functions/imagewbmp.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.imagewbmp" xmlns="http://docbook.org/ns/docbook"> @@ -21,6 +21,7 @@ <acronym>WBMP</acronym> de l'image <parameter>image</parameter>. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -48,12 +49,89 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Affichage d'une image WBMP</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Définit le contenu de l'en-tête - dans ce cas, image/vnd.wap.wbmp +// Hint: see image_type_to_mime_type() for content-types +header('Content-type: image/vnd.wap.wbmp'); + +// Affichage de l'image +imagewbmp($im); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Sauvegarde de l'image WBMP</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Sauvegarde de l'image +imagewbmp($im, 'simpletext.wbmp'); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Affichage de l'image avec un premier-plan différent</title> + <programlisting role="php"> +<![CDATA[ +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Définit le contenu de l'en-tête - dans ce cas, image/vnd.wap.wbmp +// Astuce : voir la fonction image_type_to_mime_type() pour les types de contenu +header('Content-type: image/vnd.wap.wbmp'); + +// Définit un premier-plan +$foreground_color = imagecolorallocate($im, 255, 0, 0); + +imagewbmp($im, NULL, $foreground_color); + +// Libération de la mémoire +imagedestroy($im); +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> @@ -63,6 +141,7 @@ </para> </note> </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagexbm.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/image/functions/imagexbm.xml diff -u phpdoc-fr/reference/image/functions/imagexbm.xml:1.10 phpdoc-fr/reference/image/functions/imagexbm.xml:1.11 --- phpdoc-fr/reference/image/functions/imagexbm.xml:1.10 Mon Apr 14 18:30:07 2008 +++ phpdoc-fr/reference/image/functions/imagexbm.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagexbm" xmlns="http://docbook.org/ns/docbook"> @@ -21,6 +21,7 @@ de l'image <parameter>image</parameter>. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -48,12 +49,63 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Sauvegarde d'un fichier XBM</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Sauvegarde de l'image +imagexbm($im, 'simpletext.xbm'); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Sauvegarde d'un fichier XBM avec une couleur de premier-plan différente</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, 'Un texte simple', $text_color); + +// Définit la couleur de premier-plan +$foreground_color = imagecolorallocate($im, 255, 0, 0); + +// Sauvegarde de l'image +imagexbm($im, NULL, $foreground_color); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.bundled.gd; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/iptcembed.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/image/functions/iptcembed.xml diff -u phpdoc-fr/reference/image/functions/iptcembed.xml:1.11 phpdoc-fr/reference/image/functions/iptcembed.xml:1.12 --- phpdoc-fr/reference/image/functions/iptcembed.xml:1.11 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/iptcembed.xml Mon Dec 29 21:40:27 2008 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry xml:id='function.iptcembed' xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -16,10 +16,8 @@ <methodparam><type>string</type><parameter>jpeg_file_name</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>spool</parameter></methodparam> </methodsynopsis> - <para> - &warn.undocumented.func; - </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -28,6 +26,7 @@ <term><parameter>iptcdata</parameter></term> <listitem> <para> + Les données à écrire. </para> </listitem> </varlistentry> @@ -35,6 +34,7 @@ <term><parameter>jpeg_file_name</parameter></term> <listitem> <para> + Chemin vers le fichier JPEG. </para> </listitem> </varlistentry> @@ -42,12 +42,96 @@ <term><parameter>spool</parameter></term> <listitem> <para> + La bobine. Si la bobine est supérieure à 2, alors le fichier JPEG + sera retourné sous la forme d'une chaîne de caractères. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + En cas de succès et si la bobine est supérieure à 2, alors le fichier JPEG + sera retourné sous la forme d'une chaîne de caractères, ou &false; si une + erreur survient. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Embarquement de données IPTC dans une image JPEG</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Fonction iptc_make_tag() par Thies C. Arntzen +function iptc_make_tag($rec, $data, $value) +{ + $length = strlen($value); + $retval = chr(0x1C) . chr($rec) . chr($data); + + if($length < 0x8000) + { + $retval .= chr($length >> 8) . chr($length & 0xFF); + } + else + { + $retval .= chr(0x80) . + chr(0x04) . + chr(($length >> 24) & 0xFF) . + chr(($length >> 16) & 0xFF) . + chr(($length >> 8) & 0xFF) . + chr($length & 0xFF); + } + + return $retval . $value; +} + +// Chemin vers le fichier JPEG +$path = './phplogo.jpg'; + +// Nous devons vérifier s'il y a des données IPTC dans l'image JPEG. S'il y en +// a, alors nous stoppons le script car nous ne pouvons intégrer une image +// contenant déjà des données IPTC ! +$image = getimagesize($path, $info); + +if(isset($info['APP13'])) +{ + die('Erreur : Données IPTC trouvées dans l\'image, nous ne pouvons continuer'); +} + +// Définit le drapeau IPTC +$iptc = array( + '2#120' => 'Test image', + '2#116' => 'Copyright 2008, The PHP Group' +); + +// Convertion du drapeau IPTC en code binaire +$data = ''; + +foreach($iptc as $tag => $string) +{ + $tag = substr($tag, 2); + $data .= iptc_make_tag(2, substr($tag, 2), $string); +} + +// Intégration des données IPTC +$content = iptcembed($data, $path); +?> +]]> + </programlisting> + </example> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Cette fonction ne nécessite pas la bibliothèque GD. + </para> + </note> + </refsect1> </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/iptcparse.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/image/functions/iptcparse.xml diff -u phpdoc-fr/reference/image/functions/iptcparse.xml:1.13 phpdoc-fr/reference/image/functions/iptcparse.xml:1.14 --- phpdoc-fr/reference/image/functions/iptcparse.xml:1.13 Mon Apr 14 23:58:18 2008 +++ phpdoc-fr/reference/image/functions/iptcparse.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.iptcparse" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -18,6 +18,7 @@ Analyse un bloc binaire <link xlink:href="&url.iptc;">IPTC</link> et recherche les balises simples. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -26,13 +27,14 @@ <term><parameter>iptcblock</parameter></term> <listitem> <para> - Un bloc binaire IPTC + Un bloc binaire IPTC. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -42,14 +44,35 @@ fonction retourne &false;. </para> </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; + + <refsect1 role="examples"> + &reftitle.examples; <para> - <simplelist> - <member>Voyez un exemple sur <function>getimagesize</function></member> - </simplelist> + <example> + <title>Exemple avec iptcparse() et <function>getimagesize</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$size = getimagesize('./test.jpg', $info); +if(isset($info['APP13'])) +{ + $iptc = iptcparse($info['APP13']); + var_dump($iptc); +} +?> +]]> + </programlisting> + </example> </para> </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Cette fonction ne nécessite pas la bibliothèque GD. + </para> + </note> + </refsect1> </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/jpeg2wbmp.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/jpeg2wbmp.xml diff -u phpdoc-fr/reference/image/functions/jpeg2wbmp.xml:1.14 phpdoc-fr/reference/image/functions/jpeg2wbmp.xml:1.15 --- phpdoc-fr/reference/image/functions/jpeg2wbmp.xml:1.14 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/jpeg2wbmp.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.jpeg2wbmp" xmlns="http://docbook.org/ns/docbook"> @@ -30,7 +30,7 @@ <term><parameter>jpegname</parameter></term> <listitem> <para> - Le chemin vers le fichier JPEG + Le chemin vers le fichier JPEG. </para> </listitem> </varlistentry> @@ -38,7 +38,7 @@ <term><parameter>wbmpname</parameter></term> <listitem> <para> - Chemin vers le fichier final WBMP + Chemin vers le fichier final WBMP. </para> </listitem> </varlistentry> @@ -46,7 +46,7 @@ <term><parameter>dest_height</parameter></term> <listitem> <para> - Hauteur de l'image de destination + Hauteur de l'image de destination. </para> </listitem> </varlistentry> @@ -54,7 +54,7 @@ <term><parameter>dest_width</parameter></term> <listitem> <para> - Largeur de l'image de destination + Largeur de l'image de destination. </para> </listitem> </varlistentry> @@ -62,23 +62,50 @@ <term><parameter>threshold</parameter></term> <listitem> <para> + Valeur du seuil, entre 0 et 8 inclus. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>jpeg2wbmp</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chemin vers la cible jpeg +$path = './test.jpg'; + +// Récupération de la taille de l'image +$image = getimagesize($path); + +// Convertion de l'image +jpeg2wbmp($path, './test.wbmp', $image[1], $image[0], 5); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.config.wbmp; ¬e.config.jpeg; </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/png2wbmp.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/image/functions/png2wbmp.xml diff -u phpdoc-fr/reference/image/functions/png2wbmp.xml:1.15 phpdoc-fr/reference/image/functions/png2wbmp.xml:1.16 --- phpdoc-fr/reference/image/functions/png2wbmp.xml:1.15 Mon Apr 14 23:58:18 2008 +++ phpdoc-fr/reference/image/functions/png2wbmp.xml Mon Dec 29 21:40:27 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.png2wbmp" xmlns="http://docbook.org/ns/docbook"> @@ -30,7 +30,7 @@ <term><parameter>pngname</parameter></term> <listitem> <para> - Chemin vers le fichier PNG + Chemin vers le fichier PNG. </para> </listitem> </varlistentry> @@ -38,7 +38,7 @@ <term><parameter>wbmpname</parameter></term> <listitem> <para> - Chemin vers le fichier final WBMP + Chemin vers le fichier final WBMP. </para> </listitem> </varlistentry> @@ -46,7 +46,7 @@ <term><parameter>dest_height</parameter></term> <listitem> <para> - Hauteur de l'image de destination + Hauteur de l'image de destination. </para> </listitem> </varlistentry> @@ -54,7 +54,7 @@ <term><parameter>dest_width</parameter></term> <listitem> <para> - Largeur de l'image de destination + Largeur de l'image de destination. </para> </listitem> </varlistentry> @@ -62,22 +62,49 @@ <term><parameter>threshold</parameter></term> <listitem> <para> + Valeur du seuil, entre 0 et 8 inclus. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>png2wbmp</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chemin vers la cible png +$path = './test.png'; + +// Récupération de la taille de l'image +$image = getimagesize($path); + +// Convertion de l'image +png2wbmp($path, './test.wbmp', $image[1], $image[0], 7); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.config.wbmp; </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/examples.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/image/examples.xml diff -u phpdoc-fr/reference/image/examples.xml:1.4 phpdoc-fr/reference/image/examples.xml:1.5 --- phpdoc-fr/reference/image/examples.xml:1.4 Sat Jun 21 20:51:34 2008 +++ phpdoc-fr/reference/image/examples.xml Mon Dec 29 21:40:27 2008 @@ -1,14 +1,14 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <chapter xml:id="image.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <section xml:id="image.examples-png"> <para> <example> - <title>Création d'une image PNG avec PHP</title> + <title>Création d'une image PNG avec PHP</title> <programlisting role="php"> <![CDATA[ <?php @@ -26,14 +26,104 @@ ]]> </programlisting> </example> - Cet exemple doit être appelé depuis une page HTML avec une balise + Cet exemple doit être appelé depuis une page HTML avec une balise image telle que : <literal><img src="button.php?text"></literal>. - Le script ci-dessus, <filename>button.php</filename>, prend la chaîne + Le script ci-dessus, <filename>button.php</filename>, prend la chaîne <literal>"texte"</literal> et l'inscrit - sur le fond d'image appelé <literal>"images/button1.png"</literal>, - puis l'affiche. C'est une méthode très pratique pour éviter de redessinner un - nouveau bouton, dès que vous changez son texte. De cette façon, ils sont - générés dynamiquement. + sur le fond d'image appelé <literal>"images/button1.png"</literal>, + puis l'affiche. C'est une méthode très pratique pour éviter de redessinner un + nouveau bouton, dès que vous changez son texte. De cette façon, ils sont + générés dynamiquement. + </para> + </section> + <section xml:id="image.examples-watermark"> + <para> + <example> + <title>Ajout d'un tatouage numérique sur des images en utilisant un canal Alpha</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Charge le cachet et la photo afin d'y appliquer le tatouage numérique +$stamp = imagecreatefrompng('stamp.png'); +$im = imagecreatefromjpeg('photo.jpeg'); + +// Définit les marges pour le cachet et récupère la hauteur et la largeur de celui-ci +$marge_right = 10; +$marge_bottom = 10; +$sx = imagesx($stamp); +$sy = imagesy($stamp); + +// Copie le cachet sur la photo en utilisant les marges et la largeur de la +// photo originale afin de calculer la position du cachet +imagecopy($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp)); + +// Affichage et libération de la mémoire +header('Content-type: image/png'); +imagepng($im); +imagedestroy($im); +?> +]]> + </programlisting> + <mediaobject> + <imageobject> + <imagedata fileref="figures/image.watermarks.png" /> + </imageobject> + </mediaobject> + </example> + Cet exemple montre un moyen simple d'appliquer un tatouage numérique + et un cachet à vos photos et vos images sous licence. + Notez la présence d'un canal Alpha dans le cachet ainsi que du texte + anti-aliasé. Ces 2 éléments seront préservés lors de la copie. + </para> + </section> + <section xml:id="image.examples.merged-watermark"> + <para> + <example> + <title>Exemple avec <function>imagecopymerge</function> pour créer un + tatouage numérique translucide</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Charge le cachet et la photo afin d'y appliquer le tatouage numérique +$im = imagecreatefromjpeg('photo.jpeg'); + +// Tout d'abord, nous créons un cachet manuellement grâce à GD +$stamp = imagecreatetruecolor(100, 70); +imagefilledrectangle($stamp, 0,0, 99, 99, 0x0000FF); +imagefilledrectangle($stamp, 9,9, 90,60, 0xFFFFFF); +$im = imagecreatefromjpeg('photo.jpeg'); +imagestring($stamp, 5, 20, 20, 'libGD', 0x0000FF); +imagestring($stamp, 3, 20, 40, '(c) 2007-8', 0x0000FF); + +// Définit les marges du cachet et récupère la largeur et la hauteur du cachet +$marge_right = 10; +$marge_bottom = 10; +$sx = imagesx($stamp); +$sy = imagesy($stamp); + +// Fusionne le cachet dans notre photo avec une opacité (transparence) de 50% +imagecopymerge($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp), 50); + +// Sauvegarde l'image dans un fichier et libère la mémoire +imagepng($im, 'photo_stamp.png'); +imagedestroy($im); + +?> +]]> + </programlisting> + <mediaobject> + <imageobject> + <imagedata fileref="figures/image.watermark-merged.png" /> + </imageobject> + </mediaobject> + </example> + Cet exemple utilise la fonction <function>imagecopymerge</function> + pour fusionner le cachet avec notre image original. En utilisant cette + fonction, nous pouvons définir l'opacité de notre cachet - dans notre + exemple, nous l'avons défini à 50%. En pratique, il est plus judicieux + de rendre notre protection semi-transparente, la rendant plus difficile à + enlever mais permettant également aux visionneuses d'images de la lire sans + problème. </para> </section> </chapter>