didou           Fri Aug 15 18:50:50 2003 EDT

  Modified files:              
    /phpdoc/en/reference/image/functions        exif-read-data.xml gd-info.xml 
                                                getimagesize.xml 
                                                image-type-to-mime-type.xml 
                                                image2wbmp.xml imagechar.xml 
                                                imagecharup.xml 
                                                imagecolorallocate.xml 
                                                imagecolorclosestalpha.xml 
                                                imagecolorsforindex.xml 
                                                imagecreatefromgif.xml 
                                                imagecreatefromjpeg.xml 
                                                imagecreatefrompng.xml 
                                                imagecreatefromwbmp.xml 
                                                imagefilledarc.xml 
                                                imagefilledellipse.xml 
                                                imagefilledpolygon.xml 
  Log:
  integrating users notes
  adding examples
  obfuscating vic's email
  adding documentation to image_type_to_mime_type
  
Index: phpdoc/en/reference/image/functions/exif-read-data.xml
diff -u phpdoc/en/reference/image/functions/exif-read-data.xml:1.8 
phpdoc/en/reference/image/functions/exif-read-data.xml:1.9
--- phpdoc/en/reference/image/functions/exif-read-data.xml:1.8  Mon Jun  9 15:26:05 
2003
+++ phpdoc/en/reference/image/functions/exif-read-data.xml      Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.78 -->
   <refentry id="function.exif-read-data">
    <refnamediv>
@@ -89,6 +89,11 @@
       cameras, but unfortunately each digital camera maker has a different
       idea of how to actually tag their images, so you can't always rely on
       a specific Exif header being present.
+     </para>
+     <para>
+      Windows ME/XP both can wipe the Exif headers when connecting to a camera.
+      More information available at <ulink
+      url="&url.winexif;">&url.winexif;</ulink>.
      </para>
     </note>
     <para>
Index: phpdoc/en/reference/image/functions/gd-info.xml
diff -u phpdoc/en/reference/image/functions/gd-info.xml:1.3 
phpdoc/en/reference/image/functions/gd-info.xml:1.4
--- phpdoc/en/reference/image/functions/gd-info.xml:1.3 Sat Jan 18 12:16:16 2003
+++ phpdoc/en/reference/image/functions/gd-info.xml     Fri Aug 15 18:50:50 2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
   <refentry id='function.gd-info'>
    <refnamediv>
     <refname>gd_info</refname>
@@ -92,10 +92,14 @@
 <![CDATA[
 <?php
 var_dump(gd_info());
-
-/* Typical Output
-   ==============
-
+?>
+]]>
+      </programlisting>
+      <para>
+       The typical output is :
+      </para>
+      <screen>
+<![CDATA[
 array(9) {
   ["GD Version"]=>
   string(24) "bundled (2.0 compatible)"
@@ -116,15 +120,12 @@
   ["XBM Support"]=>
   bool(false)
 }
-
-*/
-?>
 ]]>
-      </programlisting>
+      </screen>
      </example>
     </para>
     <simpara>
-     See also: <function>imagepng</function>,
+     See also <function>imagepng</function>,
      <function>imagejpeg</function>,
      <function>imagegif</function>,
      <function>imagewbmp</function>, and
Index: phpdoc/en/reference/image/functions/getimagesize.xml
diff -u phpdoc/en/reference/image/functions/getimagesize.xml:1.18 
phpdoc/en/reference/image/functions/getimagesize.xml:1.19
--- phpdoc/en/reference/image/functions/getimagesize.xml:1.18   Mon Aug  4 04:58:38 
2003
+++ phpdoc/en/reference/image/functions/getimagesize.xml        Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.18 $ -->
+<!-- $Revision: 1.19 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
  <refentry id="function.getimagesize">
   <refnamediv>
@@ -62,7 +62,11 @@
      <programlisting role="php">
 <![CDATA[
 <?php 
-$size = getimagesize ("http://www.example.com/gifs/logo.gif";); 
+$size = getimagesize("http://www.example.com/gifs/logo.gif";);
+
+// if the file name has space in it, encode it properly
+$size = getimagesize("http://www.example.com/gifs/lo%20go.gif";);
+
 ?>
 ]]>
      </programlisting>
Index: phpdoc/en/reference/image/functions/image-type-to-mime-type.xml
diff -u phpdoc/en/reference/image/functions/image-type-to-mime-type.xml:1.1 
phpdoc/en/reference/image/functions/image-type-to-mime-type.xml:1.2
--- phpdoc/en/reference/image/functions/image-type-to-mime-type.xml:1.1 Fri Nov 29 
14:24:59 2002
+++ phpdoc/en/reference/image/functions/image-type-to-mime-type.xml     Fri Aug 15 
18:50:50 2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
  <refentry id="function.image-type-to-mime-type">
   <refnamediv>
@@ -28,16 +28,99 @@
     </example>
    </para>
    <para>
+    The returned values are as follows 
+    <table>
+    <title>Returned values Constants</title>
+     <tgroup cols="2">
+      <thead>
+       <row>
+        <entry><parameter>imagetype</parameter></entry>
+        <entry>Returned value</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry><constant>IMAGETYPE_GIF</constant></entry>
+        <entry><literal>image/gif</literal></entry>
+       </row>
+       <row>
+        <entry><constant>IMAGETYPE_JPEG</constant></entry>
+        <entry><literal>image/jpeg</literal></entry>
+       </row>
+       <row>
+        <entry><constant>IMAGETYPE_PNG</constant></entry>
+        <entry><literal>image/png</literal></entry>
+       </row>
+       <row>
+        <entry><constant>IMAGETYPE_SWF</constant></entry>
+        <entry><literal>application/x-shockwave-flash</literal></entry>
+       </row>        
+       <row>
+        <entry><constant>IMAGETYPE_PSD</constant></entry>
+        <entry><literal>image/psd</literal></entry>
+       </row>        
+       <row>
+        <entry><constant>IMAGETYPE_BMP</constant></entry>
+        <entry><literal>image/bmp</literal></entry>
+       </row>        
+       <row>
+        <entry><constant>IMAGETYPE_TIFF_II</constant> (intel byte order)</entry>
+        <entry><literal>image/tiff</literal></entry>
+       </row>        
+       <row>
+        <entry>
+         <constant>IMAGETYPE_TIFF_MM</constant> (motorola byte order)
+        </entry>
+        <entry><literal>image/tiff</literal></entry>
+       </row>      
+       <row>
+        <entry><constant>IMAGETYPE_JPC</constant></entry>
+        <entry><literal>application/octet-stream</literal></entry>
+       </row>      
+       <row>
+        <entry><constant>IMAGETYPE_JP2</constant></entry>
+        <entry><literal>image/jp2</literal></entry>
+       </row>      
+       <row>
+        <entry><constant>IMAGETYPE_JPX</constant></entry>
+        <entry><literal>application/octet-stream</literal></entry>
+       </row>
+       <row>
+        <entry><constant>IMAGETYPE_JB2</constant></entry>
+        <entry><literal>application/octet-stream</literal></entry>
+       </row>
+       <row>
+        <entry><constant>IMAGETYPE_SWC</constant></entry>
+        <entry><literal>application/x-shockwave-flash</literal></entry>
+       </row>
+       <row>
+        <entry><constant>IMAGETYPE_IFF</constant></entry>
+        <entry><literal>image/iff</literal></entry>
+       </row>
+       <row>
+        <entry><constant>IMAGETYPE_WBMP</constant></entry>
+        <entry><literal>image/vnd.wap.wbmp</literal></entry>
+       </row>
+       <row> 
+        <entry><constant>IMAGETYPE_XBM</constant></entry>
+        <entry><literal>image/xbm</literal></entry>
+       </row>
+      </tbody>
+     </tgroup>     
+    </table>       
+   </para>
+   <para>
     <note>
      <simpara>
       This function does not require the GD image library.
      </simpara>
-     <simpara>
-      See also <function>getimagesize</function>, 
-      <function>exif_imagetype</function>, <function>exif_read_data</function>
-      and <function>exif_thumbnail</function>.
-     </simpara>
     </note>
+   </para>
+   <para>
+    See also <function>getimagesize</function>, 
+    <function>exif_imagetype</function>,
+    <function>exif_read_data</function> and
+    <function>exif_thumbnail</function>.
    </para>
   </refsect1>
  </refentry>
Index: phpdoc/en/reference/image/functions/image2wbmp.xml
diff -u phpdoc/en/reference/image/functions/image2wbmp.xml:1.3 
phpdoc/en/reference/image/functions/image2wbmp.xml:1.4
--- phpdoc/en/reference/image/functions/image2wbmp.xml:1.3      Thu Apr 18 13:13:09 
2002
+++ phpdoc/en/reference/image/functions/image2wbmp.xml  Fri Aug 15 18:50:50 2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.61 -->
  <refentry id="function.image2wbmp">
   <refnamediv>
@@ -26,6 +26,23 @@
     By sending an <acronym>image/vnd.wap.wbmp</acronym> content-type
     using <function>header</function>, you can create
     a PHP script that outputs WBMP images directly.
+   </para>
+   <para>
+    <example>
+     <title><function>image2wbmp</function> example</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+
+$file = 'php.jpg';
+
+header('Content-type: ' . image_type_to_mime(IMAGETYPE_WBMP));
+image2wbmp($file); // output the stream directly
+
+?>
+]]>
+     </programlisting>
+    </example>
    </para>
    <note>
     <para>
Index: phpdoc/en/reference/image/functions/imagechar.xml
diff -u phpdoc/en/reference/image/functions/imagechar.xml:1.4 
phpdoc/en/reference/image/functions/imagechar.xml:1.5
--- phpdoc/en/reference/image/functions/imagechar.xml:1.4       Wed Feb 12 12:49:07 
2003
+++ phpdoc/en/reference/image/functions/imagechar.xml   Fri Aug 15 18:50:50 2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
  <refentry id="function.imagechar">
   <refnamediv>
@@ -27,7 +27,33 @@
     corresponding to larger fonts).
    </para>
    <para>
-    See also <function>imageloadfont</function>.
+    <example>
+     <title><function>imagechar</function> example</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+
+$im = imagecreate(100,100);
+
+$string = 'PHP';
+
+$bg = imagecolorallocate($im, 255, 255, 255);
+$black = imagecolorallocate($im, 0, 0, 0);
+
+// prints a black "P" in the top left corner
+imagechar($im, 1, 0, 0, $string, $black);
+
+header('Content-type: image/png');
+imagepng($im);
+
+?>
+]]>
+     </programlisting>
+    </example>
+   </para>
+   <para>
+    See also <function>imagecharup</function> and
+    <function>imageloadfont</function>.
    </para>
   </refsect1>
  </refentry>
Index: phpdoc/en/reference/image/functions/imagecharup.xml
diff -u phpdoc/en/reference/image/functions/imagecharup.xml:1.4 
phpdoc/en/reference/image/functions/imagecharup.xml:1.5
--- phpdoc/en/reference/image/functions/imagecharup.xml:1.4     Wed Feb 12 12:49:07 
2003
+++ phpdoc/en/reference/image/functions/imagecharup.xml Fri Aug 15 18:50:50 2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
  <refentry id="function.imagecharup">
   <refnamediv>
@@ -27,7 +27,33 @@
     used.
    </para>
    <para>
-    See also <function>imageloadfont</function>.
+    <example>
+     <title><function>imagecharup</function> example</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+
+$im = imagecreate(100,100);
+
+$string = 'Note that the first letter is a N';
+
+$bg = imagecolorallocate($im, 255, 255, 255);
+$black = imagecolorallocate($im, 0, 0, 0);
+
+// prints a black "Z" on a white background
+imagecharup($im, 3, 10, 10, $string, $black);
+
+header('Content-type: image/png');
+imagepng($im);
+
+?>
+]]>
+     </programlisting>
+    </example>
+   </para>
+   <para>
+    See also <function>imagechar</function> and
+    <function>imageloadfont</function>.
    </para>
   </refsect1>
  </refentry>
Index: phpdoc/en/reference/image/functions/imagecolorallocate.xml
diff -u phpdoc/en/reference/image/functions/imagecolorallocate.xml:1.5 
phpdoc/en/reference/image/functions/imagecolorallocate.xml:1.6
--- phpdoc/en/reference/image/functions/imagecolorallocate.xml:1.5      Wed Jul 16 
13:14:17 2003
+++ phpdoc/en/reference/image/functions/imagecolorallocate.xml  Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
  <refentry id="function.imagecolorallocate">
   <refnamediv>
@@ -23,16 +23,34 @@
     function. <parameter>red</parameter>, <parameter>green</parameter> and
     <parameter>blue</parameter> are the values of the red, green and blue
     component of the requested color respectively.  These parameters are
-    integers between 0 and 255.
+    integers between 0 and 255 or hexadecimals between 0x00 and 0xFF.
     <function>imagecolorallocate</function> must be called
     to create each color that is to be used in the image represented
     by <parameter>image</parameter>.
+   </para>
+   <note>
+    <para>
+     The first call to <function>imagecolorallocate</function> fills
+     the background color.
+    </para>
+   </note>
+   <para>
     <informalexample>
      <programlisting role="php">
 <![CDATA[
 <?php
-$white = imagecolorallocate ($im, 255, 255, 255);
-$black = imagecolorallocate ($im, 0, 0, 0);
+
+// sets background to red
+$background = imagecolorallocate($im, 255, 0, 0);
+
+// sets some colors
+$white = imagecolorallocate($im, 255, 255, 255);
+$black = imagecolorallocate($im, 0, 0, 0);
+
+// hexadecimal way
+$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
+$black = imagecolorallocate($im, 0x00, 0x00, 0x00);
+
 ?>
 ]]>
      </programlisting>
Index: phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml
diff -u phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml:1.3 
phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml:1.4
--- phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml:1.3  Thu Apr 18 
13:13:09 2002
+++ phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml      Fri Aug 15 
18:50:50 2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
  <refentry id="function.imagecolorclosestalpha">
   <refnamediv>
@@ -20,10 +20,14 @@
     Returns the index of the color in the palette of the image which
     is "closest" to the specified <acronym>RGB</acronym> value and 
<parameter>alpha</parameter> level.
    </para>
+   <note>
+    <para>
+     This function was added in PHP 4.0.6 and requires GD 2.0.1
+    </para>
+   </note>
    <para>
     See also <function>imagecolorexactalpha</function>.
    </para>
-   <note><para>This function was added in PHP 4.0.6 and requires GD 
2.0.1</para></note>
   </refsect1>
  </refentry>
 
Index: phpdoc/en/reference/image/functions/imagecolorsforindex.xml
diff -u phpdoc/en/reference/image/functions/imagecolorsforindex.xml:1.3 
phpdoc/en/reference/image/functions/imagecolorsforindex.xml:1.4
--- phpdoc/en/reference/image/functions/imagecolorsforindex.xml:1.3     Thu Apr 18 
13:13:09 2002
+++ phpdoc/en/reference/image/functions/imagecolorsforindex.xml Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
  <refentry id="function.imagecolorsforindex">
   <refnamediv>
@@ -14,10 +14,52 @@
      <methodparam><type>int</type><parameter>index</parameter></methodparam>
     </methodsynopsis>
    <para>
-    This returns an associative array with red, green, and blue keys
-    that contain the appropriate values for the specified color
+    This returns an associative array with red, green, blue and alpha 
+    keys that contain the appropriate values for the specified color
     index.
    </para>
+   <para>
+    <example>
+     <title><function>imagecolorsforindex</function> example</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+
+// open an image
+$im = imagecreatefrompng('nexen.png');
+
+// get a color
+$start_x = 40;
+$start_y = 50;
+$color_index = imagecolorat($im, $start_x, $start_y);
+
+// make it human readable
+$color_tran = imagecolorsforindex($im, $color_index);
+
+// what is it ?
+echo '<pre>';
+print_r($color_tran);
+echo '</pre>';
+
+?>
+]]>
+     </programlisting>
+     <para>
+      This example will output :
+     </para>
+     <screen>
+<![CDATA[
+Array
+(
+    [red] => 226
+    [green] => 222
+    [blue] => 252
+    [alpha] => 0
+)
+]]>
+     </screen>
+    </example>
+   </para>   
    <para>
     See also <function>imagecolorat</function> and
     <function>imagecolorexact</function>.
Index: phpdoc/en/reference/image/functions/imagecreatefromgif.xml
diff -u phpdoc/en/reference/image/functions/imagecreatefromgif.xml:1.7 
phpdoc/en/reference/image/functions/imagecreatefromgif.xml:1.8
--- phpdoc/en/reference/image/functions/imagecreatefromgif.xml:1.7      Wed Jul 16 
13:14:17 2003
+++ phpdoc/en/reference/image/functions/imagecreatefromgif.xml  Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.2 -->
   <refentry id="function.imagecreatefromgif">
    <refnamediv>
@@ -24,7 +24,7 @@
      <example>
       <title>
        Example to handle an error during creation (courtesy
-       [EMAIL PROTECTED])
+       vic at zymsys dot com)
       </title>
       <programlisting role="php">
 <![CDATA[
Index: phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml
diff -u phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml:1.5 
phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml:1.6
--- phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml:1.5     Wed Jul 16 
13:14:17 2003
+++ phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.4 -->
   <refentry id="function.imagecreatefromjpeg">
    <refnamediv>
@@ -24,7 +24,7 @@
      <example>
       <title>
        Example to handle an error during creation (courtesy
-       [EMAIL PROTECTED] )
+       vic at zymsys dot com )
       </title>
       <programlisting role="php">
 <![CDATA[
Index: phpdoc/en/reference/image/functions/imagecreatefrompng.xml
diff -u phpdoc/en/reference/image/functions/imagecreatefrompng.xml:1.5 
phpdoc/en/reference/image/functions/imagecreatefrompng.xml:1.6
--- phpdoc/en/reference/image/functions/imagecreatefrompng.xml:1.5      Wed Jul 16 
13:14:17 2003
+++ phpdoc/en/reference/image/functions/imagecreatefrompng.xml  Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.4 -->
   <refentry id="function.imagecreatefrompng">
    <refnamediv>
@@ -24,7 +24,7 @@
      <example>
       <title>
        Example to handle an error during creation (courtesy
-       [EMAIL PROTECTED])
+       vic at zymsys dot com)
       </title>
       <programlisting role="php">
 <![CDATA[
Index: phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml
diff -u phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml:1.5 
phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml:1.6
--- phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml:1.5     Wed Jul 16 
13:14:17 2003
+++ phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.30 -->
   <refentry id="function.imagecreatefromwbmp">
    <refnamediv>
@@ -24,7 +24,7 @@
      <example>
       <title>
        Example to handle an error during creation (courtesy
-       [EMAIL PROTECTED])
+       vic at zymsys dot com)
       </title>
       <programlisting role="php">
 <![CDATA[
Index: phpdoc/en/reference/image/functions/imagefilledarc.xml
diff -u phpdoc/en/reference/image/functions/imagefilledarc.xml:1.4 
phpdoc/en/reference/image/functions/imagefilledarc.xml:1.5
--- phpdoc/en/reference/image/functions/imagefilledarc.xml:1.4  Wed Feb 12 12:49:07 
2003
+++ phpdoc/en/reference/image/functions/imagefilledarc.xml      Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
  <refentry id="function.imagefilledarc">
   <refnamediv>
@@ -46,7 +46,53 @@
     beginning and ending angles should be connected to the center - this is a 
     good way to outline (rather than fill) a 'pie slice'.
    </para>
-   <note><para>This function was added in PHP 4.0.6 and requires GD 
2.0.1</para></note>
+   <para>
+    <example>
+     <title>Creating a 3D looking pie</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+
+// this example is provided by poxy at klam dot is
+
+// create image
+$image = imagecreate(100, 100);
+
+// allocate some solors
+$white    = imagecolorallocate($image, 0xFF, 0xFF, 0xFF);
+$gray     = imagecolorallocate($image, 0xC0, 0xC0, 0xC0);
+$darkgray = imagecolorallocate($image, 0x90, 0x90, 0x90);
+$navy     = imagecolorallocate($image, 0x00, 0x00, 0x80);
+$darknavy = imagecolorallocate($image, 0x00, 0x00, 0x50);
+$red      = imagecolorallocate($image, 0xFF, 0x00, 0x00);
+$darkred  = imagecolorallocate($image, 0x90, 0x00, 0x00);
+
+// make the 3D effect
+for ($i = 60; $i > 50; $i--) {
+   imagefilledarc($image, 50, $i, 100, 50, 0, 45, $darknavy, IMG_ARC_PIE);
+  imagefilledarc($image, 50, $i, 100, 50, 45, 75 , $darkgray, IMG_ARC_PIE);
+  imagefilledarc($image, 50, $i, 100, 50, 75, 360 , $darkred, IMG_ARC_PIE);
+}
+
+imagefilledarc($image, 50, 50, 100, 50, 0, 45, $navy, IMG_ARC_PIE);
+imagefilledarc($image, 50, 50, 100, 50, 45, 75 , $gray, IMG_ARC_PIE);
+imagefilledarc($image, 50, 50, 100, 50, 75, 360 , $red, IMG_ARC_PIE);
+
+
+// flush image
+header('Content-type: image/png');
+imagepng($image);
+imagedestroy($image);
+?>
+]]>
+     </programlisting>
+    </example>
+   </para>
+   <note>
+    <para>
+     This function was added in PHP 4.0.6 and requires GD 2.0.1
+    </para>
+   </note>
   </refsect1>
  </refentry>
 
Index: phpdoc/en/reference/image/functions/imagefilledellipse.xml
diff -u phpdoc/en/reference/image/functions/imagefilledellipse.xml:1.4 
phpdoc/en/reference/image/functions/imagefilledellipse.xml:1.5
--- phpdoc/en/reference/image/functions/imagefilledellipse.xml:1.4      Wed Feb 12 
12:49:07 2003
+++ phpdoc/en/reference/image/functions/imagefilledellipse.xml  Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
  <refentry id="function.imagefilledellipse">
   <refnamediv>
@@ -25,7 +25,11 @@
     ellipse's width and height respectively. The ellipse is filled using
     <parameter>color</parameter>
    </para>
-   <note><para>This function was added in PHP 4.0.6 and requires GD 2.0.1 or 
later</para></note>
+   <note>
+    <para>
+     This function was added in PHP 4.0.6 and requires GD 2.0.1 or later
+    </para>
+   </note>
    <para>
     See also <function>imagefilledarc</function>.
    </para>
Index: phpdoc/en/reference/image/functions/imagefilledpolygon.xml
diff -u phpdoc/en/reference/image/functions/imagefilledpolygon.xml:1.4 
phpdoc/en/reference/image/functions/imagefilledpolygon.xml:1.5
--- phpdoc/en/reference/image/functions/imagefilledpolygon.xml:1.4      Wed Feb 12 
12:49:07 2003
+++ phpdoc/en/reference/image/functions/imagefilledpolygon.xml  Fri Aug 15 18:50:50 
2003
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/image.xml, last change in rev 1.2 -->
   <refentry id="function.imagefilledpolygon">
    <refnamediv>
@@ -22,6 +22,51 @@
      polygon's vertices, ie. points[0] = x0, points[1] = y0, points[2]
      = x1, points[3] = y1, etc.  <parameter>num_points</parameter> is
      the total number of vertices.
+    </para>
+    <para>
+     <example>
+      <title><function>imagefilledpolygon</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+
+// this example is provided by ecofarm at mullum dot com dot au
+
+// set up array of points for polygon
+$values = array(
+  0  => 40,    // x1
+  1  => 50,    // y1
+  2  => 20,    // x2
+  3  => 240,   // y2
+  4  => 60,    // x3
+  5  => 60,    // y3
+  6  => 240,   // x4
+  7  => 20,    // y4
+  8  => 50,    // x5
+  9  => 40,    // y5
+  10 => 10,    // x6
+  11 => 10,    // y6
+);
+
+// create image
+$im = imagecreate(250, 250);
+
+// some colors
+$bg   = imagecolorallocate($im, 255, 255, 255);
+$blue = imagecolorallocate($im, 0, 0, 255);
+
+// draw a polygon
+imagefilledpolygon($im, $values, 6, $blue );
+
+// flush image
+header('Content-type: image/png');
+imagepng($im);
+imagedestroy($im);
+
+?>
+]]>
+      </programlisting>
+     </example>
     </para>
    </refsect1>
   </refentry>

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to