cvs: /phpdoc/functions image.sgml

jim Fri Jul 16 16:38:46 1999 EDT Modified files: /phpdoc/functions image.sgml Log: Add notes about removed functions. Index: phpdoc/functions/image.sgml diff -u phpdoc/functions/image.sgml:1.1 phpdoc/functions/image.sgml:1.2 --- phpdoc/functions/image.sgml:1.1 Sun Jun 6 14:50:47 1999 +++ phpdoc/functions/image.sgml Fri Jul 16 16:38:45 1999 @@ -8,7 +8,7 @@ You can use the image functions in PHP to get the size of JPEG, GIF, and PNG images, and if you have the GD library (available at <ulink url="&url.gd;">&url.gd;</ulink>) you will also be able to create and - manipulate GIF images. + manipulate images. </partintro> <refentry id="function.getimagesize"> @@ -263,13 +263,15 @@ <funcdef>int <function>imagecreatefromgif</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> </funcsynopsis> -<para> ImageCreateFromGif returns an image identifier representing the - image obtained from the given filename. - <para> - ImageCreateFromGif returns an empty string on failure. It also outputs an - error message, which unfortunately displays as a broken link in a browser. - To ease debugging the following example will produce an error gif: - <example> + <para> + <function>imagecreatefromgif</function> returns an image identifier + representing the image obtained from the given filename. + <para> + <function>imagecreatefromgif</function> returns an empty string + on failure. It also outputs an error message, which unfortunately + displays as a broken link in a browser. To ease debugging the + following example will produce an error GIF: + <example> <title>Example to handle an error during creation (courtesy vic@zymsys.com )</title> <programlisting role=php> function LoadGif($imgname) @@ -285,6 +287,12 @@ return $im; } </programlisting></example> + <note> + <para> + Since all GIF support was removed from the GD library in version 1.6, + this function is not available if you are using that version of the + GD library. + </note> </refsect1> </refentry> @@ -462,19 +470,27 @@ <paramdef>int <parameter>im</parameter></paramdef> <paramdef>string <parameter>filename</parameter></paramdef> </funcsynopsis> -<para> ImageGif creates the GIF file in filename from the image im. The im argument is the return from the - <function>imagecreate</function> function. - <para> The image format will be GIF87a unless the image has - been made transparent with <function>imagecolortransparent</function>, in - which case the image format will be GIF89a. - <para> The filename argument is optional, and if left off, - the raw image stream will be output directly. By sending an - image/gif content-type using the - - header + <para> + <function>imagegif</function> creates the GIF file in filename from + the image <parameter>im</parameter>. The <parameter>im</parameter> + argument is the return from the <function>imagecreate</function> + function. + <para> + The image format will be GIF87a unless the image has been made + transparent with <function>imagecolortransparent</function>, in + which case the image format will be GIF89a. + <para> + The filename argument is optional, and if left off, the raw image + stream will be output directly. By sending an image/gif content-type + using <function>header</function>, you can create a PHP script that + outputs GIF images directly. + <note> + <para> + Since all GIF support was removed from the GD library in version 1.6, + this function is not available if you are using that version of the + GD library. + </note> - function, you can create a PHP script that outputs GIF images - directly. </refsect1> </refentry>