cvs: phpdoc /en/reference/image/functions gd-info.xml getimagesize.xml image-type-to-extension.xml image-type-to-mime-type.xml image2wbmp.xml
imagealphablending.xml imageantialias.xml imagearc.xml imagechar.xml imagecharup.xml imagecolorallocate.xml imagecolorallocatealpha.xml
imagecolorat.xml imagecolorclosest.xml imagecolorclosestalpha.xml imagecolorclosesthwb.xml imagecolordeallocate.xml imagecolorexact.xml
imagecolorexactalpha.xml imagecolormatch.xml imagecolorresolve.xml imagecolorresolvealpha.xml imagecolorset.xml imagecolorsforindex.xml
imagecolorstotal.xml imagecolortransparent.xml imageconvolution.xml imagecopy.xml imagecopymerge.xml imagecopymergegray.xml imagecopyresampled.xml
imagecopyresized.xml imagecreate.xml imagecreatefromgd.xml imagecreatefromgd2.xml imagecreatefromgd2part.xml imagecreatefromgif.xml
imagecreatefromjpeg.xml imagecreatefrompng.xml imagecreatefromstring.xml imagecreatefromwbmp.xml imagecreatefromxbm.xml imagecreatefromxpm.xml
imagecre! atetruecolor.xml imagedashedline.xml imagedestroy.xml imageellipse.xml imagefill.xml imagefilledarc.xml imagefilledellipse.xml
imagefilledpolygon.xml imagefilledrectangle.xml imagefilltoborder.xml imagefilter.xml imagefontheight.xml imagefontwidth.xml imageftbbox.xml
imagefttext.xml imagegammacorrect.xml imagegd.xml imagegd2.xml imagegif.xml imageinterlace.xml imageistruecolor.xml imagejpeg.xml imagelayereffect.xml
imageline.xml imageloadfont.xml imagepalettecopy.xml imagepng.xml imagepolygon.xml imagepsbbox.xml imagepsencodefont.xml imagepsextendfont.xml
imagepsfreefont.xml imagepsloadfont.xml imagepsslantfont.xml imagepstext.xml imagerectangle.xml imagerotate.xml imagesavealpha.xml imagesetbrush.xml
imagesetpixel.xml imagesetstyle.xml imagesetthickness.xml imagesettile.xml imagestring.xml imagestringup.xml imagesx.xml imagesy.xml
imagetruecolortopalette.xml imagettfbbox.xml imagettftext.xml imagetypes.xml imagewbmp.xml imagexbm.xml iptcembed.xml iptcparse.xml jpeg2wbmp.xm! l
png2wbmp.xml

didou Sat Jan 13 17:11:46 2007 UTC Modified files: /phpdoc/en/reference/image/functions gd-info.xml getimagesize.xml image-type-to-extension.xml image-type-to-mime-type.xml image2wbmp.xml imagealphablending.xml imageantialias.xml imagearc.xml imagechar.xml imagecharup.xml imagecolorallocate.xml imagecolorallocatealpha.xml imagecolorat.xml imagecolorclosest.xml imagecolorclosestalpha.xml imagecolorclosesthwb.xml imagecolordeallocate.xml imagecolorexact.xml imagecolorexactalpha.xml imagecolormatch.xml imagecolorresolve.xml imagecolorresolvealpha.xml imagecolorset.xml imagecolorsforindex.xml imagecolorstotal.xml imagecolortransparent.xml imageconvolution.xml imagecopy.xml imagecopymerge.xml imagecopymergegray.xml imagecopyresampled.xml imagecopyresized.xml imagecreate.xml imagecreatefromgd.xml imagecreatefromgd2.xml imagecreatefromgd2part.xml imagecreatefromgif.xml imagecreatefromjpeg.xml imagecreatefrompng.xml imagecreatefromstring.xml imagecreatefromwbmp.xml imagecreatefromxbm.xml imagecreatefromxpm.xml imagecreatetruecolor.xml imagedashedline.xml imagedestroy.xml imageellipse.xml imagefill.xml imagefilledarc.xml imagefilledellipse.xml imagefilledpolygon.xml imagefilledrectangle.xml imagefilltoborder.xml imagefilter.xml imagefontheight.xml imagefontwidth.xml imageftbbox.xml imagefttext.xml imagegammacorrect.xml imagegd.xml imagegd2.xml imagegif.xml imageinterlace.xml imageistruecolor.xml imagejpeg.xml imagelayereffect.xml imageline.xml imageloadfont.xml imagepalettecopy.xml imagepng.xml imagepolygon.xml imagepsbbox.xml imagepsencodefont.xml imagepsextendfont.xml imagepsfreefont.xml imagepsloadfont.xml imagepsslantfont.xml imagepstext.xml imagerectangle.xml imagerotate.xml imagesavealpha.xml imagesetbrush.xml imagesetpixel.xml imagesetstyle.xml imagesetthickness.xml imagesettile.xml imagestring.xml imagestringup.xml imagesx.xml imagesy.xml imagetruecolortopalette.xml imagettfbbox.xml imagettftext.xml imagetypes.xml imagewbmp.xml imagexbm.xml iptcembed.xml iptcparse.xml jpeg2wbmp.xml png2wbmp.xml Log: Whitespace, preparing for new style

http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/gd-info.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/gd-info.xml diff -u phpdoc/en/reference/image/functions/gd-info.xml:1.4 phpdoc/en/reference/image/functions/gd-info.xml:1.5 --- phpdoc/en/reference/image/functions/gd-info.xml:1.4 Fri Aug 15 22:50:50 2003 +++ phpdoc/en/reference/image/functions/gd-info.xml Sat Jan 13 17:11:45 2007 @@ -1,104 +1,104 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id='function.gd-info'> - <refnamediv> - <refname>gd_info</refname> - <refpurpose>Retrieve information about the currently installed GD library</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>gd_info</methodname> - <void/> - </methodsynopsis> - <simpara> - Returns an associative array describing the version and capabilities of - the installed GD library. - </simpara> - <para> - <table> - <title>Elements of array returned by <function>gd_info</function></title> - <tgroup cols="2"> - <thead> - <row> - <entry>Attribute</entry> - <entry>Meaning</entry> - </row> - </thead> - <tbody> - <row> - <entry>GD Version</entry> - <entry><type>string</type> value describing the installed - <literal>libgd</literal> version.</entry> - </row> - <row> - <entry>Freetype Support</entry> - <entry><type>boolean</type> value. &true; - if Freetype Support is installed.</entry> - </row> - <row> - <entry>Freetype Linkage</entry> - <entry><type>string</type> value describing the way in which - Freetype was linked. Expected values are: 'with freetype', - 'with TTF library', and 'with unknown library'. This element will - only be defined if <literal>Freetype Support</literal> evaluated to - &true;.</entry> - </row> - <row> - <entry>T1Lib Support</entry> - <entry><type>boolean</type> value. &true; - if <literal>T1Lib</literal> support is included.</entry> - </row> - <row> - <entry>GIF Read Support</entry> - <entry><type>boolean</type> value. &true; - if support for <emphasis>reading</emphasis> <literal>GIF</literal> - images is included.</entry> - </row> - <row> - <entry>GIF Create Support</entry> - <entry><type>boolean</type> value. &true; - if support for <emphasis>creating</emphasis> <literal>GIF</literal> - images is included.</entry> - </row> - <row> - <entry>JPG Support</entry> - <entry><type>boolean</type> value. &true; - if <literal>JPG</literal> support is included.</entry> - </row> - <row> - <entry>PNG Support</entry> - <entry><type>boolean</type> value. &true; - if <literal>PNG</literal> support is included.</entry> - </row> - <row> - <entry>WBMP Support</entry> - <entry><type>boolean</type> value. &true; - if <literal>WBMP</literal> support is included.</entry> - </row> - <row> - <entry>XBM Support</entry> - <entry><type>boolean</type> value. &true; - if <literal>XBM</literal> support is included.</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - <example> - <title>Using <function>gd_info</function></title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id='function.gd-info'> + <refnamediv> + <refname>gd_info</refname> + <refpurpose>Retrieve information about the currently installed GD library</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>gd_info</methodname> + <void/> + </methodsynopsis> + <simpara> + Returns an associative array describing the version and capabilities of + the installed GD library. + </simpara> + <para> + <table> + <title>Elements of array returned by <function>gd_info</function></title> + <tgroup cols="2"> + <thead> + <row> + <entry>Attribute</entry> + <entry>Meaning</entry> + </row> + </thead> + <tbody> + <row> + <entry>GD Version</entry> + <entry><type>string</type> value describing the installed + <literal>libgd</literal> version.</entry> + </row> + <row> + <entry>Freetype Support</entry> + <entry><type>boolean</type> value. &true; + if Freetype Support is installed.</entry> + </row> + <row> + <entry>Freetype Linkage</entry> + <entry><type>string</type> value describing the way in which + Freetype was linked. Expected values are: 'with freetype', + 'with TTF library', and 'with unknown library'. This element will + only be defined if <literal>Freetype Support</literal> evaluated to + &true;.</entry> + </row> + <row> + <entry>T1Lib Support</entry> + <entry><type>boolean</type> value. &true; + if <literal>T1Lib</literal> support is included.</entry> + </row> + <row> + <entry>GIF Read Support</entry> + <entry><type>boolean</type> value. &true; + if support for <emphasis>reading</emphasis> <literal>GIF</literal> + images is included.</entry> + </row> + <row> + <entry>GIF Create Support</entry> + <entry><type>boolean</type> value. &true; + if support for <emphasis>creating</emphasis> <literal>GIF</literal> + images is included.</entry> + </row> + <row> + <entry>JPG Support</entry> + <entry><type>boolean</type> value. &true; + if <literal>JPG</literal> support is included.</entry> + </row> + <row> + <entry>PNG Support</entry> + <entry><type>boolean</type> value. &true; + if <literal>PNG</literal> support is included.</entry> + </row> + <row> + <entry>WBMP Support</entry> + <entry><type>boolean</type> value. &true; + if <literal>WBMP</literal> support is included.</entry> + </row> + <row> + <entry>XBM Support</entry> + <entry><type>boolean</type> value. &true; + if <literal>XBM</literal> support is included.</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + <example> + <title>Using <function>gd_info</function></title> + <programlisting role="php"> <![CDATA[ <?php var_dump(gd_info()); ?> ]]> - </programlisting> - <para> - The typical output is : - </para> - <screen> + </programlisting> + <para> + The typical output is : + </para> + <screen> <![CDATA[ array(9) { ["GD Version"]=> @@ -121,18 +121,18 @@ bool(false) } ]]> - </screen> - </example> - </para> - <simpara> - See also <function>imagepng</function>, - <function>imagejpeg</function>, - <function>imagegif</function>, - <function>imagewbmp</function>, and - <function>imagetypes</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + <simpara> + See also <function>imagepng</function>, + <function>imagejpeg</function>, + <function>imagegif</function>, + <function>imagewbmp</function>, and + <function>imagetypes</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/getimagesize.xml?r1=1.26&r2=1.27&diff_format=u Index: phpdoc/en/reference/image/functions/getimagesize.xml diff -u phpdoc/en/reference/image/functions/getimagesize.xml:1.26 phpdoc/en/reference/image/functions/getimagesize.xml:1.27 --- phpdoc/en/reference/image/functions/getimagesize.xml:1.26 Thu May 12 13:57:49 2005 +++ phpdoc/en/reference/image/functions/getimagesize.xml Sat Jan 13 17:11:45 2007 @@ -1,91 +1,90 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.26 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.getimagesize"> - <refnamediv> - <refname>getimagesize</refname> - <refpurpose>Get the size of an image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>getimagesize</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter role="reference">imageinfo</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.27 $ --> +<refentry id="function.getimagesize"> + <refnamediv> + <refname>getimagesize</refname> + <refpurpose>Get the size of an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>getimagesize</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter role="reference">imageinfo</parameter></methodparam> + </methodsynopsis> + <para> + The <function>getimagesize</function> function will determine the + size of any <acronym>GIF</acronym>, <acronym>JPG</acronym>, + <acronym>PNG</acronym>, <acronym>SWF</acronym>, + <acronym>SWC</acronym>, <acronym>PSD</acronym>, + <acronym>TIFF</acronym>, <acronym>BMP</acronym>, + <acronym>IFF</acronym>, <acronym>JP2</acronym>, + <acronym>JPX</acronym>, <acronym>JB2</acronym>, + <acronym>JPC</acronym>, <acronym>XBM</acronym>, or + <acronym>WBMP</acronym> image file and return the dimensions along with + the file type and a height/width text string to be used inside a normal + <acronym>HTML</acronym> <sgmltag>IMG</sgmltag> tag. + </para> + <para> + If accessing the <parameter>filename</parameter> image is impossible, + or if it isn't a valid picture, <function>getimagesize</function> + will return &false; and generate an error of level + <varname>E_WARNING</varname>. + </para> + <note> <para> - The <function>getimagesize</function> function will determine the - size of any <acronym>GIF</acronym>, <acronym>JPG</acronym>, - <acronym>PNG</acronym>, <acronym>SWF</acronym>, - <acronym>SWC</acronym>, <acronym>PSD</acronym>, - <acronym>TIFF</acronym>, <acronym>BMP</acronym>, - <acronym>IFF</acronym>, <acronym>JP2</acronym>, + Support for <acronym>JPC</acronym>, <acronym>JP2</acronym>, <acronym>JPX</acronym>, <acronym>JB2</acronym>, - <acronym>JPC</acronym>, <acronym>XBM</acronym>, or - <acronym>WBMP</acronym> image file and return the dimensions along with - the file type and a height/width text string to be used inside a normal - <acronym>HTML</acronym> <sgmltag>IMG</sgmltag> tag. - </para> - <para> - If accessing the <parameter>filename</parameter> image is impossible, - or if it isn't a valid picture, <function>getimagesize</function> - will return &false; and generate an error of level - <varname>E_WARNING</varname>. - </para> - <note> - <para> - Support for <acronym>JPC</acronym>, <acronym>JP2</acronym>, - <acronym>JPX</acronym>, <acronym>JB2</acronym>, - <acronym>XBM</acronym>, and <acronym>WBMP</acronym> became available in - PHP 4.3.2. Support for <acronym>SWC</acronym> exists as of PHP 4.3.0 - and <acronym>TIFF</acronym> support was added in PHP 4.2.0 - </para> - </note> - <note> - <simpara> - JPEG 2000 support was added in PHP 4.3.2. Note that JPC and JP2 are - capable of having components with different bit depths. In this case, - the value for "bits" is the highest bit depth encountered. Also, JP2 - files may contain multiple JPEG 2000 codestreams. In this case, - <function>getimagesize</function> returns the values for the first - codestream it encounters in the root of the file. - </simpara> - </note> - <note> - <simpara> - The <function>getimagesize</function> function does not require the GD - image library. - </simpara> - </note> - <para> - Returns an array with 4 elements. Index 0 contains the width of - the image in pixels. Index 1 contains the height. Index 2 is a - flag indicating the type of the image: 1 = GIF, 2 = JPG, 3 = - PNG, 4 = SWF, 5 = PSD, 6 = BMP, 7 = TIFF(intel byte order), - 8 = TIFF(motorola byte order), 9 = JPC, 10 = JP2, 11 = JPX, 12 = - JB2, 13 = SWC, 14 = IFF, 15 = WBMP, 16 = XBM. These values correspond to - the IMAGETYPE constants that were added in PHP 4.3.0. Index 3 is a text - string with the correct height="yyy" width="xxx" string that can be used - directly in an IMG tag. - <example> - <title>getimagesize (file)</title> - <programlisting role="php"> + <acronym>XBM</acronym>, and <acronym>WBMP</acronym> became available in + PHP 4.3.2. Support for <acronym>SWC</acronym> exists as of PHP 4.3.0 + and <acronym>TIFF</acronym> support was added in PHP 4.2.0 + </para> + </note> + <note> + <simpara> + JPEG 2000 support was added in PHP 4.3.2. Note that JPC and JP2 are + capable of having components with different bit depths. In this case, + the value for "bits" is the highest bit depth encountered. Also, JP2 + files may contain multiple JPEG 2000 codestreams. In this case, + <function>getimagesize</function> returns the values for the first + codestream it encounters in the root of the file. + </simpara> + </note> + <note> + <simpara> + The <function>getimagesize</function> function does not require the GD + image library. + </simpara> + </note> + <para> + Returns an array with 4 elements. Index 0 contains the width of + the image in pixels. Index 1 contains the height. Index 2 is a + flag indicating the type of the image: 1 = GIF, 2 = JPG, 3 = + PNG, 4 = SWF, 5 = PSD, 6 = BMP, 7 = TIFF(intel byte order), + 8 = TIFF(motorola byte order), 9 = JPC, 10 = JP2, 11 = JPX, 12 = + JB2, 13 = SWC, 14 = IFF, 15 = WBMP, 16 = XBM. These values correspond to + the IMAGETYPE constants that were added in PHP 4.3.0. Index 3 is a text + string with the correct height="yyy" width="xxx" string that can be used + directly in an IMG tag. + <example> + <title>getimagesize (file)</title> + <programlisting role="php"> <![CDATA[ <?php list($width, $height, $type, $attr) = getimagesize("img/flag.jpg"); echo "<img src=\"img/flag.jpg\" $attr alt=\"getimagesize() example\" />"; ?> ]]> - </programlisting> - </example> - </para> - <para> - URL support was added in PHP 4.0.5 - <example> - <title>getimagesize (URL)</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + URL support was added in PHP 4.0.5 + <example> + <title>getimagesize (URL)</title> + <programlisting role="php"> <![CDATA[ -<?php +<?php $size = getimagesize("http://www.example.com/gifs/logo.gif"); // if the file name has space in it, encode it properly @@ -93,37 +92,37 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - With <acronym>JPG</acronym> images, two extra indexes are returned: - <literal>channels</literal> and <literal>bits</literal>. - <literal>channels</literal> will be 3 for RGB pictures and 4 for CMYK - pictures. <literal>bits</literal> is the number of bits for each color. - </para> - <para> - Beginning with PHP 4.3.0, <literal>bits</literal> and - <literal>channels</literal> are present for other image types, too. - However, the presence of these values can be a bit confusing. As an - example, <acronym>GIF</acronym> always uses 3 channels per pixel, but the - number of bits per pixel cannot be calculated for an animated - <acronym>GIF</acronym> with a global color table. - </para> - <para> - Some formats may contain no image or may contain multiple images. In these - cases, <function>getimagesize</function> might not be able to properly - determine the image size. <function>getimagesize</function> will return - zero for width and height in these cases. - </para> - <para> - Beginning with PHP 4.3.0, <function>getimagesize</function> also returns an - additional parameter, <literal>mime</literal>, that corresponds with the - MIME type of the image. This information can be used to deliver images - with correct HTTP Content-type headers: - <example> - <title>getimagesize() and MIME types</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + With <acronym>JPG</acronym> images, two extra indexes are returned: + <literal>channels</literal> and <literal>bits</literal>. + <literal>channels</literal> will be 3 for RGB pictures and 4 for CMYK + pictures. <literal>bits</literal> is the number of bits for each color. + </para> + <para> + Beginning with PHP 4.3.0, <literal>bits</literal> and + <literal>channels</literal> are present for other image types, too. + However, the presence of these values can be a bit confusing. As an + example, <acronym>GIF</acronym> always uses 3 channels per pixel, but the + number of bits per pixel cannot be calculated for an animated + <acronym>GIF</acronym> with a global color table. + </para> + <para> + Some formats may contain no image or may contain multiple images. In these + cases, <function>getimagesize</function> might not be able to properly + determine the image size. <function>getimagesize</function> will return + zero for width and height in these cases. + </para> + <para> + Beginning with PHP 4.3.0, <function>getimagesize</function> also returns an + additional parameter, <literal>mime</literal>, that corresponds with the + MIME type of the image. This information can be used to deliver images + with correct HTTP Content-type headers: + <example> + <title>getimagesize() and MIME types</title> + <programlisting role="php"> <![CDATA[ <?php $size = getimagesize($filename); @@ -137,25 +136,25 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - The optional <parameter>imageinfo</parameter> parameter allows - you to extract some extended information from the image - file. Currently, this will return the different - <acronym>JPG</acronym> APP markers as an associative array. Some - programs use these APP markers to embed text information in - images. A very common one is to embed <acronym>IPTC</acronym> - <ulink url="&url.iptc;">&url.iptc;</ulink> information in the - APP13 marker. You can use the <function>iptcparse</function> - function to parse the binary APP13 marker into something - readable. - </para> - <para> - <example> - <title>getimagesize() returning IPTC</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + The optional <parameter>imageinfo</parameter> parameter allows + you to extract some extended information from the image + file. Currently, this will return the different + <acronym>JPG</acronym> APP markers as an associative array. Some + programs use these APP markers to embed text information in + images. A very common one is to embed <acronym>IPTC</acronym> + <ulink url="&url.iptc;">&url.iptc;</ulink> information in the + APP13 marker. You can use the <function>iptcparse</function> + function to parse the binary APP13 marker into something + readable. + </para> + <para> + <example> + <title>getimagesize() returning IPTC</title> + <programlisting role="php"> <![CDATA[ <?php $size = getimagesize("testimg.jpg", $info); @@ -165,17 +164,17 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>image_type_to_mime_type</function>, - <function>exif_imagetype</function>, - <function>exif_read_data</function>, and - <function>exif_thumbnail</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>image_type_to_mime_type</function>, + <function>exif_imagetype</function>, + <function>exif_read_data</function>, and + <function>exif_thumbnail</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/image-type-to-extension.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/image/functions/image-type-to-extension.xml diff -u phpdoc/en/reference/image/functions/image-type-to-extension.xml:1.1 phpdoc/en/reference/image/functions/image-type-to-extension.xml:1.2 --- phpdoc/en/reference/image/functions/image-type-to-extension.xml:1.1 Sun May 2 18:06:12 2004 +++ phpdoc/en/reference/image/functions/image-type-to-extension.xml Sat Jan 13 17:11:45 2007 @@ -1,11 +1,9 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.image-type-to-extension"> <refnamediv> <refname>image_type_to_extension</refname> - <refpurpose> - Get file extension for image type - </refpurpose> + <refpurpose>Get file extension for image type</refpurpose> </refnamediv> <refsect1> <title>Description</title> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/image-type-to-mime-type.xml?r1=1.5&r2=1.6&diff_format=u 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.5 phpdoc/en/reference/image/functions/image-type-to-mime-type.xml:1.6 --- phpdoc/en/reference/image/functions/image-type-to-mime-type.xml:1.5 Fri Aug 13 16:12:05 2004 +++ phpdoc/en/reference/image/functions/image-type-to-mime-type.xml Sat Jan 13 17:11:45 2007 @@ -1,129 +1,128 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.image-type-to-mime-type"> - <refnamediv> - <refname>image_type_to_mime_type</refname> - <refpurpose>Get Mime-Type for image-type returned by getimagesize, - exif_read_data, exif_thumbnail, exif_imagetype</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>image_type_to_mime_type</methodname> - <methodparam><type>int</type><parameter>imagetype</parameter></methodparam> - </methodsynopsis> - <para> - The <function>image_type_to_mime_type</function> function will determine - the Mime-Type for an IMAGETYPE constant. - <example> - <title>image_type_to_mime_type (file)</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.image-type-to-mime-type"> + <refnamediv> + <refname>image_type_to_mime_type</refname> + <refpurpose>Get Mime-Type for image-type returned by getimagesize, + exif_read_data, exif_thumbnail, exif_imagetype</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>image_type_to_mime_type</methodname> + <methodparam><type>int</type><parameter>imagetype</parameter></methodparam> + </methodsynopsis> + <para> + The <function>image_type_to_mime_type</function> function will determine + the Mime-Type for an IMAGETYPE constant. + <example> + <title>image_type_to_mime_type (file)</title> + <programlisting role="php"> <![CDATA[ <?php header("Content-type: " . image_type_to_mime_type(IMAGETYPE_PNG)); ?> ]]> - </programlisting> - </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> - </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> + </programlisting> + </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> + </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> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/image2wbmp.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/image2wbmp.xml diff -u phpdoc/en/reference/image/functions/image2wbmp.xml:1.7 phpdoc/en/reference/image/functions/image2wbmp.xml:1.8 --- phpdoc/en/reference/image/functions/image2wbmp.xml:1.7 Wed Aug 10 04:48:10 2005 +++ phpdoc/en/reference/image/functions/image2wbmp.xml Sat Jan 13 17:11:45 2007 @@ -1,37 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.61 --> - <refentry id="function.image2wbmp"> - <refnamediv> - <refname>image2wbmp</refname> - <refpurpose>Output image to browser or file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>image2wbmp</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>threshold</parameter></methodparam> - </methodsynopsis> - <para> - <function>image2wbmp</function> creates the - <acronym>WBMP</acronym> file in filename from the image - <parameter>image</parameter>. The <parameter>image</parameter> argument - is the return from one of the image create functions, such as - <function>imagecreatetruecolor</function>. - </para> - <para> - The filename argument is optional, and if left off, the raw image - stream will be output directly. - 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"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.image2wbmp"> + <refnamediv> + <refname>image2wbmp</refname> + <refpurpose>Output image to browser or file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>image2wbmp</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>threshold</parameter></methodparam> + </methodsynopsis> + <para> + <function>image2wbmp</function> creates the + <acronym>WBMP</acronym> file in filename from the image + <parameter>image</parameter>. The <parameter>image</parameter> argument + is the return from one of the image create functions, such as + <function>imagecreatetruecolor</function>. + </para> + <para> + The filename argument is optional, and if left off, the raw image + stream will be output directly. + 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 @@ -43,20 +42,20 @@ ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - WBMP support is only available if PHP was compiled - against GD-1.8 or later. - </para> - </note> + </programlisting> + </example> + </para> + <note> <para> - See also <function>imagewbmp</function>. + WBMP support is only available if PHP was compiled + against GD-1.8 or later. </para> - </refsect1> - </refentry> + </note> + <para> + See also <function>imagewbmp</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagealphablending.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imagealphablending.xml diff -u phpdoc/en/reference/image/functions/imagealphablending.xml:1.6 phpdoc/en/reference/image/functions/imagealphablending.xml:1.7 --- phpdoc/en/reference/image/functions/imagealphablending.xml:1.6 Fri Jun 11 08:25:38 2004 +++ phpdoc/en/reference/image/functions/imagealphablending.xml Sat Jan 13 17:11:45 2007 @@ -1,36 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagealphablending"> - <refnamediv> - <refname>imagealphablending</refname> - <refpurpose>Set the blending mode for an image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagealphablending</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>bool</type><parameter>blendmode</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagealphablending</function> allows for two different - modes of drawing on truecolor images. In blending mode, the - alpha channel component of the color supplied to all drawing function, - such as <function>imagesetpixel</function> determines how much of the - underlying color should be allowed to shine through. As a result, gd - automatically blends the existing color at that point with the drawing color, - and stores the result in the image. The resulting pixel is opaque. In - non-blending mode, the drawing color is copied literally with its alpha channel - information, replacing the destination pixel. Blending mode is not available - when drawing on palette images. - If <parameter>blendmode</parameter> is &true;, then blending mode is enabled, otherwise - disabled. - &return.success; - </para> - &note.gd.2; - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.imagealphablending"> + <refnamediv> + <refname>imagealphablending</refname> + <refpurpose>Set the blending mode for an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagealphablending</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>bool</type><parameter>blendmode</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagealphablending</function> allows for two different + modes of drawing on truecolor images. In blending mode, the + alpha channel component of the color supplied to all drawing function, + such as <function>imagesetpixel</function> determines how much of the + underlying color should be allowed to shine through. As a result, gd + automatically blends the existing color at that point with the drawing color, + and stores the result in the image. The resulting pixel is opaque. In + non-blending mode, the drawing color is copied literally with its alpha channel + information, replacing the destination pixel. Blending mode is not available + when drawing on palette images. + If <parameter>blendmode</parameter> is &true;, then blending mode is enabled, otherwise + disabled. + &return.success; + </para> + &note.gd.2; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imageantialias.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imageantialias.xml diff -u phpdoc/en/reference/image/functions/imageantialias.xml:1.7 phpdoc/en/reference/image/functions/imageantialias.xml:1.8 --- phpdoc/en/reference/image/functions/imageantialias.xml:1.7 Sat Sep 10 10:57:36 2005 +++ phpdoc/en/reference/image/functions/imageantialias.xml Sat Jan 13 17:11:45 2007 @@ -1,39 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.imageantialias"> - <refnamediv> - <refname>imageantialias</refname> - <refpurpose> - Should antialias functions be used or not - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imageantialias</methodname> - <methodparam><type>resource</type><parameter>im</parameter></methodparam> - <methodparam><type>bool</type><parameter>on</parameter></methodparam> - </methodsynopsis> - <para> - Activate the fast drawing antialiased methods for lines and wired polygons. - It does not support alpha components. It works using a direct blend - operation. It works only with truecolor images. - </para> - <para> - Thickness and styled are not supported. - </para> - <para> - Using antialiased primitives with transparent background color can end with - some unexpected results. The blend method uses the background color as any - other colors. The lack of alpha component support does not allow an alpha - based antialiasing method. - </para> - &note.bundled.gd; - <para> - See also <function>imagecreatetruecolor</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<refentry id="function.imageantialias"> + <refnamediv> + <refname>imageantialias</refname> + <refpurpose>Should antialias functions be used or not</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imageantialias</methodname> + <methodparam><type>resource</type><parameter>im</parameter></methodparam> + <methodparam><type>bool</type><parameter>on</parameter></methodparam> + </methodsynopsis> + <para> + Activate the fast drawing antialiased methods for lines and wired polygons. + It does not support alpha components. It works using a direct blend + operation. It works only with truecolor images. + </para> + <para> + Thickness and styled are not supported. + </para> + <para> + Using antialiased primitives with transparent background color can end with + some unexpected results. The blend method uses the background color as any + other colors. The lack of alpha component support does not allow an alpha + based antialiasing method. + </para> + &note.bundled.gd; + <para> + See also <function>imagecreatetruecolor</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagearc.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/image/functions/imagearc.xml diff -u phpdoc/en/reference/image/functions/imagearc.xml:1.9 phpdoc/en/reference/image/functions/imagearc.xml:1.10 --- phpdoc/en/reference/image/functions/imagearc.xml:1.9 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagearc.xml Sat Jan 13 17:11:45 2007 @@ -1,38 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagearc"> - <refnamediv> - <refname>imagearc</refname> - <refpurpose>Draw a partial ellipse</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagearc</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>cx</parameter></methodparam> - <methodparam><type>int</type><parameter>cy</parameter></methodparam> - <methodparam><type>int</type><parameter>w</parameter></methodparam> - <methodparam><type>int</type><parameter>h</parameter></methodparam> - <methodparam><type>int</type><parameter>s</parameter></methodparam> - <methodparam><type>int</type><parameter>e</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagearc</function> draws a partial ellipse centered at - <parameter>cx</parameter>, <parameter>cy</parameter> (top left is - 0, 0) in the image represented by <parameter>image</parameter>. - <parameter>W</parameter> - and <parameter>h</parameter> specifies the ellipse's width and - height respectively while the start and end points are specified - in degrees indicated by the <parameter>s</parameter> and - <parameter>e</parameter> arguments. 0&deg; is located at the three-o'clock - position, and the arc is drawn clockwise. - </para> - <example> - <title>Drawing a circle with <function>imagearc</function></title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.imagearc"> + <refnamediv> + <refname>imagearc</refname> + <refpurpose>Draw a partial ellipse</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagearc</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>cx</parameter></methodparam> + <methodparam><type>int</type><parameter>cy</parameter></methodparam> + <methodparam><type>int</type><parameter>w</parameter></methodparam> + <methodparam><type>int</type><parameter>h</parameter></methodparam> + <methodparam><type>int</type><parameter>s</parameter></methodparam> + <methodparam><type>int</type><parameter>e</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagearc</function> draws a partial ellipse centered at + <parameter>cx</parameter>, <parameter>cy</parameter> (top left is + 0, 0) in the image represented by <parameter>image</parameter>. + <parameter>W</parameter> + and <parameter>h</parameter> specifies the ellipse's width and + height respectively while the start and end points are specified + in degrees indicated by the <parameter>s</parameter> and + <parameter>e</parameter> arguments. 0&deg; is located at the three-o'clock + position, and the arc is drawn clockwise. + </para> + <example> + <title>Drawing a circle with <function>imagearc</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -42,28 +41,28 @@ // allocate some colors $white = imagecolorallocate($img, 255, 255, 255); $black = imagecolorallocate($img, 0, 0, 0); - -// draw a black circle + +// draw a black circle imagearc($img, 100, 100, 150, 150, 0, 360, $black); // output image in the browser header("Content-type: image/png"); imagepng($img); - + // free memory imagedestroy($img); ?> ]]> - </programlisting> - </example> - <para> - See also <function>imageellipse</function>, - <function>imagefilledellipse</function>, and - <function>imagefilledarc</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + <para> + See also <function>imageellipse</function>, + <function>imagefilledellipse</function>, and + <function>imagefilledarc</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagechar.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/image/functions/imagechar.xml diff -u phpdoc/en/reference/image/functions/imagechar.xml:1.10 phpdoc/en/reference/image/functions/imagechar.xml:1.11 --- phpdoc/en/reference/image/functions/imagechar.xml:1.10 Mon Jan 30 14:31:03 2006 +++ phpdoc/en/reference/image/functions/imagechar.xml Sat Jan 13 17:11:45 2007 @@ -1,35 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagechar"> - <refnamediv> - <refname>imagechar</refname> - <refpurpose>Draw a character horizontally</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagechar</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>font</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam><type>string</type><parameter>c</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagechar</function> draws the first character of - <parameter>c</parameter> in the image identified by - <parameter>image</parameter> with its upper-left at - <parameter>x</parameter>,<parameter>y</parameter> (top left is 0, - 0) with the color <parameter>color</parameter>. If <parameter>font</parameter> - is 1, 2, 3, 4 or 5, a built-in font is used (with higher numbers - corresponding to larger fonts). - </para> - <para> - <example> - <title><function>imagechar</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<refentry id="function.imagechar"> + <refnamediv> + <refname>imagechar</refname> + <refpurpose>Draw a character horizontally</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagechar</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>font</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam><type>string</type><parameter>c</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagechar</function> draws the first character of + <parameter>c</parameter> in the image identified by + <parameter>image</parameter> with its upper-left at + <parameter>x</parameter>,<parameter>y</parameter> (top left is 0, + 0) with the color <parameter>color</parameter>. If <parameter>font</parameter> + is 1, 2, 3, 4 or 5, a built-in font is used (with higher numbers + corresponding to larger fonts). + </para> + <para> + <example> + <title><function>imagechar</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -48,15 +47,15 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imagecharup</function> and - <function>imageloadfont</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imagecharup</function> and + <function>imageloadfont</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecharup.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/image/functions/imagecharup.xml diff -u phpdoc/en/reference/image/functions/imagecharup.xml:1.9 phpdoc/en/reference/image/functions/imagecharup.xml:1.10 --- phpdoc/en/reference/image/functions/imagecharup.xml:1.9 Mon Jan 30 14:31:03 2006 +++ phpdoc/en/reference/image/functions/imagecharup.xml Sat Jan 13 17:11:45 2007 @@ -1,35 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecharup"> - <refnamediv> - <refname>imagecharup</refname> - <refpurpose>Draw a character vertically</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagecharup</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>font</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam><type>string</type><parameter>c</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecharup</function> draws the character - <parameter>c</parameter> vertically in the image identified by - <parameter>image</parameter> at coordinates - <parameter>x</parameter>, <parameter>y</parameter> (top left is - 0, 0) with the color <parameter>color</parameter>. - If <parameter>font</parameter> is 1, 2, 3, 4 or 5, a built-in font is - used. - </para> - <para> - <example> - <title><function>imagecharup</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.imagecharup"> + <refnamediv> + <refname>imagecharup</refname> + <refpurpose>Draw a character vertically</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagecharup</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>font</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam><type>string</type><parameter>c</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecharup</function> draws the character + <parameter>c</parameter> vertically in the image identified by + <parameter>image</parameter> at coordinates + <parameter>x</parameter>, <parameter>y</parameter> (top left is + 0, 0) with the color <parameter>color</parameter>. + If <parameter>font</parameter> is 1, 2, 3, 4 or 5, a built-in font is + used. + </para> + <para> + <example> + <title><function>imagecharup</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -48,15 +47,15 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imagechar</function> and - <function>imageloadfont</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imagechar</function> and + <function>imageloadfont</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorallocate.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorallocate.xml diff -u phpdoc/en/reference/image/functions/imagecolorallocate.xml:1.11 phpdoc/en/reference/image/functions/imagecolorallocate.xml:1.12 --- phpdoc/en/reference/image/functions/imagecolorallocate.xml:1.11 Mon Oct 16 19:25:44 2006 +++ phpdoc/en/reference/image/functions/imagecolorallocate.xml Sat Jan 13 17:11:45 2007 @@ -1,43 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorallocate"> - <refnamediv> - <refname>imagecolorallocate</refname> - <refpurpose>Allocate a color for an image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorallocate</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.12 $ --> +<refentry id="function.imagecolorallocate"> + <refnamediv> + <refname>imagecolorallocate</refname> + <refpurpose>Allocate a color for an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorallocate</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecolorallocate</function> returns a color + identifier representing the color composed of the given + <acronym>RGB</acronym> components. + <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 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> - <function>imagecolorallocate</function> returns a color - identifier representing the color composed of the given - <acronym>RGB</acronym> components. - <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 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>. + The first call to <function>imagecolorallocate</function> fills + the background color in palette-based images - images created using + <function>imagecreate</function>. </para> - <note> - <para> - The first call to <function>imagecolorallocate</function> fills - the background color in palette-based images - images created using - <function>imagecreate</function>. - </para> - </note> - <para> - <example> - <title><function>imagecolorallocate</function> example</title> - <programlisting role="php"> + </note> + <para> + <example> + <title><function>imagecolorallocate</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -56,18 +55,18 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - Returns -1 if the allocation failed. - </para> - <para> - See also <function>imagecolorallocatealpha</function> and - <function>imagecolordeallocate</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + Returns -1 if the allocation failed. + </para> + <para> + See also <function>imagecolorallocatealpha</function> and + <function>imagecolordeallocate</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorallocatealpha.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorallocatealpha.xml diff -u phpdoc/en/reference/image/functions/imagecolorallocatealpha.xml:1.6 phpdoc/en/reference/image/functions/imagecolorallocatealpha.xml:1.7 --- phpdoc/en/reference/image/functions/imagecolorallocatealpha.xml:1.6 Fri Jun 11 08:25:38 2004 +++ phpdoc/en/reference/image/functions/imagecolorallocatealpha.xml Sat Jan 13 17:11:45 2007 @@ -1,35 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.imagecolorallocatealpha"> - <refnamediv> - <refname>imagecolorallocatealpha</refname> - <refpurpose>Allocate a color for an image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorallocatealpha</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - <methodparam><type>int</type><parameter>alpha</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecolorallocatealpha</function> behaves identically to - <function>imagecolorallocate</function> with the addition of the transparency - parameter <parameter>alpha</parameter> which may have a value between - <literal>0</literal> and <literal>127</literal>. <literal>0</literal> - indicates completely opaque while <literal>127</literal> indicates - completely transparent. - </para> - <para> - Returns &false; if the allocation failed. - </para> - <para> - <example> - <title>Example of using <function>imagecolorallocatealpha</function></title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<refentry id="function.imagecolorallocatealpha"> + <refnamediv> + <refname>imagecolorallocatealpha</refname> + <refpurpose>Allocate a color for an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorallocatealpha</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + <methodparam><type>int</type><parameter>alpha</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecolorallocatealpha</function> behaves identically to + <function>imagecolorallocate</function> with the addition of the transparency + parameter <parameter>alpha</parameter> which may have a value between + <literal>0</literal> and <literal>127</literal>. <literal>0</literal> + indicates completely opaque while <literal>127</literal> indicates + completely transparent. + </para> + <para> + Returns &false; if the allocation failed. + </para> + <para> + <example> + <title>Example of using <function>imagecolorallocatealpha</function></title> + <programlisting role="php"> <![CDATA[ <?php $size = 300; @@ -44,9 +44,9 @@ $yellow_x = 100; $yellow_y = 75; $red_x = 120; -$red_y = 165; +$red_y = 165; $blue_x = 187; -$blue_y = 125; +$blue_y = 125; $radius = 150; // allocate colors with alpha values @@ -56,7 +56,7 @@ // drawing 3 overlapped circle imagefilledellipse($image, $yellow_x, $yellow_y, $radius, $radius, $yellow); -imagefilledellipse($image, $red_x, $red_y, $radius, $radius, $red); +imagefilledellipse($image, $red_x, $red_y, $radius, $radius, $red); imagefilledellipse($image, $blue_x, $blue_y, $radius, $radius, $blue); // don't forget to output a correct header! @@ -67,16 +67,16 @@ imagedestroy($image); ?> ]]> - </programlisting> - </example> - </para> - &note.gd.2; - <para> - See also <function>imagecolorallocate</function> and - <function>imagecolordeallocate</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.gd.2; + <para> + See also <function>imagecolorallocate</function> and + <function>imagecolordeallocate</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorat.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorat.xml diff -u phpdoc/en/reference/image/functions/imagecolorat.xml:1.4 phpdoc/en/reference/image/functions/imagecolorat.xml:1.5 --- phpdoc/en/reference/image/functions/imagecolorat.xml:1.4 Wed Oct 16 23:47:42 2002 +++ phpdoc/en/reference/image/functions/imagecolorat.xml Sat Jan 13 17:11:45 2007 @@ -1,31 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorat"> - <refnamediv> - <refname>imagecolorat</refname> - <refpurpose>Get the index of the color of a pixel</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorat</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - </methodsynopsis> - <para> - Returns the index of the color of the pixel at the - specified location in the image specified by <parameter>image</parameter>. - </para> - <para> - If PHP is compiled against GD library 2.0 or higher and the image is a - truecolor image, this function returns the RGB value of that pixel as - integer. Use bitshifting and masking to access the distinct red, green and blue - component values: - <example> - <title>Access distinct RGB values</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecolorat"> + <refnamediv> + <refname>imagecolorat</refname> + <refpurpose>Get the index of the color of a pixel</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorat</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + </methodsynopsis> + <para> + Returns the index of the color of the pixel at the + specified location in the image specified by <parameter>image</parameter>. + </para> + <para> + If PHP is compiled against GD library 2.0 or higher and the image is a + truecolor image, this function returns the RGB value of that pixel as + integer. Use bitshifting and masking to access the distinct red, green and blue + component values: + <example> + <title>Access distinct RGB values</title> + <programlisting role="php"> <![CDATA[ <?php $im = ImageCreateFromPng("rockym.png"); @@ -35,15 +34,15 @@ $b = $rgb & 0xFF; ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imagecolorset</function> and - <function>imagecolorsforindex</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imagecolorset</function> and + <function>imagecolorsforindex</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorclosest.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorclosest.xml diff -u phpdoc/en/reference/image/functions/imagecolorclosest.xml:1.4 phpdoc/en/reference/image/functions/imagecolorclosest.xml:1.5 --- phpdoc/en/reference/image/functions/imagecolorclosest.xml:1.4 Tue Jul 27 16:08:13 2004 +++ phpdoc/en/reference/image/functions/imagecolorclosest.xml Sat Jan 13 17:11:45 2007 @@ -1,38 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorclosest"> - <refnamediv> - <refname>imagecolorclosest</refname> - <refpurpose>Get the index of the closest color to the specified color</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorclosest</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - </methodsynopsis> - <para> - Returns the index of the color in the palette of the image which - is "closest" to the specified <acronym>RGB</acronym> value. - </para> - <para> - The "distance" between the desired color and each color in the - palette is calculated as if the <acronym>RGB</acronym> values - represented points in three-dimensional space. - </para> - <para> - If you created the image from a file, only colors used in the image are - resolved. Colors present only in the pallete are not resolved. - </para> - <para> - See also <function>imagecolorexact</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecolorclosest"> + <refnamediv> + <refname>imagecolorclosest</refname> + <refpurpose>Get the index of the closest color to the specified color</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorclosest</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + </methodsynopsis> + <para> + Returns the index of the color in the palette of the image which + is "closest" to the specified <acronym>RGB</acronym> value. + </para> + <para> + The "distance" between the desired color and each color in the + palette is calculated as if the <acronym>RGB</acronym> values + represented points in three-dimensional space. + </para> + <para> + If you created the image from a file, only colors used in the image are + resolved. Colors present only in the pallete are not resolved. + </para> + <para> + See also <function>imagecolorexact</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml diff -u phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml:1.5 phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml:1.6 --- phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml:1.5 Fri Jun 11 08:25:38 2004 +++ phpdoc/en/reference/image/functions/imagecolorclosestalpha.xml Sat Jan 13 17:11:45 2007 @@ -1,31 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorclosestalpha"> - <refnamediv> - <refname>imagecolorclosestalpha</refname> - <refpurpose>Get the index of the closest color to the specified color + alpha</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorclosestalpha</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - <methodparam><type>int</type><parameter>alpha</parameter></methodparam> - </methodsynopsis> - <para> - 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.gd.2; - <para> - See also <function>imagecolorexactalpha</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagecolorclosestalpha"> + <refnamediv> + <refname>imagecolorclosestalpha</refname> + <refpurpose>Get the index of the closest color to the specified color + alpha</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorclosestalpha</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + <methodparam><type>int</type><parameter>alpha</parameter></methodparam> + </methodsynopsis> + <para> + 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.gd.2; + <para> + See also <function>imagecolorexactalpha</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorclosesthwb.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorclosesthwb.xml diff -u phpdoc/en/reference/image/functions/imagecolorclosesthwb.xml:1.3 phpdoc/en/reference/image/functions/imagecolorclosesthwb.xml:1.4 --- phpdoc/en/reference/image/functions/imagecolorclosesthwb.xml:1.3 Thu Apr 18 17:13:09 2002 +++ phpdoc/en/reference/image/functions/imagecolorclosesthwb.xml Sat Jan 13 17:11:45 2007 @@ -1,27 +1,24 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.78 --> - <refentry id='function.imagecolorclosesthwb'> - <refnamediv> - <refname>imagecolorclosesthwb</refname> - <refpurpose> - Get the index of the color which has the hue, white and blackness nearest to the given color - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorclosesthwb</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id='function.imagecolorclosesthwb'> + <refnamediv> + <refname>imagecolorclosesthwb</refname> + <refpurpose>Get the index of the color which has the hue, white and blackness nearest to the given color</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorclosesthwb</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + </methodsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolordeallocate.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolordeallocate.xml diff -u phpdoc/en/reference/image/functions/imagecolordeallocate.xml:1.7 phpdoc/en/reference/image/functions/imagecolordeallocate.xml:1.8 --- phpdoc/en/reference/image/functions/imagecolordeallocate.xml:1.7 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagecolordeallocate.xml Sat Jan 13 17:11:45 2007 @@ -1,40 +1,39 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolordeallocate"> - <refnamediv> - <refname>imagecolordeallocate</refname> - <refpurpose>De-allocate a color for an image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagecolordeallocate</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - The <function>imagecolordeallocate</function> function - de-allocates a color previously allocated with - <function>imagecolorallocate</function> or - <function>imagecolorallocatealpha</function>. - <informalexample> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.imagecolordeallocate"> + <refnamediv> + <refname>imagecolordeallocate</refname> + <refpurpose>De-allocate a color for an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagecolordeallocate</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + The <function>imagecolordeallocate</function> function + de-allocates a color previously allocated with + <function>imagecolorallocate</function> or + <function>imagecolorallocatealpha</function>. + <informalexample> + <programlisting role="php"> <![CDATA[ <?php $white = imagecolorallocate($im, 255, 255, 255); imagecolordeallocate($im, $white); ?> ]]> - </programlisting> - </informalexample> - </para> - <para> - See also <function>imagecolorallocate</function> and - <function>imagecolorallocatealpha</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </informalexample> + </para> + <para> + See also <function>imagecolorallocate</function> and + <function>imagecolorallocatealpha</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorexact.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorexact.xml diff -u phpdoc/en/reference/image/functions/imagecolorexact.xml:1.4 phpdoc/en/reference/image/functions/imagecolorexact.xml:1.5 --- phpdoc/en/reference/image/functions/imagecolorexact.xml:1.4 Tue Jul 27 16:08:13 2004 +++ phpdoc/en/reference/image/functions/imagecolorexact.xml Sat Jan 13 17:11:45 2007 @@ -1,37 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorexact"> - <refnamediv> - <refname>imagecolorexact</refname> - <refpurpose>Get the index of the specified color</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorexact</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - </methodsynopsis> - <para> - Returns the index of the specified color in the palette of the - image. - </para> - <para> - If the color does not exist in the image's palette, -1 is - returned. - </para> - <para> - If you created the image from a file, only colors used in the image are - resolved. Colors present only in the pallete are not resolved. - </para> - <para> - See also <function>imagecolorclosest</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecolorexact"> + <refnamediv> + <refname>imagecolorexact</refname> + <refpurpose>Get the index of the specified color</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorexact</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + </methodsynopsis> + <para> + Returns the index of the specified color in the palette of the + image. + </para> + <para> + If the color does not exist in the image's palette, -1 is + returned. + </para> + <para> + If you created the image from a file, only colors used in the image are + resolved. Colors present only in the pallete are not resolved. + </para> + <para> + See also <function>imagecolorclosest</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorexactalpha.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorexactalpha.xml diff -u phpdoc/en/reference/image/functions/imagecolorexactalpha.xml:1.4 phpdoc/en/reference/image/functions/imagecolorexactalpha.xml:1.5 --- phpdoc/en/reference/image/functions/imagecolorexactalpha.xml:1.4 Fri Jun 11 08:25:38 2004 +++ phpdoc/en/reference/image/functions/imagecolorexactalpha.xml Sat Jan 13 17:11:45 2007 @@ -1,35 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorexactalpha"> - <refnamediv> - <refname>imagecolorexactalpha</refname> - <refpurpose>Get the index of the specified color + alpha</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorexactalpha</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - <methodparam><type>int</type><parameter>alpha</parameter></methodparam> - </methodsynopsis> - <para> - Returns the index of the specified color+alpha in the palette of the - image. - </para> - <para> - If the color does not exist in the image's palette, -1 is - returned. - </para> - &note.gd.2; - <para> - See also <function>imagecolorclosestalpha</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecolorexactalpha"> + <refnamediv> + <refname>imagecolorexactalpha</refname> + <refpurpose>Get the index of the specified color + alpha</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorexactalpha</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + <methodparam><type>int</type><parameter>alpha</parameter></methodparam> + </methodsynopsis> + <para> + Returns the index of the specified color+alpha in the palette of the + image. + </para> + <para> + If the color does not exist in the image's palette, -1 is + returned. + </para> + &note.gd.2; + <para> + See also <function>imagecolorclosestalpha</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolormatch.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolormatch.xml diff -u phpdoc/en/reference/image/functions/imagecolormatch.xml:1.4 phpdoc/en/reference/image/functions/imagecolormatch.xml:1.5 --- phpdoc/en/reference/image/functions/imagecolormatch.xml:1.4 Fri Jun 11 08:25:38 2004 +++ phpdoc/en/reference/image/functions/imagecolormatch.xml Sat Jan 13 17:11:45 2007 @@ -1,39 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.imagecolormatch"> - <refnamediv> - <refname>imagecolormatch</refname> - <refpurpose> - Makes the colors of the palette version of an image more closely match - the true color version - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagecolormatch</methodname> - <methodparam><type>resource</type><parameter>image1</parameter></methodparam> - <methodparam><type>resource</type><parameter>image2</parameter></methodparam> - </methodsynopsis> - - &warn.undocumented.func; - - <para> - <parameter>image1</parameter> must be Truecolor, - <parameter>image2</parameter> must be Palette, and - both <parameter>image1</parameter> and <parameter>image2</parameter> - must be the same size. - </para> - <para> - &return.success; - </para> - &note.bundled.gd; - &note.gd.2; - <para> - See also <function>imagecreatetruecolor</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecolormatch"> + <refnamediv> + <refname>imagecolormatch</refname> + <refpurpose>Makes the colors of the palette version of an image more closely match the true color version</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagecolormatch</methodname> + <methodparam><type>resource</type><parameter>image1</parameter></methodparam> + <methodparam><type>resource</type><parameter>image2</parameter></methodparam> + </methodsynopsis> + + &warn.undocumented.func; + + <para> + <parameter>image1</parameter> must be Truecolor, + <parameter>image2</parameter> must be Palette, and + both <parameter>image1</parameter> and <parameter>image2</parameter> + must be the same size. + </para> + <para> + &return.success; + </para> + &note.bundled.gd; + &note.gd.2; + <para> + See also <function>imagecreatetruecolor</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorresolve.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorresolve.xml diff -u phpdoc/en/reference/image/functions/imagecolorresolve.xml:1.4 phpdoc/en/reference/image/functions/imagecolorresolve.xml:1.5 --- phpdoc/en/reference/image/functions/imagecolorresolve.xml:1.4 Tue Jul 27 16:08:13 2004 +++ phpdoc/en/reference/image/functions/imagecolorresolve.xml Sat Jan 13 17:11:45 2007 @@ -1,37 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorresolve"> - <refnamediv> - <refname>imagecolorresolve</refname> - <refpurpose> - Get the index of the specified color or its closest possible - alternative - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorresolve</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - </methodsynopsis> - <para> - This function is guaranteed to return a color index for a - requested color, either the exact color or the closest possible - alternative. - </para> - <para> - If you created the image from a file, only colors used in the image are - resolved. Colors present only in the pallete are not resolved. - </para> - <para> - See also <function>imagecolorclosest</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecolorresolve"> + <refnamediv> + <refname>imagecolorresolve</refname> + <refpurpose>Get the index of the specified color or its closest possible alternative</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorresolve</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + </methodsynopsis> + <para> + This function is guaranteed to return a color index for a + requested color, either the exact color or the closest possible + alternative. + </para> + <para> + If you created the image from a file, only colors used in the image are + resolved. Colors present only in the pallete are not resolved. + </para> + <para> + See also <function>imagecolorclosest</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorresolvealpha.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorresolvealpha.xml diff -u phpdoc/en/reference/image/functions/imagecolorresolvealpha.xml:1.4 phpdoc/en/reference/image/functions/imagecolorresolvealpha.xml:1.5 --- phpdoc/en/reference/image/functions/imagecolorresolvealpha.xml:1.4 Fri Jun 11 08:25:38 2004 +++ phpdoc/en/reference/image/functions/imagecolorresolvealpha.xml Sat Jan 13 17:11:45 2007 @@ -1,35 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorresolvealpha"> - <refnamediv> - <refname>imagecolorresolvealpha</refname> - <refpurpose> - Get the index of the specified color + alpha or its closest possible - alternative - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorresolvealpha</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - <methodparam><type>int</type><parameter>alpha</parameter></methodparam> - </methodsynopsis> - <para> - This function is guaranteed to return a color index for a - requested color, either the exact color or the closest possible - alternative. - </para> - &note.gd.2; - <para> - See also <function>imagecolorclosestalpha</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecolorresolvealpha"> + <refnamediv> + <refname>imagecolorresolvealpha</refname> + <refpurpose>Get the index of the specified color + alpha or its closest possible alternative</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorresolvealpha</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + <methodparam><type>int</type><parameter>alpha</parameter></methodparam> + </methodsynopsis> + <para> + This function is guaranteed to return a color index for a + requested color, either the exact color or the closest possible + alternative. + </para> + &note.gd.2; + <para> + See also <function>imagecolorclosestalpha</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorset.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorset.xml diff -u phpdoc/en/reference/image/functions/imagecolorset.xml:1.5 phpdoc/en/reference/image/functions/imagecolorset.xml:1.6 --- phpdoc/en/reference/image/functions/imagecolorset.xml:1.5 Fri Jun 24 13:24:32 2005 +++ phpdoc/en/reference/image/functions/imagecolorset.xml Sat Jan 13 17:11:45 2007 @@ -1,32 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorset"> - <refnamediv> - <refname>imagecolorset</refname> - <refpurpose>Set the color for the specified palette index</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>imagecolorset</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>index</parameter></methodparam> - <methodparam><type>int</type><parameter>red</parameter></methodparam> - <methodparam><type>int</type><parameter>green</parameter></methodparam> - <methodparam><type>int</type><parameter>blue</parameter></methodparam> - </methodsynopsis> - <para> - This sets the specified index in the palette to the specified - color. This is useful for creating flood-fill-like effects in - palleted images without the overhead of performing the actual - flood-fill. - </para> - <para> - See also <function>imagecolorat</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagecolorset"> + <refnamediv> + <refname>imagecolorset</refname> + <refpurpose>Set the color for the specified palette index</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>void</type><methodname>imagecolorset</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>index</parameter></methodparam> + <methodparam><type>int</type><parameter>red</parameter></methodparam> + <methodparam><type>int</type><parameter>green</parameter></methodparam> + <methodparam><type>int</type><parameter>blue</parameter></methodparam> + </methodsynopsis> + <para> + This sets the specified index in the palette to the specified + color. This is useful for creating flood-fill-like effects in + palleted images without the overhead of performing the actual + flood-fill. + </para> + <para> + See also <function>imagecolorat</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorsforindex.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorsforindex.xml diff -u phpdoc/en/reference/image/functions/imagecolorsforindex.xml:1.4 phpdoc/en/reference/image/functions/imagecolorsforindex.xml:1.5 --- phpdoc/en/reference/image/functions/imagecolorsforindex.xml:1.4 Fri Aug 15 22:50:50 2003 +++ phpdoc/en/reference/image/functions/imagecolorsforindex.xml Sat Jan 13 17:11:45 2007 @@ -1,27 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorsforindex"> - <refnamediv> - <refname>imagecolorsforindex</refname> - <refpurpose>Get the colors for an index</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imagecolorsforindex</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>index</parameter></methodparam> - </methodsynopsis> - <para> - 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"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecolorsforindex"> + <refnamediv> + <refname>imagecolorsforindex</refname> + <refpurpose>Get the colors for an index</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>imagecolorsforindex</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>index</parameter></methodparam> + </methodsynopsis> + <para> + 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 @@ -43,29 +42,29 @@ ?> ]]> - </programlisting> - <para> - This example will output : - </para> - <screen> + </programlisting> + <para> + This example will output : + </para> + <screen> <![CDATA[ Array ( - [red] => 226 - [green] => 222 - [blue] => 252 - [alpha] => 0 + [red] => 226 + [green] => 222 + [blue] => 252 + [alpha] => 0 ) ]]> - </screen> - </example> - </para> - <para> - See also <function>imagecolorat</function> and - <function>imagecolorexact</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + See also <function>imagecolorat</function> and + <function>imagecolorexact</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolorstotal.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolorstotal.xml diff -u phpdoc/en/reference/image/functions/imagecolorstotal.xml:1.4 phpdoc/en/reference/image/functions/imagecolorstotal.xml:1.5 --- phpdoc/en/reference/image/functions/imagecolorstotal.xml:1.4 Sun Mar 5 17:21:26 2006 +++ phpdoc/en/reference/image/functions/imagecolorstotal.xml Sat Jan 13 17:11:45 2007 @@ -1,27 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolorstotal"> - <refnamediv> - <refname>imagecolorstotal</refname> - <refpurpose>Find out the number of colors in an image's palette</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolorstotal</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - </methodsynopsis> - <para> - This returns the number of colors in the specified image's - palette or 0 for truecolor images. - </para> - <para> - See also <function>imagecolorat</function> and - <function>imagecolorsforindex</function>, <function>imageistruecolor</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecolorstotal"> + <refnamediv> + <refname>imagecolorstotal</refname> + <refpurpose>Find out the number of colors in an image's palette</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolorstotal</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + </methodsynopsis> + <para> + This returns the number of colors in the specified image's + palette or 0 for truecolor images. + </para> + <para> + See also <function>imagecolorat</function> and + <function>imagecolorsforindex</function>, <function>imageistruecolor</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecolortransparent.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imagecolortransparent.xml diff -u phpdoc/en/reference/image/functions/imagecolortransparent.xml:1.7 phpdoc/en/reference/image/functions/imagecolortransparent.xml:1.8 --- phpdoc/en/reference/image/functions/imagecolortransparent.xml:1.7 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagecolortransparent.xml Sat Jan 13 17:11:45 2007 @@ -1,46 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecolortransparent"> - <refnamediv> - <refname>imagecolortransparent</refname> - <refpurpose>Define a color as transparent</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagecolortransparent</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.8 $ --> +<refentry id="function.imagecolortransparent"> + <refnamediv> + <refname>imagecolortransparent</refname> + <refpurpose>Define a color as transparent</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagecolortransparent</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecolortransparent</function> sets the transparent + color in the <parameter>image</parameter> image to + <parameter>color</parameter>. <parameter>image</parameter> is the + image identifier returned by <function>imagecreatetruecolor</function> and + <parameter>color</parameter> is a color identifier returned by + <function>imagecolorallocate</function>. + </para> + <note> <para> - <function>imagecolortransparent</function> sets the transparent - color in the <parameter>image</parameter> image to - <parameter>color</parameter>. <parameter>image</parameter> is the - image identifier returned by <function>imagecreatetruecolor</function> and - <parameter>color</parameter> is a color identifier returned by - <function>imagecolorallocate</function>. + The transparent color is a property of the image, transparency is not a + property of the color. Once you have set a color to be the transparent + color, any regions of the image in that color that were drawn previously + will be transparent. </para> - <note> - <para> - The transparent color is a property of the image, transparency is not a - property of the color. Once you have set a color to be the transparent - color, any regions of the image in that color that were drawn previously - will be transparent. - </para> - </note> + </note> + <para> + The identifier of the new (or current, if none is specified) + transparent color is returned. + </para> + <note> <para> - The identifier of the new (or current, if none is specified) - transparent color is returned. + Transparency is copied only with <function>imagecopymerge</function> and + true color images, not with <function>imagecopy</function> or pallete images. </para> - <note> - <para> - Transparency is copied only with <function>imagecopymerge</function> and - true color images, not with <function>imagecopy</function> or pallete images. - </para> - </note> - </refsect1> - </refentry> + </note> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imageconvolution.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/image/functions/imageconvolution.xml diff -u phpdoc/en/reference/image/functions/imageconvolution.xml:1.1 phpdoc/en/reference/image/functions/imageconvolution.xml:1.2 --- phpdoc/en/reference/image/functions/imageconvolution.xml:1.1 Thu Jun 16 13:31:15 2005 +++ phpdoc/en/reference/image/functions/imageconvolution.xml Sat Jan 13 17:11:45 2007 @@ -1,28 +1,26 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.1 $ --> - <refentry id="function.imageconvolution"> - <refnamediv> - <refname>imageconvolution</refname> - <refpurpose> - Apply a 3x3 convolution matrix, using coefficient div and offset - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imageconvolution</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>array</type><parameter>matrix3x3</parameter></methodparam> - <methodparam><type>float</type><parameter>div</parameter></methodparam> - <methodparam><type>float</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - &return.success; - </para> - &warn.undocumented.func; - &note.bundled.gd; - </refsect1> - </refentry> +<!-- $Revision: 1.2 $ --> +<refentry id="function.imageconvolution"> + <refnamediv> + <refname>imageconvolution</refname> + <refpurpose>Apply a 3x3 convolution matrix, using coefficient div and offset</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imageconvolution</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>array</type><parameter>matrix3x3</parameter></methodparam> + <methodparam><type>float</type><parameter>div</parameter></methodparam> + <methodparam><type>float</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> + &return.success; + </para> + &warn.undocumented.func; + &note.bundled.gd; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecopy.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/image/functions/imagecopy.xml diff -u phpdoc/en/reference/image/functions/imagecopy.xml:1.3 phpdoc/en/reference/image/functions/imagecopy.xml:1.4 --- phpdoc/en/reference/image/functions/imagecopy.xml:1.3 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagecopy.xml Sat Jan 13 17:11:45 2007 @@ -1,35 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecopy"> - <refnamediv> - <refname>imagecopy</refname> - <refpurpose>Copy part of an image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagecopy</methodname> - <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - </methodsynopsis> - <para> - Copy a part of <parameter>src_im</parameter> onto - <parameter>dst_im</parameter> starting at the x,y coordinates - <parameter>src_x</parameter>, <parameter>src_y </parameter> with - a width of <parameter>src_w</parameter> and a height of - <parameter>src_h</parameter>. The portion defined will be copied - onto the x,y coordinates, <parameter>dst_x</parameter> and - <parameter>dst_y</parameter>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.imagecopy"> + <refnamediv> + <refname>imagecopy</refname> + <refpurpose>Copy part of an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagecopy</methodname> + <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + </methodsynopsis> + <para> + Copy a part of <parameter>src_im</parameter> onto + <parameter>dst_im</parameter> starting at the x,y coordinates + <parameter>src_x</parameter>, <parameter>src_y </parameter> with + a width of <parameter>src_w</parameter> and a height of + <parameter>src_h</parameter>. The portion defined will be copied + onto the x,y coordinates, <parameter>dst_x</parameter> and + <parameter>dst_y</parameter>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecopymerge.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecopymerge.xml diff -u phpdoc/en/reference/image/functions/imagecopymerge.xml:1.4 phpdoc/en/reference/image/functions/imagecopymerge.xml:1.5 --- phpdoc/en/reference/image/functions/imagecopymerge.xml:1.4 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagecopymerge.xml Sat Jan 13 17:11:45 2007 @@ -1,42 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecopymerge"> - <refnamediv> - <refname>imagecopymerge</refname> - <refpurpose>Copy and merge part of an image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagecopymerge</methodname> - <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - <methodparam><type>int</type><parameter>pct</parameter></methodparam> - </methodsynopsis> - <para> - Copy a part of <parameter>src_im</parameter> onto - <parameter>dst_im</parameter> starting at the x,y coordinates - <parameter>src_x</parameter>, <parameter>src_y </parameter> with - a width of <parameter>src_w</parameter> and a height of - <parameter>src_h</parameter>. The portion defined will be copied - onto the x,y coordinates, <parameter>dst_x</parameter> and - <parameter>dst_y</parameter>. - The two images will be merged according to <parameter>pct</parameter> - which can range from 0 to 100. When <parameter>pct</parameter> = 0, - no action is taken, when 100 this function behaves identically - to <function>imagecopy</function> for pallete images, while it - implements alpha transparency for true colour images. - </para> - <note><para>This function was added in PHP 4.0.6</para></note> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecopymerge"> + <refnamediv> + <refname>imagecopymerge</refname> + <refpurpose>Copy and merge part of an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagecopymerge</methodname> + <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + <methodparam><type>int</type><parameter>pct</parameter></methodparam> + </methodsynopsis> + <para> + Copy a part of <parameter>src_im</parameter> onto + <parameter>dst_im</parameter> starting at the x,y coordinates + <parameter>src_x</parameter>, <parameter>src_y </parameter> with + a width of <parameter>src_w</parameter> and a height of + <parameter>src_h</parameter>. The portion defined will be copied + onto the x,y coordinates, <parameter>dst_x</parameter> and + <parameter>dst_y</parameter>. + The two images will be merged according to <parameter>pct</parameter> + which can range from 0 to 100. When <parameter>pct</parameter> = 0, + no action is taken, when 100 this function behaves identically + to <function>imagecopy</function> for pallete images, while it + implements alpha transparency for true colour images. + </para> + <note><para>This function was added in PHP 4.0.6</para></note> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecopymergegray.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecopymergegray.xml diff -u phpdoc/en/reference/image/functions/imagecopymergegray.xml:1.4 phpdoc/en/reference/image/functions/imagecopymergegray.xml:1.5 --- phpdoc/en/reference/image/functions/imagecopymergegray.xml:1.4 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagecopymergegray.xml Sat Jan 13 17:11:45 2007 @@ -1,46 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecopymergegray"> - <refnamediv> - <refname>imagecopymergegray</refname> - <refpurpose>Copy and merge part of an image with gray scale</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagecopymergegray</methodname> - <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - <methodparam><type>int</type><parameter>pct</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecopymergegray</function> copy a part of <parameter>src_im</parameter> onto - <parameter>dst_im</parameter> starting at the x,y coordinates - <parameter>src_x</parameter>, <parameter>src_y </parameter> with - a width of <parameter>src_w</parameter> and a height of - <parameter>src_h</parameter>. The portion defined will be copied - onto the x,y coordinates, <parameter>dst_x</parameter> and - <parameter>dst_y</parameter>. - The two images will be merged according to <parameter>pct</parameter> - which can range from 0 to 100. When <parameter>pct</parameter> = 0, - no action is taken, when 100 this function behaves identically - to <function>imagecopy</function>. - </para> - <para> - This function is identical to <function>imagecopymerge</function> except - that when merging it preserves the hue of the source by converting - the destination pixels to gray scale before the copy operation. - </para> - <note><para>This function was added in PHP 4.0.6</para></note> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecopymergegray"> + <refnamediv> + <refname>imagecopymergegray</refname> + <refpurpose>Copy and merge part of an image with gray scale</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagecopymergegray</methodname> + <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + <methodparam><type>int</type><parameter>pct</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecopymergegray</function> copy a part of <parameter>src_im</parameter> onto + <parameter>dst_im</parameter> starting at the x,y coordinates + <parameter>src_x</parameter>, <parameter>src_y </parameter> with + a width of <parameter>src_w</parameter> and a height of + <parameter>src_h</parameter>. The portion defined will be copied + onto the x,y coordinates, <parameter>dst_x</parameter> and + <parameter>dst_y</parameter>. + The two images will be merged according to <parameter>pct</parameter> + which can range from 0 to 100. When <parameter>pct</parameter> = 0, + no action is taken, when 100 this function behaves identically + to <function>imagecopy</function>. + </para> + <para> + This function is identical to <function>imagecopymerge</function> except + that when merging it preserves the hue of the source by converting + the destination pixels to gray scale before the copy operation. + </para> + <note><para>This function was added in PHP 4.0.6</para></note> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecopyresampled.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imagecopyresampled.xml diff -u phpdoc/en/reference/image/functions/imagecopyresampled.xml:1.7 phpdoc/en/reference/image/functions/imagecopyresampled.xml:1.8 --- phpdoc/en/reference/image/functions/imagecopyresampled.xml:1.7 Sat Aug 5 16:06:29 2006 +++ phpdoc/en/reference/image/functions/imagecopyresampled.xml Sat Jan 13 17:11:45 2007 @@ -1,70 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecopyresampled"> - <refnamediv> - <refname>imagecopyresampled</refname> - <refpurpose>Copy and resize part of an image with resampling</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagecopyresampled</methodname> - <methodparam><type>resource</type><parameter>dst_image</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_image</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_w</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_h</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.8 $ --> +<refentry id="function.imagecopyresampled"> + <refnamediv> + <refname>imagecopyresampled</refname> + <refpurpose>Copy and resize part of an image with resampling</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagecopyresampled</methodname> + <methodparam><type>resource</type><parameter>dst_image</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_image</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_w</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_h</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecopyresampled</function> copies a rectangular + portion of one image to another image, smoothly interpolating pixel + values so that, in particular, reducing the size of an image still + retains a great deal of clarity. + &return.success; + </para> + <para> + <parameter>dst_image</parameter> is the destination image, + <parameter>src_image</parameter> is the source image identifier. If + the source and destination coordinates and width and heights + differ, appropriate stretching or shrinking of the image fragment + will be performed. The coordinates refer to the upper left + corner. This function can be used to copy regions within the + same image (if <parameter>dst_image</parameter> is the same as + <parameter>src_image</parameter>) but if the regions overlap the + results will be unpredictable. + </para> + <note> <para> - <function>imagecopyresampled</function> copies a rectangular - portion of one image to another image, smoothly interpolating pixel - values so that, in particular, reducing the size of an image still - retains a great deal of clarity. - &return.success; + There is a problem due to palette image limitations (255+1 colors). + Resampling or filtering an image commonly needs more colors than 255, a + kind of approximation is used to calculate the new resampled pixel and its + color. With a palette image we try to allocate a new color, if that + failed, we choose the closest (in theory) computed color. This is + not always the closest visual color. That may produce a weird result, like + blank (or visually blank) images. To skip this problem, please use a + truecolor image as a destination image, such as one created by + <function>imagecreatetruecolor</function>. </para> - <para> - <parameter>dst_image</parameter> is the destination image, - <parameter>src_image</parameter> is the source image identifier. If - the source and destination coordinates and width and heights - differ, appropriate stretching or shrinking of the image fragment - will be performed. The coordinates refer to the upper left - corner. This function can be used to copy regions within the - same image (if <parameter>dst_image</parameter> is the same as - <parameter>src_image</parameter>) but if the regions overlap the - results will be unpredictable. - </para> - <note> + </note> + &note.gd.2; + </refsect1> + + <refsect1> + &reftitle.examples; + + <para> + <example> + <title>Simple example</title> <para> - There is a problem due to palette image limitations (255+1 colors). - Resampling or filtering an image commonly needs more colors than 255, a - kind of approximation is used to calculate the new resampled pixel and its - color. With a palette image we try to allocate a new color, if that - failed, we choose the closest (in theory) computed color. This is - not always the closest visual color. That may produce a weird result, like - blank (or visually blank) images. To skip this problem, please use a - truecolor image as a destination image, such as one created by - <function>imagecreatetruecolor</function>. + This example will resample an image to half its original size. </para> - </note> - &note.gd.2; - </refsect1> - - <refsect1> - &reftitle.examples; - - <para> - <example> - <title>Simple example</title> - <para> - This example will resample an image to half its original size. - </para> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php // The file @@ -88,18 +87,18 @@ imagejpeg($image_p, null, 100); ?> ]]> - </programlisting> - </example> - </para> - - <para> - <example> - <title>Resampling an image proportionally</title> - <para> - This example will display an image with the maximum width, - or height, of 200 pixels. - </para> - <programlisting role="php"> + </programlisting> + </example> + </para> + + <para> + <example> + <title>Resampling an image proportionally</title> + <para> + This example will display an image with the maximum width, + or height, of 200 pixels. + </para> + <programlisting role="php"> <![CDATA[ <?php // The file @@ -118,9 +117,9 @@ $ratio_orig = $width_orig/$height_orig; if ($width/$height > $ratio_orig) { - $width = $height*$ratio_orig; + $width = $height*$ratio_orig; } else { - $height = $width/$ratio_orig; + $height = $width/$ratio_orig; } // Resample @@ -132,18 +131,18 @@ imagejpeg($image_p, null, 100); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - - <refsect1> - &reftitle.seealso; - <para> - <function>imagecopyresized</function> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1> + &reftitle.seealso; + <para> + <function>imagecopyresized</function> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecopyresized.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imagecopyresized.xml diff -u phpdoc/en/reference/image/functions/imagecopyresized.xml:1.6 phpdoc/en/reference/image/functions/imagecopyresized.xml:1.7 --- phpdoc/en/reference/image/functions/imagecopyresized.xml:1.6 Mon Aug 8 23:57:05 2005 +++ phpdoc/en/reference/image/functions/imagecopyresized.xml Sat Jan 13 17:11:45 2007 @@ -1,63 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecopyresized"> - <refnamediv> - <refname>imagecopyresized</refname> - <refpurpose>Copy and resize part of an image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagecopyresized</methodname> - <methodparam><type>resource</type><parameter>dst_image</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_image</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_w</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_h</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.7 $ --> +<refentry id="function.imagecopyresized"> + <refnamediv> + <refname>imagecopyresized</refname> + <refpurpose>Copy and resize part of an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagecopyresized</methodname> + <methodparam><type>resource</type><parameter>dst_image</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_image</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_w</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_h</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecopyresized</function> copies a rectangular + portion of one image to another image. + <parameter>dst_image</parameter> is the destination image, + <parameter>src_image</parameter> is the source image identifier. + If the source and destination coordinates and width and heights + differ, appropriate stretching or shrinking of the image fragment + will be performed. The coordinates refer to the upper left + corner. This function can be used to copy regions within the + same image (if <parameter>dst_image</parameter> is the same as + <parameter>src_image</parameter>) but if the regions overlap the + results will be unpredictable. + </para> + <note> <para> - <function>imagecopyresized</function> copies a rectangular - portion of one image to another image. - <parameter>dst_image</parameter> is the destination image, - <parameter>src_image</parameter> is the source image identifier. - If the source and destination coordinates and width and heights - differ, appropriate stretching or shrinking of the image fragment - will be performed. The coordinates refer to the upper left - corner. This function can be used to copy regions within the - same image (if <parameter>dst_image</parameter> is the same as - <parameter>src_image</parameter>) but if the regions overlap the - results will be unpredictable. + There is a problem due to palette image limitations (255+1 colors). + Resampling or filtering an image commonly needs more colors than 255, a + kind of approximation is used to calculate the new resampled pixel and its + color. With a palette image we try to allocate a new color, if that + failed, we choose the closest (in theory) computed color. This is + not always the closest visual color. That may produce a weird result, like + blank (or visually blank) images. To skip this problem, please use a + truecolor image as a destination image, such as one created by + <function>imagecreatetruecolor</function>. </para> - <note> + </note> + </refsect1> + + <refsect1> + &reftitle.examples; + <para> + <example> + <title>Resizing an image</title> <para> - There is a problem due to palette image limitations (255+1 colors). - Resampling or filtering an image commonly needs more colors than 255, a - kind of approximation is used to calculate the new resampled pixel and its - color. With a palette image we try to allocate a new color, if that - failed, we choose the closest (in theory) computed color. This is - not always the closest visual color. That may produce a weird result, like - blank (or visually blank) images. To skip this problem, please use a - truecolor image as a destination image, such as one created by - <function>imagecreatetruecolor</function>. + This example will display the image at half size. </para> - </note> - </refsect1> - - <refsect1> - &reftitle.examples; - <para> - <example> - <title>Resizing an image</title> - <para> - This example will display the image at half size. - </para> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php // File and new size @@ -83,22 +82,22 @@ imagejpeg($thumb); ?> ]]> - </programlisting> - <para> - The image will be output at half size, though better - quality could be obtained using <function>imagecopyresampled</function>. - </para> - </example> - </para> - </refsect1> - - <refsect1> - &reftitle.seealso; - <para> - <function>imagecopyresampled</function> - </para> - </refsect1> - </refentry> + </programlisting> + <para> + The image will be output at half size, though better + quality could be obtained using <function>imagecopyresampled</function>. + </para> + </example> + </para> + </refsect1> + + <refsect1> + &reftitle.seealso; + <para> + <function>imagecopyresampled</function> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreate.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreate.xml diff -u phpdoc/en/reference/image/functions/imagecreate.xml:1.8 phpdoc/en/reference/image/functions/imagecreate.xml:1.9 --- phpdoc/en/reference/image/functions/imagecreate.xml:1.8 Fri Jul 16 12:41:51 2004 +++ phpdoc/en/reference/image/functions/imagecreate.xml Sat Jan 13 17:11:45 2007 @@ -1,32 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagecreate"> - <refnamediv> - <refname>imagecreate</refname> - <refpurpose>Create a new palette based image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreate</methodname> - <methodparam><type>int</type><parameter>x_size</parameter></methodparam> - <methodparam><type>int</type><parameter>y_size</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreate</function> returns an image identifier - representing a blank image of size <parameter>x_size</parameter> - by <parameter>y_size</parameter>. - </para> - <para> - We recommend the use of <function>imagecreatetruecolor</function>. - </para> - <para> - <example> - <title> - Creating a new GD image stream and outputting an image. - </title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.imagecreate"> + <refnamediv> + <refname>imagecreate</refname> + <refpurpose>Create a new palette based image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreate</methodname> + <methodparam><type>int</type><parameter>x_size</parameter></methodparam> + <methodparam><type>int</type><parameter>y_size</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreate</function> returns an image identifier + representing a blank image of size <parameter>x_size</parameter> + by <parameter>y_size</parameter>. + </para> + <para> + We recommend the use of <function>imagecreatetruecolor</function>. + </para> + <para> + <example> + <title> + Creating a new GD image stream and outputting an image. + </title> + <programlisting role="php"> <![CDATA[ <?php header("Content-type: image/png"); @@ -39,15 +38,15 @@ imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imagedestroy</function> and - <function>imagecreatetruecolor</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imagedestroy</function> and + <function>imagecreatetruecolor</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefromgd.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefromgd.xml diff -u phpdoc/en/reference/image/functions/imagecreatefromgd.xml:1.4 phpdoc/en/reference/image/functions/imagecreatefromgd.xml:1.5 --- phpdoc/en/reference/image/functions/imagecreatefromgd.xml:1.4 Thu Sep 26 13:56:54 2002 +++ phpdoc/en/reference/image/functions/imagecreatefromgd.xml Sat Jan 13 17:11:45 2007 @@ -1,24 +1,23 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.67 --> - <refentry id='function.imagecreatefromgd'> - <refnamediv> - <refname>imagecreatefromgd</refname> - <refpurpose>Create a new image from GD file or URL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgd</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id='function.imagecreatefromgd'> + <refnamediv> + <refname>imagecreatefromgd</refname> + <refpurpose>Create a new image from GD file or URL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgd</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + &warn.undocumented.func; + </para> + &tip.fopen-wrapper; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefromgd2.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefromgd2.xml diff -u phpdoc/en/reference/image/functions/imagecreatefromgd2.xml:1.5 phpdoc/en/reference/image/functions/imagecreatefromgd2.xml:1.6 --- phpdoc/en/reference/image/functions/imagecreatefromgd2.xml:1.5 Mon Feb 21 21:11:08 2005 +++ phpdoc/en/reference/image/functions/imagecreatefromgd2.xml Sat Jan 13 17:11:45 2007 @@ -1,25 +1,24 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.67 --> - <refentry id='function.imagecreatefromgd2'> - <refnamediv> - <refname>imagecreatefromgd2</refname> - <refpurpose>Create a new image from GD2 file or URL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgd2</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - &note.gd.2; - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id='function.imagecreatefromgd2'> + <refnamediv> + <refname>imagecreatefromgd2</refname> + <refpurpose>Create a new image from GD2 file or URL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgd2</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + &warn.undocumented.func; + </para> + &note.gd.2; + &tip.fopen-wrapper; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefromgd2part.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefromgd2part.xml diff -u phpdoc/en/reference/image/functions/imagecreatefromgd2part.xml:1.5 phpdoc/en/reference/image/functions/imagecreatefromgd2part.xml:1.6 --- phpdoc/en/reference/image/functions/imagecreatefromgd2part.xml:1.5 Mon Feb 21 21:11:08 2005 +++ phpdoc/en/reference/image/functions/imagecreatefromgd2part.xml Sat Jan 13 17:11:45 2007 @@ -1,29 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.67 --> - <refentry id='function.imagecreatefromgd2part'> - <refnamediv> - <refname>imagecreatefromgd2part</refname> - <refpurpose>Create a new image from a given part of GD2 file or URL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgd2part</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>srcX</parameter></methodparam> - <methodparam><type>int</type><parameter>srcY</parameter></methodparam> - <methodparam><type>int</type><parameter>width</parameter></methodparam> - <methodparam><type>int</type><parameter>height</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - &note.gd.2; - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id='function.imagecreatefromgd2part'> + <refnamediv> + <refname>imagecreatefromgd2part</refname> + <refpurpose>Create a new image from a given part of GD2 file or URL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgd2part</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>int</type><parameter>srcX</parameter></methodparam> + <methodparam><type>int</type><parameter>srcY</parameter></methodparam> + <methodparam><type>int</type><parameter>width</parameter></methodparam> + <methodparam><type>int</type><parameter>height</parameter></methodparam> + </methodsynopsis> + <para> + &warn.undocumented.func; + </para> + &note.gd.2; + &tip.fopen-wrapper; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefromgif.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefromgif.xml diff -u phpdoc/en/reference/image/functions/imagecreatefromgif.xml:1.13 phpdoc/en/reference/image/functions/imagecreatefromgif.xml:1.14 --- phpdoc/en/reference/image/functions/imagecreatefromgif.xml:1.13 Wed Aug 10 18:09:49 2005 +++ phpdoc/en/reference/image/functions/imagecreatefromgif.xml Sat Jan 13 17:11:45 2007 @@ -1,32 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagecreatefromgif"> - <refnamediv> - <refname>imagecreatefromgif</refname> - <refpurpose>Create a new image from file or URL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgif</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreatefromgif</function> returns an image identifier - representing the image obtained from the given filename. - </para> - <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</title> - <programlisting role="php"> +<!-- $Revision: 1.14 $ --> +<refentry id="function.imagecreatefromgif"> + <refnamediv> + <refname>imagecreatefromgif</refname> + <refpurpose>Create a new image from file or URL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgif</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreatefromgif</function> returns an image identifier + representing the image obtained from the given filename. + </para> + <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</title> + <programlisting role="php"> <![CDATA[ <?php -function LoadGif ($imgname) +function LoadGif ($imgname) { $im = @imagecreatefromgif ($imgname); /* Attempt to open */ if (!$im) { /* See if it failed */ @@ -41,20 +40,20 @@ } ?> ]]> - </programlisting> - </example> - <note> - <para> - GIF support was removed from the GD library in Version 1.6, - and added back in Version 2.0.28. This function is not - available between these versions. - </para> - </note> + </programlisting> + </example> + <note> + <para> + GIF support was removed from the GD library in Version 1.6, + and added back in Version 2.0.28. This function is not + available between these versions. </para> - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + </note> + </para> + &tip.fopen-wrapper; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml diff -u phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml:1.13 phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml:1.14 --- phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml:1.13 Tue Sep 20 19:19:38 2005 +++ phpdoc/en/reference/image/functions/imagecreatefromjpeg.xml Sat Jan 13 17:11:45 2007 @@ -1,32 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.4 --> - <refentry id="function.imagecreatefromjpeg"> - <refnamediv> - <refname>imagecreatefromjpeg</refname> - <refpurpose>Create a new image from file or URL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromjpeg</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreatefromjpeg</function> returns an image identifier - representing the image obtained from the given filename. - </para> - <para> - <function>imagecreatefromjpeg</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 <acronym>JPEG</acronym>: - <example> - <title>Example to handle an error during creation</title> - <programlisting role="php"> +<!-- $Revision: 1.14 $ --> +<refentry id="function.imagecreatefromjpeg"> + <refnamediv> + <refname>imagecreatefromjpeg</refname> + <refpurpose>Create a new image from file or URL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromjpeg</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreatefromjpeg</function> returns an image identifier + representing the image obtained from the given filename. + </para> + <para> + <function>imagecreatefromjpeg</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 <acronym>JPEG</acronym>: + <example> + <title>Example to handle an error during creation</title> + <programlisting role="php"> <![CDATA[ <?php -function LoadJpeg($imgname) +function LoadJpeg($imgname) { $im = @imagecreatefromjpeg($imgname); /* Attempt to open */ if (!$im) { /* See if it failed */ @@ -41,14 +40,14 @@ } ?> ]]> - </programlisting> - </example> - </para> - &note.config.jpeg; - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.config.jpeg; + &tip.fopen-wrapper; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefrompng.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefrompng.xml diff -u phpdoc/en/reference/image/functions/imagecreatefrompng.xml:1.10 phpdoc/en/reference/image/functions/imagecreatefrompng.xml:1.11 --- phpdoc/en/reference/image/functions/imagecreatefrompng.xml:1.10 Wed Aug 10 18:09:50 2005 +++ phpdoc/en/reference/image/functions/imagecreatefrompng.xml Sat Jan 13 17:11:45 2007 @@ -1,32 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.4 --> - <refentry id="function.imagecreatefrompng"> - <refnamediv> - <refname>imagecreatefrompng</refname> - <refpurpose>Create a new image from file or URL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatefrompng</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreatefrompng</function> returns an image identifier - representing the image obtained from the given filename. - </para> - <para> - <function>imagecreatefrompng</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 <acronym>PNG</acronym>: - <example> - <title>Example to handle an error during creation</title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<refentry id="function.imagecreatefrompng"> + <refnamediv> + <refname>imagecreatefrompng</refname> + <refpurpose>Create a new image from file or URL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatefrompng</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreatefrompng</function> returns an image identifier + representing the image obtained from the given filename. + </para> + <para> + <function>imagecreatefrompng</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 <acronym>PNG</acronym>: + <example> + <title>Example to handle an error during creation</title> + <programlisting role="php"> <![CDATA[ <?php -function LoadPNG($imgname) +function LoadPNG($imgname) { $im = @imagecreatefrompng($imgname); /* Attempt to open */ if (!$im) { /* See if it failed */ @@ -41,13 +40,13 @@ } ?> ]]> - </programlisting> - </example> - </para> - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &tip.fopen-wrapper; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefromstring.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefromstring.xml diff -u phpdoc/en/reference/image/functions/imagecreatefromstring.xml:1.8 phpdoc/en/reference/image/functions/imagecreatefromstring.xml:1.9 --- phpdoc/en/reference/image/functions/imagecreatefromstring.xml:1.8 Fri Sep 8 11:17:38 2006 +++ phpdoc/en/reference/image/functions/imagecreatefromstring.xml Sat Jan 13 17:11:45 2007 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.31 --> +<!-- $Revision: 1.9 $ --> <refentry id="function.imagecreatefromstring"> <refnamediv> <refname>imagecreatefromstring</refname> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml diff -u phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml:1.11 phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml:1.12 --- phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml:1.11 Wed Aug 10 18:09:50 2005 +++ phpdoc/en/reference/image/functions/imagecreatefromwbmp.xml Sat Jan 13 17:11:45 2007 @@ -1,32 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.30 --> - <refentry id="function.imagecreatefromwbmp"> - <refnamediv> - <refname>imagecreatefromwbmp</refname> - <refpurpose>Create a new image from file or URL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromwbmp</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreatefromwbmp</function> returns an image identifier - representing the image obtained from the given filename. - </para> - <para> - <function>imagecreatefromwbmp</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 <acronym>WBMP</acronym>: - <example> - <title>Example to handle an error during creation</title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<refentry id="function.imagecreatefromwbmp"> + <refnamediv> + <refname>imagecreatefromwbmp</refname> + <refpurpose>Create a new image from file or URL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromwbmp</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreatefromwbmp</function> returns an image identifier + representing the image obtained from the given filename. + </para> + <para> + <function>imagecreatefromwbmp</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 <acronym>WBMP</acronym>: + <example> + <title>Example to handle an error during creation</title> + <programlisting role="php"> <![CDATA[ <?php -function LoadWBMP($imgname) +function LoadWBMP($imgname) { $im = @imagecreatefromwbmp($imgname); /* Attempt to open */ if (!$im) { /* See if it failed */ @@ -41,14 +40,14 @@ } ?> ]]> - </programlisting> - </example> - </para> - &note.config.wbmp; - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.config.wbmp; + &tip.fopen-wrapper; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefromxbm.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefromxbm.xml diff -u phpdoc/en/reference/image/functions/imagecreatefromxbm.xml:1.4 phpdoc/en/reference/image/functions/imagecreatefromxbm.xml:1.5 --- phpdoc/en/reference/image/functions/imagecreatefromxbm.xml:1.4 Thu Sep 26 13:56:54 2002 +++ phpdoc/en/reference/image/functions/imagecreatefromxbm.xml Sat Jan 13 17:11:45 2007 @@ -1,25 +1,24 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.61 --> - <refentry id="function.imagecreatefromxbm"> - <refnamediv> - <refname>imagecreatefromxbm</refname> - <refpurpose>Create a new image from file or URL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromxbm</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreatefromxbm</function> returns an image identifier - representing the image obtained from the given filename. - </para> - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagecreatefromxbm"> + <refnamediv> + <refname>imagecreatefromxbm</refname> + <refpurpose>Create a new image from file or URL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromxbm</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreatefromxbm</function> returns an image identifier + representing the image obtained from the given filename. + </para> + &tip.fopen-wrapper; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatefromxpm.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatefromxpm.xml diff -u phpdoc/en/reference/image/functions/imagecreatefromxpm.xml:1.6 phpdoc/en/reference/image/functions/imagecreatefromxpm.xml:1.7 --- phpdoc/en/reference/image/functions/imagecreatefromxpm.xml:1.6 Mon Apr 12 22:58:32 2004 +++ phpdoc/en/reference/image/functions/imagecreatefromxpm.xml Sat Jan 13 17:11:45 2007 @@ -1,26 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.61 --> - <refentry id="function.imagecreatefromxpm"> - <refnamediv> - <refname>imagecreatefromxpm</refname> - <refpurpose>Create a new image from file or URL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromxpm</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreatefromxpm</function> returns an image identifier - representing the image obtained from the given filename. - </para> - &note.bundled.gd; - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.imagecreatefromxpm"> + <refnamediv> + <refname>imagecreatefromxpm</refname> + <refpurpose>Create a new image from file or URL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromxpm</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreatefromxpm</function> returns an image identifier + representing the image obtained from the given filename. + </para> + &note.bundled.gd; + &tip.fopen-wrapper; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagecreatetruecolor.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/image/functions/imagecreatetruecolor.xml diff -u phpdoc/en/reference/image/functions/imagecreatetruecolor.xml:1.10 phpdoc/en/reference/image/functions/imagecreatetruecolor.xml:1.11 --- phpdoc/en/reference/image/functions/imagecreatetruecolor.xml:1.10 Thu Dec 8 12:10:53 2005 +++ phpdoc/en/reference/image/functions/imagecreatetruecolor.xml Sat Jan 13 17:11:45 2007 @@ -1,37 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagecreatetruecolor"> - <refnamediv> - <refname>imagecreatetruecolor</refname> - <refpurpose>Create a new true color image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagecreatetruecolor</methodname> - <methodparam><type>int</type><parameter>x_size</parameter></methodparam> - <methodparam><type>int</type><parameter>y_size</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreatetruecolor</function> returns an image identifier - representing a black image of size <parameter>x_size</parameter> - by <parameter>y_size</parameter>. - </para> - <para> - Depending on your PHP and GD versions this function is defined or not. With - PHP 4.0.6 through 4.1.x this function always exists if the GD module is - loaded, but calling it without GD2 being installed PHP will issue a fatal - error and exit. With PHP 4.2.x this behaviour is different in issuing a - warning instead of an error. Other versions only define this function, if - the correct GD version is installed. - </para> - <para> - <example> - <title> - Creating a new GD image stream and outputting an image. - </title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<refentry id="function.imagecreatetruecolor"> + <refnamediv> + <refname>imagecreatetruecolor</refname> + <refpurpose>Create a new true color image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagecreatetruecolor</methodname> + <methodparam><type>int</type><parameter>x_size</parameter></methodparam> + <methodparam><type>int</type><parameter>y_size</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreatetruecolor</function> returns an image identifier + representing a black image of size <parameter>x_size</parameter> + by <parameter>y_size</parameter>. + </para> + <para> + Depending on your PHP and GD versions this function is defined or not. With + PHP 4.0.6 through 4.1.x this function always exists if the GD module is + loaded, but calling it without GD2 being installed PHP will issue a fatal + error and exit. With PHP 4.2.x this behaviour is different in issuing a + warning instead of an error. Other versions only define this function, if + the correct GD version is installed. + </para> + <para> + <example> + <title> + Creating a new GD image stream and outputting an image. + </title> + <programlisting role="php"> <![CDATA[ <?php header ("Content-type: image/png"); @@ -41,23 +40,23 @@ imagestring($im, 1, 5, 5, "A Simple Text String", $text_color); imagepng($im); imagedestroy($im); -?> -]]> - </programlisting> - </example> - </para> - &note.gd.2; - <note> - <para> - This function will not work with GIF file formats. - </para> - </note> +?> +]]> + </programlisting> + </example> + </para> + &note.gd.2; + <note> <para> - See also <function>imagedestroy</function> and - <function>imagecreate</function>. + This function will not work with GIF file formats. </para> - </refsect1> - </refentry> + </note> + <para> + See also <function>imagedestroy</function> and + <function>imagecreate</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagedashedline.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagedashedline.xml diff -u phpdoc/en/reference/image/functions/imagedashedline.xml:1.5 phpdoc/en/reference/image/functions/imagedashedline.xml:1.6 --- phpdoc/en/reference/image/functions/imagedashedline.xml:1.5 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagedashedline.xml Sat Jan 13 17:11:45 2007 @@ -1,29 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagedashedline"> - <refnamediv> - <refname>imagedashedline</refname> - <refpurpose>Draw a dashed line</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagedashedline</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>x1</parameter></methodparam> - <methodparam><type>int</type><parameter>y1</parameter></methodparam> - <methodparam><type>int</type><parameter>x2</parameter></methodparam> - <methodparam><type>int</type><parameter>y2</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - This function is deprecated. Use combination of - <function>imagesetstyle</function> and <function>imageline</function> - instead. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagedashedline"> + <refnamediv> + <refname>imagedashedline</refname> + <refpurpose>Draw a dashed line</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagedashedline</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>x1</parameter></methodparam> + <methodparam><type>int</type><parameter>y1</parameter></methodparam> + <methodparam><type>int</type><parameter>x2</parameter></methodparam> + <methodparam><type>int</type><parameter>y2</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + This function is deprecated. Use combination of + <function>imagesetstyle</function> and <function>imageline</function> + instead. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagedestroy.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagedestroy.xml diff -u phpdoc/en/reference/image/functions/imagedestroy.xml:1.5 phpdoc/en/reference/image/functions/imagedestroy.xml:1.6 --- phpdoc/en/reference/image/functions/imagedestroy.xml:1.5 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagedestroy.xml Sat Jan 13 17:11:45 2007 @@ -1,25 +1,24 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagedestroy"> - <refnamediv> - <refname>imagedestroy</refname> - <refpurpose>Destroy an image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagedestroy</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagedestroy</function> frees any memory associated - with image <parameter>image</parameter>. <parameter>image</parameter> - is the image identifier returned by one of the image create functions, - such as <function>imagecreatetruecolor</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagedestroy"> + <refnamediv> + <refname>imagedestroy</refname> + <refpurpose>Destroy an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagedestroy</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagedestroy</function> frees any memory associated + with image <parameter>image</parameter>. <parameter>image</parameter> + is the image identifier returned by one of the image create functions, + such as <function>imagecreatetruecolor</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imageellipse.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/image/functions/imageellipse.xml diff -u phpdoc/en/reference/image/functions/imageellipse.xml:1.9 phpdoc/en/reference/image/functions/imageellipse.xml:1.10 --- phpdoc/en/reference/image/functions/imageellipse.xml:1.9 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imageellipse.xml Sat Jan 13 17:11:45 2007 @@ -1,38 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imageellipse"> - <refnamediv> - <refname>imageellipse</refname> - <refpurpose>Draw an ellipse</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imageellipse</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>cx</parameter></methodparam> - <methodparam><type>int</type><parameter>cy</parameter></methodparam> - <methodparam><type>int</type><parameter>w</parameter></methodparam> - <methodparam><type>int</type><parameter>h</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imageellipse</function> draws an ellipse centered at - <parameter>cx</parameter>, <parameter>cy</parameter> (top left is - 0, 0) in the image represented by <parameter>image</parameter>. - <parameter>W</parameter> and <parameter>h</parameter> specifies the - ellipse's width and height respectively. The color of the ellipse is - specified by <parameter>color</parameter>. - </para> - <note><para> - This function was added in PHP 4.0.6 and requires GD 2.0.2 or later - which can be obtained at <ulink url="&url.gd;">&url.gd;</ulink> - </para></note> - <para> - <example> - <title><function>imageellipse</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.imageellipse"> + <refnamediv> + <refname>imageellipse</refname> + <refpurpose>Draw an ellipse</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imageellipse</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>cx</parameter></methodparam> + <methodparam><type>int</type><parameter>cy</parameter></methodparam> + <methodparam><type>int</type><parameter>w</parameter></methodparam> + <methodparam><type>int</type><parameter>h</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imageellipse</function> draws an ellipse centered at + <parameter>cx</parameter>, <parameter>cy</parameter> (top left is + 0, 0) in the image represented by <parameter>image</parameter>. + <parameter>W</parameter> and <parameter>h</parameter> specifies the + ellipse's width and height respectively. The color of the ellipse is + specified by <parameter>color</parameter>. + </para> + <note><para> + This function was added in PHP 4.0.6 and requires GD 2.0.2 or later + which can be obtained at <ulink url="&url.gd;">&url.gd;</ulink> + </para></note> + <para> + <example> + <title><function>imageellipse</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -54,15 +53,15 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imagefilledellipse</function> and - <function>imagearc</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imagefilledellipse</function> and + <function>imagearc</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefill.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imagefill.xml diff -u phpdoc/en/reference/image/functions/imagefill.xml:1.7 phpdoc/en/reference/image/functions/imagefill.xml:1.8 --- phpdoc/en/reference/image/functions/imagefill.xml:1.7 Sat Feb 18 20:14:48 2006 +++ phpdoc/en/reference/image/functions/imagefill.xml Sat Jan 13 17:11:45 2007 @@ -1,30 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagefill"> - <refnamediv> - <refname>imagefill</refname> - <refpurpose>Flood fill</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagefill</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagefill</function> performs a flood fill starting at - coordinate <parameter>x</parameter>, <parameter>y</parameter> - (top left is 0, 0) with color <parameter>color</parameter> in the - image <parameter>image</parameter>. - </para> - <para> - <example> - <title><function>imagefill</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.imagefill"> + <refnamediv> + <refname>imagefill</refname> + <refpurpose>Flood fill</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagefill</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagefill</function> performs a flood fill starting at + coordinate <parameter>x</parameter>, <parameter>y</parameter> + (top left is 0, 0) with color <parameter>color</parameter> in the + image <parameter>image</parameter>. + </para> + <para> + <example> + <title><function>imagefill</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -34,19 +33,19 @@ $red = imagecolorallocate($im, 255, 0, 0); imagefill($im, 0, 0, $red); -header('Content-type: image/png'); +header('Content-type: image/png'); imagepng($im); imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imagecolorallocate</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imagecolorallocate</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefilledarc.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/image/functions/imagefilledarc.xml diff -u phpdoc/en/reference/image/functions/imagefilledarc.xml:1.9 phpdoc/en/reference/image/functions/imagefilledarc.xml:1.10 --- phpdoc/en/reference/image/functions/imagefilledarc.xml:1.9 Wed Aug 10 18:09:50 2005 +++ phpdoc/en/reference/image/functions/imagefilledarc.xml Sat Jan 13 17:11:45 2007 @@ -1,56 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagefilledarc"> - <refnamediv> - <refname>imagefilledarc</refname> - <refpurpose>Draw a partial ellipse and fill it</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagefilledarc</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>cx</parameter></methodparam> - <methodparam><type>int</type><parameter>cy</parameter></methodparam> - <methodparam><type>int</type><parameter>w</parameter></methodparam> - <methodparam><type>int</type><parameter>h</parameter></methodparam> - <methodparam><type>int</type><parameter>s</parameter></methodparam> - <methodparam><type>int</type><parameter>e</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - <methodparam><type>int</type><parameter>style</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagefilledarc</function> draws a partial ellipse centered at - <parameter>cx</parameter>, <parameter>cy</parameter> (top left is - 0, 0) in the image represented by <parameter>image</parameter>. - &return.success; - <parameter>W</parameter> - and <parameter>h</parameter> specifies the ellipse's width and - height respectively while the start and end points are specified - in degrees indicated by the <parameter>s</parameter> and - <parameter>e</parameter> arguments. - <parameter>style</parameter> is a bitwise OR of the following possibilities: - <orderedlist> - <listitem><simpara><constant>IMG_ARC_PIE</constant></simpara></listitem> - <listitem><simpara><constant>IMG_ARC_CHORD</constant></simpara></listitem> - <listitem><simpara><constant>IMG_ARC_NOFILL</constant></simpara></listitem> - <listitem><simpara><constant>IMG_ARC_EDGED</constant></simpara></listitem> - </orderedlist> - <constant>IMG_ARC_PIE</constant> and <constant>IMG_ARC_CHORD</constant> are - mutually exclusive; <constant>IMG_ARC_CHORD</constant> just - connects the starting and ending angles with a straight line, while - <constant>IMG_ARC_PIE</constant> produces a rounded edge. - <constant>IMG_ARC_NOFILL</constant> indicates that the arc - or chord should be outlined, not filled. <constant>IMG_ARC_EDGED</constant>, - used together with <constant>IMG_ARC_NOFILL</constant>, indicates that the - beginning and ending angles should be connected to the center - this is a - good way to outline (rather than fill) a 'pie slice'. - </para> - <para> - <example> - <title>Creating a 3D looking pie</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.imagefilledarc"> + <refnamediv> + <refname>imagefilledarc</refname> + <refpurpose>Draw a partial ellipse and fill it</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagefilledarc</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>cx</parameter></methodparam> + <methodparam><type>int</type><parameter>cy</parameter></methodparam> + <methodparam><type>int</type><parameter>w</parameter></methodparam> + <methodparam><type>int</type><parameter>h</parameter></methodparam> + <methodparam><type>int</type><parameter>s</parameter></methodparam> + <methodparam><type>int</type><parameter>e</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + <methodparam><type>int</type><parameter>style</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagefilledarc</function> draws a partial ellipse centered at + <parameter>cx</parameter>, <parameter>cy</parameter> (top left is + 0, 0) in the image represented by <parameter>image</parameter>. + &return.success; + <parameter>W</parameter> + and <parameter>h</parameter> specifies the ellipse's width and + height respectively while the start and end points are specified + in degrees indicated by the <parameter>s</parameter> and + <parameter>e</parameter> arguments. + <parameter>style</parameter> is a bitwise OR of the following possibilities: + <orderedlist> + <listitem><simpara><constant>IMG_ARC_PIE</constant></simpara></listitem> + <listitem><simpara><constant>IMG_ARC_CHORD</constant></simpara></listitem> + <listitem><simpara><constant>IMG_ARC_NOFILL</constant></simpara></listitem> + <listitem><simpara><constant>IMG_ARC_EDGED</constant></simpara></listitem> + </orderedlist> + <constant>IMG_ARC_PIE</constant> and <constant>IMG_ARC_CHORD</constant> are + mutually exclusive; <constant>IMG_ARC_CHORD</constant> just + connects the starting and ending angles with a straight line, while + <constant>IMG_ARC_PIE</constant> produces a rounded edge. + <constant>IMG_ARC_NOFILL</constant> indicates that the arc + or chord should be outlined, not filled. <constant>IMG_ARC_EDGED</constant>, + used together with <constant>IMG_ARC_NOFILL</constant>, indicates that the + beginning and ending angles should be connected to the center - this is a + good way to outline (rather than fill) a 'pie slice'. + </para> + <para> + <example> + <title>Creating a 3D looking pie</title> + <programlisting role="php"> <![CDATA[ <?php @@ -69,8 +68,8 @@ // 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, $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); @@ -84,12 +83,12 @@ imagedestroy($image); ?> ]]> - </programlisting> - </example> - </para> - &note.gd.2; - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.gd.2; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefilledellipse.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/image/functions/imagefilledellipse.xml diff -u phpdoc/en/reference/image/functions/imagefilledellipse.xml:1.12 phpdoc/en/reference/image/functions/imagefilledellipse.xml:1.13 --- phpdoc/en/reference/image/functions/imagefilledellipse.xml:1.12 Tue Sep 6 20:18:34 2005 +++ phpdoc/en/reference/image/functions/imagefilledellipse.xml Sat Jan 13 17:11:45 2007 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> +<!-- $Revision: 1.13 $ --> <refentry id="function.imagefilledellipse"> <refnamediv> <refname>imagefilledellipse</refname> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefilledpolygon.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/image/functions/imagefilledpolygon.xml diff -u phpdoc/en/reference/image/functions/imagefilledpolygon.xml:1.9 phpdoc/en/reference/image/functions/imagefilledpolygon.xml:1.10 --- phpdoc/en/reference/image/functions/imagefilledpolygon.xml:1.9 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagefilledpolygon.xml Sat Jan 13 17:11:45 2007 @@ -1,37 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagefilledpolygon"> - <refnamediv> - <refname>imagefilledpolygon</refname> - <refpurpose>Draw a filled polygon</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagefilledpolygon</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>array</type><parameter>points</parameter></methodparam> - <methodparam><type>int</type><parameter>num_points</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagefilledpolygon</function> creates a filled polygon - in image <parameter>image</parameter>. - </para> - <para> - <parameter>points</parameter> is an array containing the - <literal>x</literal> and <literal>y</literal> co-ordinates - of the polygons vertices consecutively. - </para> - <para> - The parameter <parameter>num_points</parameter> is the total - number of vertices, which must be larger than 3. - </para> - <para> - <example> - <title><function>imagefilledpolygon</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.imagefilledpolygon"> + <refnamediv> + <refname>imagefilledpolygon</refname> + <refpurpose>Draw a filled polygon</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagefilledpolygon</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>array</type><parameter>points</parameter></methodparam> + <methodparam><type>int</type><parameter>num_points</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagefilledpolygon</function> creates a filled polygon + in image <parameter>image</parameter>. + </para> + <para> + <parameter>points</parameter> is an array containing the + <literal>x</literal> and <literal>y</literal> co-ordinates + of the polygons vertices consecutively. + </para> + <para> + The parameter <parameter>num_points</parameter> is the total + number of vertices, which must be larger than 3. + </para> + <para> + <example> + <title><function>imagefilledpolygon</function> example</title> + <programlisting role="php"> <![CDATA[ <?php // set up array of points for polygon @@ -60,11 +59,11 @@ imagedestroy($image); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefilledrectangle.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagefilledrectangle.xml diff -u phpdoc/en/reference/image/functions/imagefilledrectangle.xml:1.5 phpdoc/en/reference/image/functions/imagefilledrectangle.xml:1.6 --- phpdoc/en/reference/image/functions/imagefilledrectangle.xml:1.5 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagefilledrectangle.xml Sat Jan 13 17:11:45 2007 @@ -1,33 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagefilledrectangle"> - <refnamediv> - <refname>imagefilledrectangle</refname> - <refpurpose>Draw a filled rectangle</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagefilledrectangle</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>x1</parameter></methodparam> - <methodparam><type>int</type><parameter>y1</parameter></methodparam> - <methodparam><type>int</type><parameter>x2</parameter></methodparam> - <methodparam><type>int</type><parameter>y2</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagefilledrectangle</function> creates a filled - rectangle of color <parameter>color</parameter> in image - <parameter>image</parameter> starting at upper left coordinates - <parameter>x1</parameter>, <parameter>y1</parameter> and ending - at bottom right coordinates <parameter>x2</parameter>, - <parameter>y2</parameter>. 0, 0 is the top left corner of the - image. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagefilledrectangle"> + <refnamediv> + <refname>imagefilledrectangle</refname> + <refpurpose>Draw a filled rectangle</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagefilledrectangle</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>x1</parameter></methodparam> + <methodparam><type>int</type><parameter>y1</parameter></methodparam> + <methodparam><type>int</type><parameter>x2</parameter></methodparam> + <methodparam><type>int</type><parameter>y2</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagefilledrectangle</function> creates a filled + rectangle of color <parameter>color</parameter> in image + <parameter>image</parameter> starting at upper left coordinates + <parameter>x1</parameter>, <parameter>y1</parameter> and ending + at bottom right coordinates <parameter>x2</parameter>, + <parameter>y2</parameter>. 0, 0 is the top left corner of the + image. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefilltoborder.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagefilltoborder.xml diff -u phpdoc/en/reference/image/functions/imagefilltoborder.xml:1.5 phpdoc/en/reference/image/functions/imagefilltoborder.xml:1.6 --- phpdoc/en/reference/image/functions/imagefilltoborder.xml:1.5 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagefilltoborder.xml Sat Jan 13 17:11:45 2007 @@ -1,30 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagefilltoborder"> - <refnamediv> - <refname>imagefilltoborder</refname> - <refpurpose>Flood fill to specific color</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagefilltoborder</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam><type>int</type><parameter>border</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagefilltoborder</function> performs a flood fill - whose border color is defined by <parameter>border</parameter>. - The starting point for the fill is <parameter>x</parameter>, - <parameter>y</parameter> (top left is 0, 0) and the region is - filled with color <parameter>color</parameter>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagefilltoborder"> + <refnamediv> + <refname>imagefilltoborder</refname> + <refpurpose>Flood fill to specific color</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagefilltoborder</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam><type>int</type><parameter>border</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagefilltoborder</function> performs a flood fill + whose border color is defined by <parameter>border</parameter>. + The starting point for the fill is <parameter>x</parameter>, + <parameter>y</parameter> (top left is 0, 0) and the region is + filled with color <parameter>color</parameter>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefilter.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagefilter.xml diff -u phpdoc/en/reference/image/functions/imagefilter.xml:1.4 phpdoc/en/reference/image/functions/imagefilter.xml:1.5 --- phpdoc/en/reference/image/functions/imagefilter.xml:1.4 Wed Aug 18 14:15:17 2004 +++ phpdoc/en/reference/image/functions/imagefilter.xml Sat Jan 13 17:11:45 2007 @@ -1,111 +1,109 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.imagefilter"> - <refnamediv> - <refname>imagefilter</refname> - <refpurpose> - Applies a filter to an image - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagefilter</methodname> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>filtertype</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>arg1</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>arg2</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>arg3</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagefilter</function> applies the filter - <parameter>filtertype</parameter> to the image, using - <parameter>arg1</parameter>, <parameter>arg2</parameter> and - <parameter>arg3</parameter> where necessary. - </para> - <para> - <parameter>filtertype</parameter> can be one of the following: - <itemizedlist> - <listitem> - <simpara> - <parameter>IMG_FILTER_NEGATE</parameter>: Reverses all colors of - the image. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_GRAYSCALE</parameter>: Converts the image into - grayscale. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_BRIGHTNESS</parameter>: Changes the brightness - of the image. Use <parameter>arg1</parameter> to set the level of - brightness. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_CONTRAST</parameter>: Changes the contrast of - the image. Use <parameter>arg1</parameter> to set the level of - contrast. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_COLORIZE</parameter>: Like - <parameter>IMG_FILTER_GRAYSCALE</parameter>, except you can specify the - color. Use <parameter>arg1</parameter>, <parameter>arg2</parameter> and - <parameter>arg3</parameter> in the form of - <parameter>red</parameter>, <parameter>blue</parameter>, - <parameter>green</parameter>. The range for each color is 0 to 255. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_EDGEDETECT</parameter>: Uses edge detection to - highlight the edges in the image. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_EMBOSS</parameter>: Embosses the image. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_GAUSSIAN_BLUR</parameter>: Blurs the image using - the Gaussian method. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_SELECTIVE_BLUR</parameter>: Blurs the image. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_MEAN_REMOVAL</parameter>: Uses mean removal to - achieve a "sketchy" effect. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>IMG_FILTER_SMOOTH</parameter>: Makes the image smoother. - Use <parameter>arg1</parameter> to set the level of smoothness. - </simpara> - </listitem> - </itemizedlist> - </para> - &note.bundled.gd; - <para> - &return.success; - </para> - <para> - <example> - <title><function>imagefilter</function> grayscale example</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagefilter"> + <refnamediv> + <refname>imagefilter</refname> + <refpurpose>Applies a filter to an image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagefilter</methodname> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>filtertype</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>arg1</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>arg2</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>arg3</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagefilter</function> applies the filter + <parameter>filtertype</parameter> to the image, using + <parameter>arg1</parameter>, <parameter>arg2</parameter> and + <parameter>arg3</parameter> where necessary. + </para> + <para> + <parameter>filtertype</parameter> can be one of the following: + <itemizedlist> + <listitem> + <simpara> + <parameter>IMG_FILTER_NEGATE</parameter>: Reverses all colors of + the image. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_GRAYSCALE</parameter>: Converts the image into + grayscale. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_BRIGHTNESS</parameter>: Changes the brightness + of the image. Use <parameter>arg1</parameter> to set the level of + brightness. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_CONTRAST</parameter>: Changes the contrast of + the image. Use <parameter>arg1</parameter> to set the level of + contrast. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_COLORIZE</parameter>: Like + <parameter>IMG_FILTER_GRAYSCALE</parameter>, except you can specify the + color. Use <parameter>arg1</parameter>, <parameter>arg2</parameter> and + <parameter>arg3</parameter> in the form of + <parameter>red</parameter>, <parameter>blue</parameter>, + <parameter>green</parameter>. The range for each color is 0 to 255. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_EDGEDETECT</parameter>: Uses edge detection to + highlight the edges in the image. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_EMBOSS</parameter>: Embosses the image. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_GAUSSIAN_BLUR</parameter>: Blurs the image using + the Gaussian method. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_SELECTIVE_BLUR</parameter>: Blurs the image. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_MEAN_REMOVAL</parameter>: Uses mean removal to + achieve a "sketchy" effect. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>IMG_FILTER_SMOOTH</parameter>: Makes the image smoother. + Use <parameter>arg1</parameter> to set the level of smoothness. + </simpara> + </listitem> + </itemizedlist> + </para> + &note.bundled.gd; + <para> + &return.success; + </para> + <para> + <example> + <title><function>imagefilter</function> grayscale example</title> + <programlisting role="php"> <![CDATA[ <?php $im = imagecreatefrompng('dave.png'); @@ -119,13 +117,13 @@ imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - <example> - <title><function>imagefilter</function> brightness example</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>imagefilter</function> brightness example</title> + <programlisting role="php"> <![CDATA[ <?php $im = imagecreatefrompng('sean.png'); @@ -139,13 +137,13 @@ imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - <example> - <title><function>imagefilter</function> colorize example</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>imagefilter</function> colorize example</title> + <programlisting role="php"> <![CDATA[ <?php $im = imagecreatefrompng('philip.png'); @@ -161,11 +159,11 @@ imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefontheight.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc/en/reference/image/functions/imagefontheight.xml diff -u phpdoc/en/reference/image/functions/imagefontheight.xml:1.2 phpdoc/en/reference/image/functions/imagefontheight.xml:1.3 --- phpdoc/en/reference/image/functions/imagefontheight.xml:1.2 Wed Apr 17 06:39:12 2002 +++ phpdoc/en/reference/image/functions/imagefontheight.xml Sat Jan 13 17:11:45 2007 @@ -1,26 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagefontheight"> - <refnamediv> - <refname>imagefontheight</refname> - <refpurpose>Get font height</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagefontheight</methodname> - <methodparam><type>int</type><parameter>font</parameter></methodparam> - </methodsynopsis> - <para> - Returns the pixel height of a character in the specified font. - </para> - <para> - See also <function>imagefontwidth</function> and - <function>imageloadfont</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.imagefontheight"> + <refnamediv> + <refname>imagefontheight</refname> + <refpurpose>Get font height</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagefontheight</methodname> + <methodparam><type>int</type><parameter>font</parameter></methodparam> + </methodsynopsis> + <para> + Returns the pixel height of a character in the specified font. + </para> + <para> + See also <function>imagefontwidth</function> and + <function>imageloadfont</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefontwidth.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc/en/reference/image/functions/imagefontwidth.xml diff -u phpdoc/en/reference/image/functions/imagefontwidth.xml:1.2 phpdoc/en/reference/image/functions/imagefontwidth.xml:1.3 --- phpdoc/en/reference/image/functions/imagefontwidth.xml:1.2 Wed Apr 17 06:39:12 2002 +++ phpdoc/en/reference/image/functions/imagefontwidth.xml Sat Jan 13 17:11:45 2007 @@ -1,26 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagefontwidth"> - <refnamediv> - <refname>imagefontwidth</refname> - <refpurpose>Get font width</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagefontwidth</methodname> - <methodparam><type>int</type><parameter>font</parameter></methodparam> - </methodsynopsis> - <para> - Returns the pixel width of a character in font. - </para> - <para> - See also <function>imagefontheight</function> and - <function>imageloadfont</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.imagefontwidth"> + <refnamediv> + <refname>imagefontwidth</refname> + <refpurpose>Get font width</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagefontwidth</methodname> + <methodparam><type>int</type><parameter>font</parameter></methodparam> + </methodsynopsis> + <para> + Returns the pixel width of a character in font. + </para> + <para> + See also <function>imagefontheight</function> and + <function>imageloadfont</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imageftbbox.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imageftbbox.xml diff -u phpdoc/en/reference/image/functions/imageftbbox.xml:1.6 phpdoc/en/reference/image/functions/imageftbbox.xml:1.7 --- phpdoc/en/reference/image/functions/imageftbbox.xml:1.6 Thu Oct 5 16:18:12 2006 +++ phpdoc/en/reference/image/functions/imageftbbox.xml Sat Jan 13 17:11:45 2007 @@ -1,33 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.67 --> - <refentry id='function.imageftbbox'> - <refnamediv> - <refname>imageftbbox</refname> - <refpurpose>Give the bounding box of a text using fonts via freetype2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imageftbbox</methodname> - <methodparam><type>float</type><parameter>size</parameter></methodparam> - <methodparam><type>float</type><parameter>angle</parameter></methodparam> - <methodparam><type>string</type><parameter>font_file</parameter></methodparam> - <methodparam><type>string</type><parameter>text</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>extrainfo</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - &note.gd.2; - &note.freetype; - </para> - <note> - <para> - Parameter <parameter>extrainfo</parameter> is optional since PHP 4.3.5. - </para> - </note> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id='function.imageftbbox'> + <refnamediv> + <refname>imageftbbox</refname> + <refpurpose>Give the bounding box of a text using fonts via freetype2</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>imageftbbox</methodname> + <methodparam><type>float</type><parameter>size</parameter></methodparam> + <methodparam><type>float</type><parameter>angle</parameter></methodparam> + <methodparam><type>string</type><parameter>font_file</parameter></methodparam> + <methodparam><type>string</type><parameter>text</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>extrainfo</parameter></methodparam> + </methodsynopsis> + <para> + &warn.undocumented.func; + &note.gd.2; + &note.freetype; + </para> + <note> + <para> + Parameter <parameter>extrainfo</parameter> is optional since PHP 4.3.5. + </para> + </note> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagefttext.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imagefttext.xml diff -u phpdoc/en/reference/image/functions/imagefttext.xml:1.7 phpdoc/en/reference/image/functions/imagefttext.xml:1.8 --- phpdoc/en/reference/image/functions/imagefttext.xml:1.7 Thu Oct 5 16:18:12 2006 +++ phpdoc/en/reference/image/functions/imagefttext.xml Sat Jan 13 17:11:45 2007 @@ -1,37 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.67 --> - <refentry id='function.imagefttext'> - <refnamediv> - <refname>imagefttext</refname> - <refpurpose>Write text to the image using fonts using FreeType 2</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imagefttext</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>float</type><parameter>size</parameter></methodparam> - <methodparam><type>float</type><parameter>angle</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam><type>int</type><parameter>col</parameter></methodparam> - <methodparam><type>string</type><parameter>font_file</parameter></methodparam> - <methodparam><type>string</type><parameter>text</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>extrainfo</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - &note.gd.2; - &note.freetype; - </para> - <note> - <para> - Parameter <parameter>extrainfo</parameter> is optional since PHP 4.3.5. - </para> - </note> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<refentry id='function.imagefttext'> + <refnamediv> + <refname>imagefttext</refname> + <refpurpose>Write text to the image using fonts using FreeType 2</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>imagefttext</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>float</type><parameter>size</parameter></methodparam> + <methodparam><type>float</type><parameter>angle</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam><type>int</type><parameter>col</parameter></methodparam> + <methodparam><type>string</type><parameter>font_file</parameter></methodparam> + <methodparam><type>string</type><parameter>text</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>extrainfo</parameter></methodparam> + </methodsynopsis> + <para> + &warn.undocumented.func; + &note.gd.2; + &note.freetype; + </para> + <note> + <para> + Parameter <parameter>extrainfo</parameter> is optional since PHP 4.3.5. + </para> + </note> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagegammacorrect.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagegammacorrect.xml diff -u phpdoc/en/reference/image/functions/imagegammacorrect.xml:1.4 phpdoc/en/reference/image/functions/imagegammacorrect.xml:1.5 --- phpdoc/en/reference/image/functions/imagegammacorrect.xml:1.4 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagegammacorrect.xml Sat Jan 13 17:11:45 2007 @@ -1,28 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagegammacorrect"> - <refnamediv> - <refname>imagegammacorrect</refname> - <refpurpose>Apply a gamma correction to a GD image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagegammacorrect</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>float</type><parameter>inputgamma</parameter></methodparam> - <methodparam><type>float</type><parameter>outputgamma</parameter></methodparam> - </methodsynopsis> - <para> - The <function>imagegammacorrect</function> function applies gamma - correction to a gd image stream (<parameter>image</parameter>) given - an input gamma, the parameter <parameter>inputgamma</parameter> - and an output gamma, the parameter - <parameter>outputgamma</parameter>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagegammacorrect"> + <refnamediv> + <refname>imagegammacorrect</refname> + <refpurpose>Apply a gamma correction to a GD image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagegammacorrect</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>float</type><parameter>inputgamma</parameter></methodparam> + <methodparam><type>float</type><parameter>outputgamma</parameter></methodparam> + </methodsynopsis> + <para> + The <function>imagegammacorrect</function> function applies gamma + correction to a gd image stream (<parameter>image</parameter>) given + an input gamma, the parameter <parameter>inputgamma</parameter> + and an output gamma, the parameter + <parameter>outputgamma</parameter>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagegd.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imagegd.xml diff -u phpdoc/en/reference/image/functions/imagegd.xml:1.6 phpdoc/en/reference/image/functions/imagegd.xml:1.7 --- phpdoc/en/reference/image/functions/imagegd.xml:1.6 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagegd.xml Sat Jan 13 17:11:45 2007 @@ -1,39 +1,38 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.67 --> - <refentry id='function.imagegd'> - <refnamediv> - <refname>imagegd</refname> - <refpurpose>Output GD image to browser or file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagegd</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagegd</function> outputs a GD image to - <parameter>filename</parameter>. The <parameter>image</parameter> - argument is the return from the <function>imagecreatetruecolor</function> - function. - </para> - <para> - The <parameter>filename</parameter> parameter is optional, and if left - off, the raw image stream will be output directly. - </para> - <note> - <para> - The GD format is commonly used to allow fast loading of parts of images. - Note that the GD format is only usable in GD-compatible applications. - </para> - </note> - <para> - See also <function>imagegd2</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id='function.imagegd'> + <refnamediv> + <refname>imagegd</refname> + <refpurpose>Output GD image to browser or file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagegd</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagegd</function> outputs a GD image to + <parameter>filename</parameter>. The <parameter>image</parameter> + argument is the return from the <function>imagecreatetruecolor</function> + function. + </para> + <para> + The <parameter>filename</parameter> parameter is optional, and if left + off, the raw image stream will be output directly. + </para> + <note> + <para> + The GD format is commonly used to allow fast loading of parts of images. + Note that the GD format is only usable in GD-compatible applications. + </para> + </note> + <para> + See also <function>imagegd2</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagegd2.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/reference/image/functions/imagegd2.xml diff -u phpdoc/en/reference/image/functions/imagegd2.xml:1.13 phpdoc/en/reference/image/functions/imagegd2.xml:1.14 --- phpdoc/en/reference/image/functions/imagegd2.xml:1.13 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagegd2.xml Sat Jan 13 17:11:45 2007 @@ -1,54 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.67 --> - <refentry id='function.imagegd2'> - <refnamediv> - <refname>imagegd2</refname> - <refpurpose>Output GD2 image to browser or file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagegd2</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>chunk_size</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagegd2</function> outputs a GD2 image to - <parameter>filename</parameter>. - The <parameter>image</parameter> parameter is the return from the - <function>imagecreatetruecolor</function> function. - </para> - <para> - The <parameter>filename</parameter> parameter is optional, and if left - off, the raw image stream will be output directly. - </para> - <para> - The optional <parameter>type</parameter> parameter is either - <constant>IMG_GD2_RAW</constant> or <constant>IMG_GD2_COMPRESSED</constant>. - Default is <constant>IMG_GD2_RAW</constant>. - </para> - <note> - <para> - The optional <parameter>chunk_size</parameter> and - <parameter>type</parameter> parameters became available - in PHP 4.3.2. - </para> - </note> - <note> - <para> - The GD2 format is commonly used to allow fast loading of parts of images. - Note that the GD2 format is only usable in GD2-compatible applications. - </para> - </note> - &note.gd.2; - <para> - See also <function>imagegd</function> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.14 $ --> +<refentry id='function.imagegd2'> + <refnamediv> + <refname>imagegd2</refname> + <refpurpose>Output GD2 image to browser or file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagegd2</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>chunk_size</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagegd2</function> outputs a GD2 image to + <parameter>filename</parameter>. + The <parameter>image</parameter> parameter is the return from the + <function>imagecreatetruecolor</function> function. + </para> + <para> + The <parameter>filename</parameter> parameter is optional, and if left + off, the raw image stream will be output directly. + </para> + <para> + The optional <parameter>type</parameter> parameter is either + <constant>IMG_GD2_RAW</constant> or <constant>IMG_GD2_COMPRESSED</constant>. + Default is <constant>IMG_GD2_RAW</constant>. + </para> + <note> + <para> + The optional <parameter>chunk_size</parameter> and + <parameter>type</parameter> parameters became available + in PHP 4.3.2. + </para> + </note> + <note> + <para> + The GD2 format is commonly used to allow fast loading of parts of images. + Note that the GD2 format is only usable in GD2-compatible applications. + </para> + </note> + &note.gd.2; + <para> + See also <function>imagegd</function> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagegif.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/image/functions/imagegif.xml diff -u phpdoc/en/reference/image/functions/imagegif.xml:1.12 phpdoc/en/reference/image/functions/imagegif.xml:1.13 --- phpdoc/en/reference/image/functions/imagegif.xml:1.12 Fri Aug 25 17:33:25 2006 +++ phpdoc/en/reference/image/functions/imagegif.xml Sat Jan 13 17:11:45 2007 @@ -1,55 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.3 --> - <refentry id="function.imagegif"> - <refnamediv> - <refname>imagegif</refname> - <refpurpose>Output image to browser or file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagegif</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.13 $ --> +<refentry id="function.imagegif"> + <refnamediv> + <refname>imagegif</refname> + <refpurpose>Output image to browser or file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagegif</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagegif</function> creates the <acronym>GIF</acronym> + file in filename from the image <parameter>image</parameter>. The + <parameter>image</parameter> argument is the return from the + <function>imagecreate</function> or <literal>imagecreatefrom*</literal> + function. + </para> + <para> + The image format will be <acronym>GIF87a</acronym> unless the + image has been made transparent with + <function>imagecolortransparent</function>, in which case the + image format will be <acronym>GIF89a</acronym>. + </para> + <para> + The filename argument is optional, and if left off or filled + with a &null; value, 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 <acronym>GIF</acronym> + images directly. + <note> <para> - <function>imagegif</function> creates the <acronym>GIF</acronym> - file in filename from the image <parameter>image</parameter>. The - <parameter>image</parameter> argument is the return from the - <function>imagecreate</function> or <literal>imagecreatefrom*</literal> - function. + Since all <acronym>GIF</acronym> support was removed from the + <acronym>GD</acronym> library in version 1.6, this function is + not available if you are using that version of the GD library. + Support is expected to return in a version subsequent to the + rerelease of <acronym>GIF</acronym> support in the GD library in + mid 2004. For more information, see the + <ulink url="&url.gd;">GD Project</ulink> site. </para> <para> - The image format will be <acronym>GIF87a</acronym> unless the - image has been made transparent with - <function>imagecolortransparent</function>, in which case the - image format will be <acronym>GIF89a</acronym>. - </para> - <para> - The filename argument is optional, and if left off or filled - with a &null; value, 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 <acronym>GIF</acronym> - images directly. - <note> - <para> - Since all <acronym>GIF</acronym> support was removed from the - <acronym>GD</acronym> library in version 1.6, this function is - not available if you are using that version of the GD library. - Support is expected to return in a version subsequent to the - rerelease of <acronym>GIF</acronym> support in the GD library in - mid 2004. For more information, see the - <ulink url="&url.gd;">GD Project</ulink> site. - </para> - <para> - The following code snippet allows you to write more - portable PHP applications by auto-detecting the - type of GD support which is available. Replace - the sequence <literal>header ("Content-type: image/gif"); - imagegif ($im);</literal> by the more flexible sequence: - <informalexample> - <programlisting role="php"> + The following code snippet allows you to write more + portable PHP applications by auto-detecting the + type of GD support which is available. Replace + the sequence <literal>header ("Content-type: image/gif"); + imagegif ($im);</literal> by the more flexible sequence: + <informalexample> + <programlisting role="php"> <![CDATA[ <?php if (function_exists("imagegif")) { @@ -69,18 +68,18 @@ } ?> ]]> - </programlisting> - </informalexample> - </para> - </note> - <note> - <para> - As of version 3.0.18 and 4.0.2 you can use the function - <function>imagetypes</function> in place of - <function>function_exists</function> for checking - the presence of the various supported image formats: - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + </note> + <note> + <para> + As of version 3.0.18 and 4.0.2 you can use the function + <function>imagetypes</function> in place of + <function>function_exists</function> for checking + the presence of the various supported image formats: + <informalexample> + <programlisting role="php"> <![CDATA[ <?php if (imagetypes() & IMG_GIF) { @@ -91,17 +90,17 @@ } ?> ]]> - </programlisting> - </informalexample> - </para> - </note> - </para> - <para> - See also <function>imagepng</function>, <function>imagewbmp</function>, - <function>imagejpeg</function> and <function>imagetypes</function>. + </programlisting> + </informalexample> </para> - </refsect1> - </refentry> + </note> + </para> + <para> + See also <function>imagepng</function>, <function>imagewbmp</function>, + <function>imagejpeg</function> and <function>imagetypes</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imageinterlace.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/image/functions/imageinterlace.xml diff -u phpdoc/en/reference/image/functions/imageinterlace.xml:1.3 phpdoc/en/reference/image/functions/imageinterlace.xml:1.4 --- phpdoc/en/reference/image/functions/imageinterlace.xml:1.3 Thu Apr 18 17:13:09 2002 +++ phpdoc/en/reference/image/functions/imageinterlace.xml Sat Jan 13 17:11:45 2007 @@ -1,33 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imageinterlace"> - <refnamediv> - <refname>imageinterlace</refname> - <refpurpose>Enable or disable interlace</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imageinterlace</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>interlace</parameter></methodparam> - </methodsynopsis> - <para> - <function>imageinterlace</function> turns the interlace bit on or off. - If interlace is 1 the image will be interlaced, and if interlace - is 0 the interlace bit is turned off. - </para> - <para> - If the interlace bit is set and the image is used as a JPEG image, - the image is created as a progressive JPEG. - </para> - <para> - This function returns whether the interlace bit is set for the - image. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.imageinterlace"> + <refnamediv> + <refname>imageinterlace</refname> + <refpurpose>Enable or disable interlace</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imageinterlace</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>interlace</parameter></methodparam> + </methodsynopsis> + <para> + <function>imageinterlace</function> turns the interlace bit on or off. + If interlace is 1 the image will be interlaced, and if interlace + is 0 the interlace bit is turned off. + </para> + <para> + If the interlace bit is set and the image is used as a JPEG image, + the image is created as a progressive JPEG. + </para> + <para> + This function returns whether the interlace bit is set for the + image. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imageistruecolor.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imageistruecolor.xml diff -u phpdoc/en/reference/image/functions/imageistruecolor.xml:1.4 phpdoc/en/reference/image/functions/imageistruecolor.xml:1.5 --- phpdoc/en/reference/image/functions/imageistruecolor.xml:1.4 Tue Jul 27 04:48:54 2004 +++ phpdoc/en/reference/image/functions/imageistruecolor.xml Sat Jan 13 17:11:45 2007 @@ -1,27 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imageistruecolor"> - <refnamediv> - <refname>imageistruecolor</refname> - <refpurpose>Finds whether an image is a truecolor image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imageistruecolor</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - </methodsynopsis> - <para> - <function>imageistruecolor</function> finds whether the image - <parameter>image</parameter> is a truecolor image. - </para> - &note.gd.2; - <para> - See also <function>imagecreatetruecolor</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imageistruecolor"> + <refnamediv> + <refname>imageistruecolor</refname> + <refpurpose>Finds whether an image is a truecolor image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imageistruecolor</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + </methodsynopsis> + <para> + <function>imageistruecolor</function> finds whether the image + <parameter>image</parameter> is a truecolor image. + </para> + &note.gd.2; + <para> + See also <function>imagecreatetruecolor</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagejpeg.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imagejpeg.xml diff -u phpdoc/en/reference/image/functions/imagejpeg.xml:1.7 phpdoc/en/reference/image/functions/imagejpeg.xml:1.8 --- phpdoc/en/reference/image/functions/imagejpeg.xml:1.7 Wed Aug 23 10:48:40 2006 +++ phpdoc/en/reference/image/functions/imagejpeg.xml Sat Jan 13 17:11:45 2007 @@ -1,55 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.30 --> - <refentry id="function.imagejpeg"> - <refnamediv> - <refname>imagejpeg</refname> - <refpurpose>Output image to browser or file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagejpeg</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>quality</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagejpeg</function> creates the - <acronym>JPEG</acronym> file in filename from the image - <parameter>image</parameter>. The <parameter>image</parameter> argument - is the return from the <function>imagecreatetruecolor</function> function. - </para> - <para> - The filename argument is optional, and if left off, the raw image - stream will be output directly. To skip the filename argument in - order to provide a quality argument just use a &null; value. - By sending an image/jpeg content-type using - <function>header</function>, you can create a PHP script that - outputs JPEG images directly. - </para> - - &note.config.jpeg; - - <para> - <parameter>quality</parameter> is optional, and ranges from - 0 (worst quality, smaller file) to 100 (best quality, biggest file). - The default is the default IJG quality value (about 75). - </para> - <para> - If you want to output Progressive JPEGs, you need to set interlacing - on with <function>imageinterlace</function>. - </para> - <para> - See also - <function>imagepng</function>, - <function>imagegif</function>, - <function>imagewbmp</function>, - <function>imageinterlace</function> and - <function>imagetypes</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<refentry id="function.imagejpeg"> + <refnamediv> + <refname>imagejpeg</refname> + <refpurpose>Output image to browser or file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagejpeg</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>quality</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagejpeg</function> creates the + <acronym>JPEG</acronym> file in filename from the image + <parameter>image</parameter>. The <parameter>image</parameter> argument + is the return from the <function>imagecreatetruecolor</function> function. + </para> + <para> + The filename argument is optional, and if left off, the raw image + stream will be output directly. To skip the filename argument in + order to provide a quality argument just use a &null; value. + By sending an image/jpeg content-type using + <function>header</function>, you can create a PHP script that + outputs JPEG images directly. + </para> + + &note.config.jpeg; + + <para> + <parameter>quality</parameter> is optional, and ranges from + 0 (worst quality, smaller file) to 100 (best quality, biggest file). + The default is the default IJG quality value (about 75). + </para> + <para> + If you want to output Progressive JPEGs, you need to set interlacing + on with <function>imageinterlace</function>. + </para> + <para> + See also + <function>imagepng</function>, + <function>imagegif</function>, + <function>imagewbmp</function>, + <function>imageinterlace</function> and + <function>imagetypes</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagelayereffect.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagelayereffect.xml diff -u phpdoc/en/reference/image/functions/imagelayereffect.xml:1.4 phpdoc/en/reference/image/functions/imagelayereffect.xml:1.5 --- phpdoc/en/reference/image/functions/imagelayereffect.xml:1.4 Fri Jun 11 08:25:38 2004 +++ phpdoc/en/reference/image/functions/imagelayereffect.xml Sat Jan 13 17:11:45 2007 @@ -1,24 +1,22 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.imagelayereffect"> - <refnamediv> - <refname>imagelayereffect</refname> - <refpurpose> - Set the alpha blending flag to use the bundled libgd layering effects - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagelayereffect</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>effect</parameter></methodparam> - </methodsynopsis> - &warn.undocumented.func; - &note.bundled.gd; - &note.gd.2; - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagelayereffect"> + <refnamediv> + <refname>imagelayereffect</refname> + <refpurpose>Set the alpha blending flag to use the bundled libgd layering effects</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagelayereffect</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>effect</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + &note.bundled.gd; + &note.gd.2; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imageline.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/image/functions/imageline.xml diff -u phpdoc/en/reference/image/functions/imageline.xml:1.8 phpdoc/en/reference/image/functions/imageline.xml:1.9 --- phpdoc/en/reference/image/functions/imageline.xml:1.8 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imageline.xml Sat Jan 13 17:11:45 2007 @@ -1,35 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imageline"> - <refnamediv> - <refname>imageline</refname> - <refpurpose>Draw a line</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imageline</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>x1</parameter></methodparam> - <methodparam><type>int</type><parameter>y1</parameter></methodparam> - <methodparam><type>int</type><parameter>x2</parameter></methodparam> - <methodparam><type>int</type><parameter>y2</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imageline</function> draws a line from - <parameter>x1</parameter>, <parameter>y1</parameter> to - <parameter>x2</parameter>, <parameter>y2</parameter> (top left is - 0, 0) in image <parameter>image</parameter> of color <parameter>color</parameter>. - </para> - <example> - <title>Drawing a thick line</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.imageline"> + <refnamediv> + <refname>imageline</refname> + <refpurpose>Draw a line</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imageline</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>x1</parameter></methodparam> + <methodparam><type>int</type><parameter>y1</parameter></methodparam> + <methodparam><type>int</type><parameter>x2</parameter></methodparam> + <methodparam><type>int</type><parameter>y2</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imageline</function> draws a line from + <parameter>x1</parameter>, <parameter>y1</parameter> to + <parameter>x2</parameter>, <parameter>y2</parameter> (top left is + 0, 0) in image <parameter>image</parameter> of color <parameter>color</parameter>. + </para> + <example> + <title>Drawing a thick line</title> + <programlisting role="php"> <![CDATA[ <?php -function imagelinethick($image, $x1, $y1, $x2, $y2, $color, $thick = 1) +function imagelinethick($image, $x1, $y1, $x2, $y2, $color, $thick = 1) { /* this way it works well only for orthogonal lines imagesetthickness($image, $thick); @@ -49,21 +48,21 @@ round($x1 - (1-$k)*$a), round($y1 - (1+$k)*$a), round($x2 + (1+$k)*$a), round($y2 - (1-$k)*$a), round($x2 + (1-$k)*$a), round($y2 + (1+$k)*$a), - ); + ); imagefilledpolygon($image, $points, 4, $color); return imagepolygon($image, $points, 4, $color); } ?> ]]> - </programlisting> - </example> - <para> - See also <function>imagecreatetruecolor</function> and - <function>imagecolorallocate</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + <para> + See also <function>imagecreatetruecolor</function> and + <function>imagecolorallocate</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imageloadfont.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imageloadfont.xml diff -u phpdoc/en/reference/image/functions/imageloadfont.xml:1.5 phpdoc/en/reference/image/functions/imageloadfont.xml:1.6 --- phpdoc/en/reference/image/functions/imageloadfont.xml:1.5 Mon Jan 30 14:34:34 2006 +++ phpdoc/en/reference/image/functions/imageloadfont.xml Sat Jan 13 17:11:45 2007 @@ -1,78 +1,77 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imageloadfont"> - <refnamediv> - <refname>imageloadfont</refname> - <refpurpose>Load a new font</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imageloadfont</methodname> - <methodparam><type>string</type><parameter>file</parameter></methodparam> - </methodsynopsis> - <para> - <function>imageloadfont</function> loads a user-defined bitmap - font and returns an identifier for the font (that is always - greater than 5, so it will not conflict with the built-in fonts). - It returns &false; in case of error. - </para> - <para> - The font file format is currently binary and architecture - dependent. This means you should generate the font files on the - same type of CPU as the machine you are running PHP on. - </para> - <para> - <table> - <title>Font file format</title> - <tgroup cols="3"> - <thead> - <row> - <entry>byte position</entry> - <entry>C data type</entry> - <entry>description</entry> - </row> - </thead> - <tbody> - <row> - <entry>byte 0-3</entry> - <entry>int</entry> - <entry>number of characters in the font</entry> - </row> - <row> - <entry>byte 4-7</entry> - <entry>int</entry> - <entry> - value of first character in the font (often 32 for space) - </entry> - </row> - <row> - <entry>byte 8-11</entry> - <entry>int</entry> - <entry>pixel width of each character</entry> - </row> - <row> - <entry>byte 12-15</entry> - <entry>int</entry> - <entry>pixel height of each character</entry> - </row> - <row> - <entry>byte 16-</entry> - <entry>char</entry> - <entry> - array with character data, one byte per pixel in each - character, for a total of (nchars*width*height) bytes. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - <example> - <title>Using imageloadfont</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imageloadfont"> + <refnamediv> + <refname>imageloadfont</refname> + <refpurpose>Load a new font</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imageloadfont</methodname> + <methodparam><type>string</type><parameter>file</parameter></methodparam> + </methodsynopsis> + <para> + <function>imageloadfont</function> loads a user-defined bitmap + font and returns an identifier for the font (that is always + greater than 5, so it will not conflict with the built-in fonts). + It returns &false; in case of error. + </para> + <para> + The font file format is currently binary and architecture + dependent. This means you should generate the font files on the + same type of CPU as the machine you are running PHP on. + </para> + <para> + <table> + <title>Font file format</title> + <tgroup cols="3"> + <thead> + <row> + <entry>byte position</entry> + <entry>C data type</entry> + <entry>description</entry> + </row> + </thead> + <tbody> + <row> + <entry>byte 0-3</entry> + <entry>int</entry> + <entry>number of characters in the font</entry> + </row> + <row> + <entry>byte 4-7</entry> + <entry>int</entry> + <entry> + value of first character in the font (often 32 for space) + </entry> + </row> + <row> + <entry>byte 8-11</entry> + <entry>int</entry> + <entry>pixel width of each character</entry> + </row> + <row> + <entry>byte 12-15</entry> + <entry>int</entry> + <entry>pixel height of each character</entry> + </row> + <row> + <entry>byte 16-</entry> + <entry>char</entry> + <entry> + array with character data, one byte per pixel in each + character, for a total of (nchars*width*height) bytes. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + <example> + <title>Using imageloadfont</title> + <programlisting role="php"> <![CDATA[ <?php header("Content-type: image/png"); @@ -85,15 +84,15 @@ imagepng($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imagefontwidth</function> and - <function>imagefontheight</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imagefontwidth</function> and + <function>imagefontheight</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepalettecopy.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/image/functions/imagepalettecopy.xml diff -u phpdoc/en/reference/image/functions/imagepalettecopy.xml:1.3 phpdoc/en/reference/image/functions/imagepalettecopy.xml:1.4 --- phpdoc/en/reference/image/functions/imagepalettecopy.xml:1.3 Fri Jun 24 13:24:32 2005 +++ phpdoc/en/reference/image/functions/imagepalettecopy.xml Sat Jan 13 17:11:45 2007 @@ -1,25 +1,24 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.61 --> - <refentry id="function.imagepalettecopy"> - <refnamediv> - <refname>imagepalettecopy</refname> - <refpurpose>Copy the palette from one image to another</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>imagepalettecopy</methodname> - <methodparam><type>resource</type><parameter>destination</parameter></methodparam> - <methodparam><type>resource</type><parameter>source</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagepalettecopy</function> copies the - palette from the <parameter>source</parameter> image - to the <parameter>destination</parameter> image. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.imagepalettecopy"> + <refnamediv> + <refname>imagepalettecopy</refname> + <refpurpose>Copy the palette from one image to another</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>void</type><methodname>imagepalettecopy</methodname> + <methodparam><type>resource</type><parameter>destination</parameter></methodparam> + <methodparam><type>resource</type><parameter>source</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagepalettecopy</function> copies the + palette from the <parameter>source</parameter> image + to the <parameter>destination</parameter> image. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepng.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imagepng.xml diff -u phpdoc/en/reference/image/functions/imagepng.xml:1.6 phpdoc/en/reference/image/functions/imagepng.xml:1.7 --- phpdoc/en/reference/image/functions/imagepng.xml:1.6 Fri Aug 25 17:33:25 2006 +++ phpdoc/en/reference/image/functions/imagepng.xml Sat Jan 13 17:11:45 2007 @@ -1,45 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.7 --> - <refentry id="function.imagepng"> - <refnamediv> - <refname>imagepng</refname> - <refpurpose>Output a PNG image to either the browser or a file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagepng</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagepng</function> creates the <acronym>PNG</acronym> - file in filename from the image <parameter>image</parameter>. The - <parameter>image</parameter> argument is the return from the - <function>imagecreate</function> or <literal>imagecreatefrom*</literal> - function. - </para> - <para> - The filename argument is optional, and if left off or filled - with a &null; value, the raw image stream will be output directly. - <informalexample> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<refentry id="function.imagepng"> + <refnamediv> + <refname>imagepng</refname> + <refpurpose>Output a PNG image to either the browser or a file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagepng</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagepng</function> creates the <acronym>PNG</acronym> + file in filename from the image <parameter>image</parameter>. The + <parameter>image</parameter> argument is the return from the + <function>imagecreate</function> or <literal>imagecreatefrom*</literal> + function. + </para> + <para> + The filename argument is optional, and if left off or filled + with a &null; value, the raw image stream will be output directly. + <informalexample> + <programlisting role="php"> <![CDATA[ <?php $im = imagecreatefrompng("test.png"); imagepng($im); ?> ]]> - </programlisting> - </informalexample> - </para> - <para> - See also <function>imagegif</function>, <function>imagewbmp</function>, - <function>imagejpeg</function>, <function>imagetypes</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </informalexample> + </para> + <para> + See also <function>imagegif</function>, <function>imagewbmp</function>, + <function>imagejpeg</function>, <function>imagetypes</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepolygon.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/image/functions/imagepolygon.xml diff -u phpdoc/en/reference/image/functions/imagepolygon.xml:1.10 phpdoc/en/reference/image/functions/imagepolygon.xml:1.11 --- phpdoc/en/reference/image/functions/imagepolygon.xml:1.10 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagepolygon.xml Sat Jan 13 17:11:45 2007 @@ -1,31 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagepolygon"> - <refnamediv> - <refname>imagepolygon</refname> - <refpurpose>Draw a polygon</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagepolygon</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>array</type><parameter>points</parameter></methodparam> - <methodparam><type>int</type><parameter>num_points</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagepolygon</function> creates a polygon in image id. - <parameter>points</parameter> is a PHP array containing the - polygon's vertices, i.e. points[0] = x0, points[1] = y0, points[2] - = x1, points[3] = y1, etc. <parameter>num_points</parameter> is - the total number of points (vertices). - </para> - <para> - <example> - <title><function>imagepolygon</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<refentry id="function.imagepolygon"> + <refnamediv> + <refname>imagepolygon</refname> + <refpurpose>Draw a polygon</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagepolygon</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>array</type><parameter>points</parameter></methodparam> + <methodparam><type>int</type><parameter>num_points</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagepolygon</function> creates a polygon in image id. + <parameter>points</parameter> is a PHP array containing the + polygon's vertices, i.e. points[0] = x0, points[1] = y0, points[2] + = x1, points[3] = y1, etc. <parameter>num_points</parameter> is + the total number of points (vertices). + </para> + <para> + <example> + <title><function>imagepolygon</function> example</title> + <programlisting role="php"> <![CDATA[ <?php // create a blank image @@ -38,7 +37,7 @@ $col_poly = imagecolorallocate($image, 255, 255, 255); // draw the polygon -imagepolygon($image, +imagepolygon($image, array ( 0, 0, 100, 200, @@ -53,15 +52,15 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imagecreate</function> and - <function>imagecreatetruecolor</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imagecreate</function> and + <function>imagecreatetruecolor</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepsbbox.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imagepsbbox.xml diff -u phpdoc/en/reference/image/functions/imagepsbbox.xml:1.7 phpdoc/en/reference/image/functions/imagepsbbox.xml:1.8 --- phpdoc/en/reference/image/functions/imagepsbbox.xml:1.7 Fri Jan 5 11:11:16 2007 +++ phpdoc/en/reference/image/functions/imagepsbbox.xml Sat Jan 13 17:11:45 2007 @@ -1,91 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagepsbbox"> - <refnamediv> - <refname>imagepsbbox</refname> - <refpurpose> - Give the bounding box of a text rectangle using PostScript Type1 - fonts - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imagepsbbox</methodname> - <methodparam><type>string</type><parameter>text</parameter></methodparam> - <methodparam><type>int</type><parameter>font</parameter></methodparam> - <methodparam><type>int</type><parameter>size</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>space</parameter></methodparam> - <methodparam><type>int</type><parameter>tightness</parameter></methodparam> - <methodparam><type>float</type><parameter>angle</parameter></methodparam> - </methodsynopsis> - <para> - <parameter>size</parameter> is expressed in pixels. - </para> - <para> - <parameter>space</parameter> allows you to change the default - value of a space in a font. This amount is added to the normal - value and can also be negative. - </para> - <para> - <parameter>tightness</parameter> allows you to control the amount - of white space between characters. This amount is added to the - normal character width and can also be negative. - </para> - <para> - <parameter>angle</parameter> is in degrees. - </para> - <para> - Parameters <parameter>space</parameter> and - <parameter>tightness</parameter> are expressed in character space - units, where 1 unit is 1/1000th of an em-square. - </para> - <para> - Parameters <parameter>space</parameter>, - <parameter>tightness</parameter>, and <parameter>angle</parameter> - are optional. - </para> - <para> - The bounding box is calculated using information available from - character metrics, and unfortunately tends to differ slightly - from the results achieved by actually rasterizing the text. If - the angle is 0 degrees, you can expect the text to need 1 pixel - more to every direction. - </para> - - &note.config.t1lib; - - <para> - This function returns an array containing the following elements: - <informaltable> - <tgroup cols="2"> - <tbody> - <row> - <entry>0</entry> - <entry>left x-coordinate</entry> - </row> - <row> - <entry>1</entry> - <entry>upper y-coordinate</entry> - </row> - <row> - <entry>2</entry> - <entry>right x-coordinate</entry> - </row> - <row> - <entry>3</entry> - <entry>lower y-coordinate</entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - <para> - See also <function>imagepstext</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<refentry id="function.imagepsbbox"> + <refnamediv> + <refname>imagepsbbox</refname> + <refpurpose>Give the bounding box of a text rectangle using PostScript Type1 fonts</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>imagepsbbox</methodname> + <methodparam><type>string</type><parameter>text</parameter></methodparam> + <methodparam><type>int</type><parameter>font</parameter></methodparam> + <methodparam><type>int</type><parameter>size</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>space</parameter></methodparam> + <methodparam><type>int</type><parameter>tightness</parameter></methodparam> + <methodparam><type>float</type><parameter>angle</parameter></methodparam> + </methodsynopsis> + <para> + <parameter>size</parameter> is expressed in pixels. + </para> + <para> + <parameter>space</parameter> allows you to change the default + value of a space in a font. This amount is added to the normal + value and can also be negative. + </para> + <para> + <parameter>tightness</parameter> allows you to control the amount + of white space between characters. This amount is added to the + normal character width and can also be negative. + </para> + <para> + <parameter>angle</parameter> is in degrees. + </para> + <para> + Parameters <parameter>space</parameter> and + <parameter>tightness</parameter> are expressed in character space + units, where 1 unit is 1/1000th of an em-square. + </para> + <para> + Parameters <parameter>space</parameter>, + <parameter>tightness</parameter>, and <parameter>angle</parameter> + are optional. + </para> + <para> + The bounding box is calculated using information available from + character metrics, and unfortunately tends to differ slightly + from the results achieved by actually rasterizing the text. If + the angle is 0 degrees, you can expect the text to need 1 pixel + more to every direction. + </para> + + &note.config.t1lib; + + <para> + This function returns an array containing the following elements: + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry>left x-coordinate</entry> + </row> + <row> + <entry>1</entry> + <entry>upper y-coordinate</entry> + </row> + <row> + <entry>2</entry> + <entry>right x-coordinate</entry> + </row> + <row> + <entry>3</entry> + <entry>lower y-coordinate</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + See also <function>imagepstext</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepsencodefont.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/image/functions/imagepsencodefont.xml diff -u phpdoc/en/reference/image/functions/imagepsencodefont.xml:1.8 phpdoc/en/reference/image/functions/imagepsencodefont.xml:1.9 --- phpdoc/en/reference/image/functions/imagepsencodefont.xml:1.8 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagepsencodefont.xml Sat Jan 13 17:11:45 2007 @@ -1,39 +1,38 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagepsencodefont"> - <refnamediv> - <refname>imagepsencodefont</refname> - <refpurpose>Change the character encoding vector of a font</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagepsencodefont</methodname> - <methodparam><type>resource</type><parameter>font_index</parameter></methodparam> - <methodparam><type>string</type><parameter>encodingfile</parameter></methodparam> - </methodsynopsis> - <para> - Loads a character encoding vector from a file and changes - the fonts encoding vector to it. As a PostScript fonts default - vector lacks most of the character positions above 127, you'll - definitely want to change this if you use an other language than - English. The exact format of this file is described in T1libs - documentation. T1lib comes with two ready-to-use files, - IsoLatin1.enc and IsoLatin2.enc. - </para> - <para> - If you find yourself using this function all the time, a much - better way to define the encoding is to set ps.default_encoding in - the <link linkend="configuration.file">configuration file</link> - to point to the right encoding file and all fonts you load will - automatically have the right encoding. - </para> - - &note.config.t1lib; - - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<refentry id="function.imagepsencodefont"> + <refnamediv> + <refname>imagepsencodefont</refname> + <refpurpose>Change the character encoding vector of a font</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagepsencodefont</methodname> + <methodparam><type>resource</type><parameter>font_index</parameter></methodparam> + <methodparam><type>string</type><parameter>encodingfile</parameter></methodparam> + </methodsynopsis> + <para> + Loads a character encoding vector from a file and changes + the fonts encoding vector to it. As a PostScript fonts default + vector lacks most of the character positions above 127, you'll + definitely want to change this if you use an other language than + English. The exact format of this file is described in T1libs + documentation. T1lib comes with two ready-to-use files, + IsoLatin1.enc and IsoLatin2.enc. + </para> + <para> + If you find yourself using this function all the time, a much + better way to define the encoding is to set ps.default_encoding in + the <link linkend="configuration.file">configuration file</link> + to point to the right encoding file and all fonts you load will + automatically have the right encoding. + </para> + + &note.config.t1lib; + + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepsextendfont.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagepsextendfont.xml diff -u phpdoc/en/reference/image/functions/imagepsextendfont.xml:1.4 phpdoc/en/reference/image/functions/imagepsextendfont.xml:1.5 --- phpdoc/en/reference/image/functions/imagepsextendfont.xml:1.4 Fri Nov 7 18:14:40 2003 +++ phpdoc/en/reference/image/functions/imagepsextendfont.xml Sat Jan 13 17:11:45 2007 @@ -1,28 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.7 --> - <refentry id="function.imagepsextendfont"> - <refnamediv> - <refname>imagepsextendfont</refname> - <refpurpose>Extend or condense a font</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagepsextendfont</methodname> - <methodparam><type>int</type><parameter>font_index</parameter></methodparam> - <methodparam><type>float</type><parameter>extend</parameter></methodparam> - </methodsynopsis> - <para> - Extend or condense a font (<parameter>font_index</parameter>), if - the value of the <parameter>extend</parameter> parameter is less - than one you will be condensing the font. - </para> - - &note.config.t1lib; - - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagepsextendfont"> + <refnamediv> + <refname>imagepsextendfont</refname> + <refpurpose>Extend or condense a font</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagepsextendfont</methodname> + <methodparam><type>int</type><parameter>font_index</parameter></methodparam> + <methodparam><type>float</type><parameter>extend</parameter></methodparam> + </methodsynopsis> + <para> + Extend or condense a font (<parameter>font_index</parameter>), if + the value of the <parameter>extend</parameter> parameter is less + than one you will be condensing the font. + </para> + + &note.config.t1lib; + + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepsfreefont.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imagepsfreefont.xml diff -u phpdoc/en/reference/image/functions/imagepsfreefont.xml:1.7 phpdoc/en/reference/image/functions/imagepsfreefont.xml:1.8 --- phpdoc/en/reference/image/functions/imagepsfreefont.xml:1.7 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagepsfreefont.xml Sat Jan 13 17:11:45 2007 @@ -1,28 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagepsfreefont"> - <refnamediv> - <refname>imagepsfreefont</refname> - <refpurpose>Free memory used by a PostScript Type 1 font</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagepsfreefont</methodname> - <methodparam><type>resource</type><parameter>fontindex</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagepsfreefont</function> frees memory used by a PostScript Type 1 font. - </para> - - &note.config.t1lib; - - <para> - See also <function>imagepsloadfont</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<refentry id="function.imagepsfreefont"> + <refnamediv> + <refname>imagepsfreefont</refname> + <refpurpose>Free memory used by a PostScript Type 1 font</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagepsfreefont</methodname> + <methodparam><type>resource</type><parameter>fontindex</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagepsfreefont</function> frees memory used by a PostScript Type 1 font. + </para> + + &note.config.t1lib; + + <para> + See also <function>imagepsloadfont</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepsloadfont.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/image/functions/imagepsloadfont.xml diff -u phpdoc/en/reference/image/functions/imagepsloadfont.xml:1.9 phpdoc/en/reference/image/functions/imagepsloadfont.xml:1.10 --- phpdoc/en/reference/image/functions/imagepsloadfont.xml:1.9 Mon Jan 30 14:34:34 2006 +++ phpdoc/en/reference/image/functions/imagepsloadfont.xml Sat Jan 13 17:11:45 2007 @@ -1,27 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.7 --> - <refentry id="function.imagepsloadfont"> - <refnamediv> - <refname>imagepsloadfont</refname> - <refpurpose>Load a PostScript Type 1 font from file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagepsloadfont</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - In the case everything went right, a valid font index will be - returned and can be used for further purposes. Otherwise the - function returns &false; and prints a message describing what went - wrong, which you cannot read directly, while the output type is image. - </para> - <para> - <example> - <title><function>imagepsloadfont</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.imagepsloadfont"> + <refnamediv> + <refname>imagepsloadfont</refname> + <refpurpose>Load a PostScript Type 1 font from file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagepsloadfont</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + In the case everything went right, a valid font index will be + returned and can be used for further purposes. Otherwise the + function returns &false; and prints a message describing what went + wrong, which you cannot read directly, while the output type is image. + </para> + <para> + <example> + <title><function>imagepsloadfont</function> example</title> + <programlisting role="php"> <![CDATA[ <?php header("Content-type: image/png"); @@ -36,17 +35,17 @@ imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - - &note.config.t1lib; - - <para> - See also <function>imagepsfreefont</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + + &note.config.t1lib; + + <para> + See also <function>imagepsfreefont</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepsslantfont.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagepsslantfont.xml diff -u phpdoc/en/reference/image/functions/imagepsslantfont.xml:1.5 phpdoc/en/reference/image/functions/imagepsslantfont.xml:1.6 --- phpdoc/en/reference/image/functions/imagepsslantfont.xml:1.5 Tue Jun 21 23:26:37 2005 +++ phpdoc/en/reference/image/functions/imagepsslantfont.xml Sat Jan 13 17:11:45 2007 @@ -1,28 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagepsslantfont"> - <refnamediv> - <refname>imagepsslantfont</refname> - <refpurpose>Slant a font</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagepsslantfont</methodname> - <methodparam><type>resource</type><parameter>font_index</parameter></methodparam> - <methodparam><type>float</type><parameter>slant</parameter></methodparam> - </methodsynopsis> - <para> - Slant a font given by the <parameter>font_index</parameter> - parameter with a slant of the value of the - <parameter>slant</parameter> parameter. - </para> - - &note.config.t1lib; - - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagepsslantfont"> + <refnamediv> + <refname>imagepsslantfont</refname> + <refpurpose>Slant a font</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagepsslantfont</methodname> + <methodparam><type>resource</type><parameter>font_index</parameter></methodparam> + <methodparam><type>float</type><parameter>slant</parameter></methodparam> + </methodsynopsis> + <para> + Slant a font given by the <parameter>font_index</parameter> + parameter with a slant of the value of the + <parameter>slant</parameter> parameter. + </para> + + &note.config.t1lib; + + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepstext.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/image/functions/imagepstext.xml diff -u phpdoc/en/reference/image/functions/imagepstext.xml:1.11 phpdoc/en/reference/image/functions/imagepstext.xml:1.12 --- phpdoc/en/reference/image/functions/imagepstext.xml:1.11 Tue Jun 21 23:26:37 2005 +++ phpdoc/en/reference/image/functions/imagepstext.xml Sat Jan 13 17:11:45 2007 @@ -1,112 +1,111 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagepstext"> - <refnamediv> - <refname>imagepstext</refname> - <refpurpose>To draw a text string over an image using PostScript Type1 fonts</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imagepstext</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>string</type><parameter>text</parameter></methodparam> - <methodparam><type>resource</type><parameter>font</parameter></methodparam> - <methodparam><type>int</type><parameter>size</parameter></methodparam> - <methodparam><type>int</type><parameter>foreground</parameter></methodparam> - <methodparam><type>int</type><parameter>background</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>space</parameter></methodparam> - <methodparam><type>int</type><parameter>tightness</parameter></methodparam> - <methodparam><type>float</type><parameter>angle</parameter></methodparam> - <methodparam><type>int</type><parameter>antialias_steps</parameter></methodparam> - </methodsynopsis> - <para> - <parameter>foreground</parameter> is the color in which the text - will be painted. <parameter>Background</parameter> is the color - to which the text will try to fade in with antialiasing. No - pixels with the color <parameter>background</parameter> are - actually painted, so the background image does not need to be of - solid color. - </para> - <para> - The coordinates given by <parameter>x</parameter>, - <parameter>y</parameter> will define the origin (or reference - point) of the first character (roughly the lower-left corner of - the character). This is different from the - <function>imagestring</function>, where <parameter>x</parameter>, - <parameter>y</parameter> define the upper-right corner of the - first character. Refer to PostScript documentation about fonts and - their measuring system if you have trouble understanding how this - works. - </para> - <para> - <parameter>space</parameter> allows you to change the default - value of a space in a font. This amount is added to the normal - value and can also be negative. - </para> - <para> - <parameter>tightness</parameter> allows you to control the amount - of white space between characters. This amount is added to the - normal character width and can also be negative. - </para> - <para> - <parameter>angle</parameter> is in degrees. - </para> - <para> - <parameter>size</parameter> is expressed in pixels. - </para> - <para> - <parameter>antialias_steps</parameter> allows you to control the - number of colours used for antialiasing text. Allowed values are - 4 and 16. The higher value is recommended for text sizes lower - than 20, where the effect in text quality is quite visible. With - bigger sizes, use 4. It's less computationally intensive. - </para> - <para> - Parameters <parameter>space</parameter> and - <parameter>tightness</parameter> are expressed in character space - units, where 1 unit is 1/1000th of an em-square. - </para> - <para> - Parameters <parameter>space</parameter>, - <parameter>tightness</parameter>, <parameter>angle</parameter> - and <parameter>antialias_steps</parameter> are optional. - </para> - - &note.config.t1lib; - - <para> - This function returns an array containing the following elements: - <informaltable> - <tgroup cols="2"> - <tbody> - <row> - <entry>0</entry> - <entry>lower left x-coordinate</entry> - </row> - <row> - <entry>1</entry> - <entry>lower left y-coordinate</entry> - </row> - <row> - <entry>2</entry> - <entry>upper right x-coordinate</entry> - </row> - <row> - <entry>3</entry> - <entry>upper right y-coordinate</entry> - </row> - </tbody> - </tgroup> - </informaltable></para> - <para> - See also <function>imagepsbbox</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.12 $ --> +<refentry id="function.imagepstext"> + <refnamediv> + <refname>imagepstext</refname> + <refpurpose>To draw a text string over an image using PostScript Type1 fonts</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>imagepstext</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>string</type><parameter>text</parameter></methodparam> + <methodparam><type>resource</type><parameter>font</parameter></methodparam> + <methodparam><type>int</type><parameter>size</parameter></methodparam> + <methodparam><type>int</type><parameter>foreground</parameter></methodparam> + <methodparam><type>int</type><parameter>background</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>space</parameter></methodparam> + <methodparam><type>int</type><parameter>tightness</parameter></methodparam> + <methodparam><type>float</type><parameter>angle</parameter></methodparam> + <methodparam><type>int</type><parameter>antialias_steps</parameter></methodparam> + </methodsynopsis> + <para> + <parameter>foreground</parameter> is the color in which the text + will be painted. <parameter>Background</parameter> is the color + to which the text will try to fade in with antialiasing. No + pixels with the color <parameter>background</parameter> are + actually painted, so the background image does not need to be of + solid color. + </para> + <para> + The coordinates given by <parameter>x</parameter>, + <parameter>y</parameter> will define the origin (or reference + point) of the first character (roughly the lower-left corner of + the character). This is different from the + <function>imagestring</function>, where <parameter>x</parameter>, + <parameter>y</parameter> define the upper-right corner of the + first character. Refer to PostScript documentation about fonts and + their measuring system if you have trouble understanding how this + works. + </para> + <para> + <parameter>space</parameter> allows you to change the default + value of a space in a font. This amount is added to the normal + value and can also be negative. + </para> + <para> + <parameter>tightness</parameter> allows you to control the amount + of white space between characters. This amount is added to the + normal character width and can also be negative. + </para> + <para> + <parameter>angle</parameter> is in degrees. + </para> + <para> + <parameter>size</parameter> is expressed in pixels. + </para> + <para> + <parameter>antialias_steps</parameter> allows you to control the + number of colours used for antialiasing text. Allowed values are + 4 and 16. The higher value is recommended for text sizes lower + than 20, where the effect in text quality is quite visible. With + bigger sizes, use 4. It's less computationally intensive. + </para> + <para> + Parameters <parameter>space</parameter> and + <parameter>tightness</parameter> are expressed in character space + units, where 1 unit is 1/1000th of an em-square. + </para> + <para> + Parameters <parameter>space</parameter>, + <parameter>tightness</parameter>, <parameter>angle</parameter> + and <parameter>antialias_steps</parameter> are optional. + </para> + + &note.config.t1lib; + + <para> + This function returns an array containing the following elements: + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry>lower left x-coordinate</entry> + </row> + <row> + <entry>1</entry> + <entry>lower left y-coordinate</entry> + </row> + <row> + <entry>2</entry> + <entry>upper right x-coordinate</entry> + </row> + <row> + <entry>3</entry> + <entry>upper right y-coordinate</entry> + </row> + </tbody> + </tgroup> + </informaltable></para> + <para> + See also <function>imagepsbbox</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagerectangle.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagerectangle.xml diff -u phpdoc/en/reference/image/functions/imagerectangle.xml:1.4 phpdoc/en/reference/image/functions/imagerectangle.xml:1.5 --- phpdoc/en/reference/image/functions/imagerectangle.xml:1.4 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagerectangle.xml Sat Jan 13 17:11:45 2007 @@ -1,30 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagerectangle"> - <refnamediv> - <refname>imagerectangle</refname> - <refpurpose>Draw a rectangle</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagerectangle</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>x1</parameter></methodparam> - <methodparam><type>int</type><parameter>y1</parameter></methodparam> - <methodparam><type>int</type><parameter>x2</parameter></methodparam> - <methodparam><type>int</type><parameter>y2</parameter></methodparam> - <methodparam><type>int</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagerectangle</function> creates a rectangle of color - col in image <parameter>image</parameter> starting at upper left - coordinate x1, y1 and ending at bottom right coordinate x2, y2. - 0, 0 is the top left corner of the image. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagerectangle"> + <refnamediv> + <refname>imagerectangle</refname> + <refpurpose>Draw a rectangle</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagerectangle</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>x1</parameter></methodparam> + <methodparam><type>int</type><parameter>y1</parameter></methodparam> + <methodparam><type>int</type><parameter>x2</parameter></methodparam> + <methodparam><type>int</type><parameter>y2</parameter></methodparam> + <methodparam><type>int</type><parameter>col</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagerectangle</function> creates a rectangle of color + col in image <parameter>image</parameter> starting at upper left + coordinate x1, y1 and ending at bottom right coordinate x2, y2. + 0, 0 is the top left corner of the image. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagerotate.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imagerotate.xml diff -u phpdoc/en/reference/image/functions/imagerotate.xml:1.6 phpdoc/en/reference/image/functions/imagerotate.xml:1.7 --- phpdoc/en/reference/image/functions/imagerotate.xml:1.6 Mon Apr 4 16:19:42 2005 +++ phpdoc/en/reference/image/functions/imagerotate.xml Sat Jan 13 17:11:45 2007 @@ -1,41 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.imagerotate"> - <refnamediv> - <refname>imagerotate</refname> - <refpurpose>Rotate an image with a given angle</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>imagerotate</methodname> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>float</type><parameter>angle</parameter></methodparam> - <methodparam><type>int</type><parameter>bgd_color</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>ignore_transparent</parameter></methodparam> - </methodsynopsis> - <para> - Rotates the <parameter>src_im</parameter> image using a given - <parameter>angle</parameter> in degrees. <parameter>bgd_color</parameter> - specifies the color of the uncovered zone after the rotation. - </para> - <para> - The center of rotation is the center of the image, and the rotated - image is scaled down so that the whole rotated image fits in the - destination image - the edges are not clipped. - </para> - <para> - If <parameter>ignore_transparent</parameter> is set and non-zero, - transparent colors are ignored (otherwise kept). This parameter was added - in PHP 5.1. - </para> - <para> - <example> - <title>Rotate an image 180 degrees</title> - <para> - This example rotates an image 180 degrees - upside down. - </para> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<refentry id="function.imagerotate"> + <refnamediv> + <refname>imagerotate</refname> + <refpurpose>Rotate an image with a given angle</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>imagerotate</methodname> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>float</type><parameter>angle</parameter></methodparam> + <methodparam><type>int</type><parameter>bgd_color</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>ignore_transparent</parameter></methodparam> + </methodsynopsis> + <para> + Rotates the <parameter>src_im</parameter> image using a given + <parameter>angle</parameter> in degrees. <parameter>bgd_color</parameter> + specifies the color of the uncovered zone after the rotation. + </para> + <para> + The center of rotation is the center of the image, and the rotated + image is scaled down so that the whole rotated image fits in the + destination image - the edges are not clipped. + </para> + <para> + If <parameter>ignore_transparent</parameter> is set and non-zero, + transparent colors are ignored (otherwise kept). This parameter was added + in PHP 5.1. + </para> + <para> + <example> + <title>Rotate an image 180 degrees</title> + <para> + This example rotates an image 180 degrees - upside down. + </para> + <programlisting role="php"> <![CDATA[ // File and rotation $filename = 'test.jpg'; @@ -53,12 +53,12 @@ // Output imagejpeg($rotate); ]]> - </programlisting> - </example> - </para> - &note.bundled.gd; - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.bundled.gd; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagesavealpha.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/image/functions/imagesavealpha.xml diff -u phpdoc/en/reference/image/functions/imagesavealpha.xml:1.9 phpdoc/en/reference/image/functions/imagesavealpha.xml:1.10 --- phpdoc/en/reference/image/functions/imagesavealpha.xml:1.9 Fri Aug 20 09:36:58 2004 +++ phpdoc/en/reference/image/functions/imagesavealpha.xml Sat Jan 13 17:11:45 2007 @@ -1,41 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 --> - <refentry id="function.imagesavealpha"> - <refnamediv> - <refname>imagesavealpha</refname> - <refpurpose> - Set the flag to save full alpha channel information (as opposed to - single-color transparency) when saving PNG images - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagesavealpha</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>bool</type><parameter>saveflag</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagesavealpha</function> sets the flag to attempt to save - full alpha channel information (as opposed to single-color transparency) - when saving PNG images. - </para> - <para> - You have to unset alphablending - (<literal>imagealphablending($im, &false;)</literal>), to use it. - </para> - <para> - Alpha channel is not supported by all browsers, if you have problem with - your browser, try to load your script with an alpha channel compliant - browser, e.g. latest Mozilla. - </para> - &note.gd.2; - <para> - See also <function>imagealphablending</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.10 $ --> +<refentry id="function.imagesavealpha"> + <refnamediv> + <refname>imagesavealpha</refname> + <refpurpose>Set the flag to save full alpha channel information (as opposed to single-color transparency) when saving PNG images</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagesavealpha</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>bool</type><parameter>saveflag</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagesavealpha</function> sets the flag to attempt to save + full alpha channel information (as opposed to single-color transparency) + when saving PNG images. + </para> + <para> + You have to unset alphablending + (<literal>imagealphablending($im, &false;)</literal>), to use it. + </para> + <para> + Alpha channel is not supported by all browsers, if you have problem with + your browser, try to load your script with an alpha channel compliant + browser, e.g. latest Mozilla. + </para> + &note.gd.2; + <para> + See also <function>imagealphablending</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagesetbrush.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagesetbrush.xml diff -u phpdoc/en/reference/image/functions/imagesetbrush.xml:1.4 phpdoc/en/reference/image/functions/imagesetbrush.xml:1.5 --- phpdoc/en/reference/image/functions/imagesetbrush.xml:1.4 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagesetbrush.xml Sat Jan 13 17:11:45 2007 @@ -1,35 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.34 --> - <refentry id="function.imagesetbrush"> - <refnamediv> - <refname>imagesetbrush</refname> - <refpurpose>Set the brush image for line drawing</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagesetbrush</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>resource</type><parameter>brush</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagesetbrush</function> sets the brush image to be - used by all line drawing functions (such as <function>imageline</function> - and <function>imagepolygon</function>) when drawing with the special - colors <literal>IMG_COLOR_BRUSHED</literal> or <literal>IMG_COLOR_STYLEDBRUSHED</literal>. - </para> - <note> - <para> - You need not take special action when you are finished with a brush, but if you - destroy the brush image, you must not use the <literal>IMG_COLOR_BRUSHED</literal> or - <literal>IMG_COLOR_STYLEDBRUSHED</literal> - colors until you have set a new brush image! - </para> - </note> - <note><para>This function was added in PHP 4.0.6</para></note> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagesetbrush"> + <refnamediv> + <refname>imagesetbrush</refname> + <refpurpose>Set the brush image for line drawing</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagesetbrush</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>resource</type><parameter>brush</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagesetbrush</function> sets the brush image to be + used by all line drawing functions (such as <function>imageline</function> + and <function>imagepolygon</function>) when drawing with the special + colors <literal>IMG_COLOR_BRUSHED</literal> or <literal>IMG_COLOR_STYLEDBRUSHED</literal>. + </para> + <note> + <para> + You need not take special action when you are finished with a brush, but if you + destroy the brush image, you must not use the <literal>IMG_COLOR_BRUSHED</literal> or + <literal>IMG_COLOR_STYLEDBRUSHED</literal> + colors until you have set a new brush image! + </para> + </note> + <note><para>This function was added in PHP 4.0.6</para></note> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagesetpixel.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imagesetpixel.xml diff -u phpdoc/en/reference/image/functions/imagesetpixel.xml:1.6 phpdoc/en/reference/image/functions/imagesetpixel.xml:1.7 --- phpdoc/en/reference/image/functions/imagesetpixel.xml:1.6 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagesetpixel.xml Sat Jan 13 17:11:46 2007 @@ -1,32 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagesetpixel"> - <refnamediv> - <refname>imagesetpixel</refname> - <refpurpose>Set a single pixel</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagesetpixel</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagesetpixel</function> draws a pixel at - <parameter>x</parameter>, <parameter>y</parameter> (top left is - 0, 0) in image <parameter>image</parameter> of color - <parameter>color</parameter>. - </para> - <para> - See also <function>imagecreatetruecolor</function> and - <function>imagecolorallocate</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.imagesetpixel"> + <refnamediv> + <refname>imagesetpixel</refname> + <refpurpose>Set a single pixel</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagesetpixel</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagesetpixel</function> draws a pixel at + <parameter>x</parameter>, <parameter>y</parameter> (top left is + 0, 0) in image <parameter>image</parameter> of color + <parameter>color</parameter>. + </para> + <para> + See also <function>imagecreatetruecolor</function> and + <function>imagecolorallocate</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagesetstyle.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/image/functions/imagesetstyle.xml diff -u phpdoc/en/reference/image/functions/imagesetstyle.xml:1.8 phpdoc/en/reference/image/functions/imagesetstyle.xml:1.9 --- phpdoc/en/reference/image/functions/imagesetstyle.xml:1.8 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagesetstyle.xml Sat Jan 13 17:11:46 2007 @@ -1,32 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.43 --> - <refentry id="function.imagesetstyle"> - <refnamediv> - <refname>imagesetstyle</refname> - <refpurpose>Set the style for line drawing</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagesetstyle</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>array</type><parameter>style</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagesetstyle</function> sets the style to be used by all - line drawing functions (such as <function>imageline</function> - and <function>imagepolygon</function>) when drawing with the special - color <literal>IMG_COLOR_STYLED</literal> or lines of images with color - <literal>IMG_COLOR_STYLEDBRUSHED</literal>. &return.success; - </para> - <para> - The <parameter>style</parameter> parameter is an array of pixels. - Following example script draws a dashed line from upper left to - lower right corner of the canvas: - <example> - <title><function>imagesetstyle</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.imagesetstyle"> + <refnamediv> + <refname>imagesetstyle</refname> + <refpurpose>Set the style for line drawing</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagesetstyle</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>array</type><parameter>style</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagesetstyle</function> sets the style to be used by all + line drawing functions (such as <function>imageline</function> + and <function>imagepolygon</function>) when drawing with the special + color <literal>IMG_COLOR_STYLED</literal> or lines of images with color + <literal>IMG_COLOR_STYLEDBRUSHED</literal>. &return.success; + </para> + <para> + The <parameter>style</parameter> parameter is an array of pixels. + Following example script draws a dashed line from upper left to + lower right corner of the canvas: + <example> + <title><function>imagesetstyle</function> example</title> + <programlisting role="php"> <![CDATA[ <?php header("Content-type: image/jpeg"); @@ -53,15 +52,15 @@ imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imagesetbrush</function>, <function>imageline</function>. - </para> - <note><para>This function was added in PHP 4.0.6</para></note> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imagesetbrush</function>, <function>imageline</function>. + </para> + <note><para>This function was added in PHP 4.0.6</para></note> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagesetthickness.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagesetthickness.xml diff -u phpdoc/en/reference/image/functions/imagesetthickness.xml:1.5 phpdoc/en/reference/image/functions/imagesetthickness.xml:1.6 --- phpdoc/en/reference/image/functions/imagesetthickness.xml:1.5 Fri Jun 11 08:25:38 2004 +++ phpdoc/en/reference/image/functions/imagesetthickness.xml Sat Jan 13 17:11:46 2007 @@ -1,26 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.34 --> - <refentry id="function.imagesetthickness"> - <refnamediv> - <refname>imagesetthickness</refname> - <refpurpose>Set the thickness for line drawing</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagesetthickness</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>thickness</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagesetthickness</function> sets the thickness of the lines - drawn when drawing rectangles, polygons, ellipses etc. etc. to - <parameter>thickness</parameter> pixels. &return.success; - </para> - &note.gd.2; - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagesetthickness"> + <refnamediv> + <refname>imagesetthickness</refname> + <refpurpose>Set the thickness for line drawing</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagesetthickness</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>thickness</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagesetthickness</function> sets the thickness of the lines + drawn when drawing rectangles, polygons, ellipses etc. etc. to + <parameter>thickness</parameter> pixels. &return.success; + </para> + &note.gd.2; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagesettile.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagesettile.xml diff -u phpdoc/en/reference/image/functions/imagesettile.xml:1.5 phpdoc/en/reference/image/functions/imagesettile.xml:1.6 --- phpdoc/en/reference/image/functions/imagesettile.xml:1.5 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagesettile.xml Sat Jan 13 17:11:46 2007 @@ -1,39 +1,38 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.34 --> - <refentry id="function.imagesettile"> - <refnamediv> - <refname>imagesettile</refname> - <refpurpose>Set the tile image for filling</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagesettile</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>resource</type><parameter>tile</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagesettile</function> sets the tile image to be - used by all region filling functions (such as <function>imagefill</function> - and <function>imagefilledpolygon</function>) when filling with the special - color <literal>IMG_COLOR_TILED</literal>. - </para> - <para> - A tile is an image used to fill an area with a repeated pattern. <emphasis>Any</emphasis> - GD image can be used as a tile, and by setting the transparent color index of the tile - image with <function>imagecolortransparent</function>, a tile allows certain parts - of the underlying area to shine through can be created. - </para> - <note> - <para> - You need not take special action when you are finished with a tile, but if you - destroy the tile image, you must not use the <literal>IMG_COLOR_TILED</literal> - color until you have set a new tile image! - </para> - </note> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagesettile"> + <refnamediv> + <refname>imagesettile</refname> + <refpurpose>Set the tile image for filling</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagesettile</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>resource</type><parameter>tile</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagesettile</function> sets the tile image to be + used by all region filling functions (such as <function>imagefill</function> + and <function>imagefilledpolygon</function>) when filling with the special + color <literal>IMG_COLOR_TILED</literal>. + </para> + <para> + A tile is an image used to fill an area with a repeated pattern. <emphasis>Any</emphasis> + GD image can be used as a tile, and by setting the transparent color index of the tile + image with <function>imagecolortransparent</function>, a tile allows certain parts + of the underlying area to shine through can be created. + </para> + <note> + <para> + You need not take special action when you are finished with a tile, but if you + destroy the tile image, you must not use the <literal>IMG_COLOR_TILED</literal> + color until you have set a new tile image! + </para> + </note> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagestring.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/image/functions/imagestring.xml diff -u phpdoc/en/reference/image/functions/imagestring.xml:1.11 phpdoc/en/reference/image/functions/imagestring.xml:1.12 --- phpdoc/en/reference/image/functions/imagestring.xml:1.11 Mon Jan 30 14:34:34 2006 +++ phpdoc/en/reference/image/functions/imagestring.xml Sat Jan 13 17:11:46 2007 @@ -1,34 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagestring"> - <refnamediv> - <refname>imagestring</refname> - <refpurpose>Draw a string horizontally</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagestring</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>font</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam><type>string</type><parameter>s</parameter></methodparam> - <methodparam><type>int</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagestring</function> draws the string - <parameter>s</parameter> in the image identified by - <parameter>image</parameter> with the upper-left corner at coordinates - <parameter>x</parameter>, <parameter>y</parameter> (top left is - 0, 0) in color <parameter>col</parameter>. If font is 1, 2, 3, 4 - or 5, a built-in font is used. - </para> - <para> - <example> - <title><function>imagestring</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<refentry id="function.imagestring"> + <refnamediv> + <refname>imagestring</refname> + <refpurpose>Draw a string horizontally</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagestring</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>font</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam><type>string</type><parameter>s</parameter></methodparam> + <methodparam><type>int</type><parameter>col</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagestring</function> draws the string + <parameter>s</parameter> in the image identified by + <parameter>image</parameter> with the upper-left corner at coordinates + <parameter>x</parameter>, <parameter>y</parameter> (top left is + 0, 0) in color <parameter>col</parameter>. If font is 1, 2, 3, 4 + or 5, a built-in font is used. + </para> + <para> + <example> + <title><function>imagestring</function> example</title> + <programlisting role="php"> <![CDATA[ <?php // create a 100*30 image @@ -46,15 +45,15 @@ imagepng($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>imageloadfont</function>, and - <function>imagettftext</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>imageloadfont</function>, and + <function>imagettftext</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagestringup.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagestringup.xml diff -u phpdoc/en/reference/image/functions/imagestringup.xml:1.4 phpdoc/en/reference/image/functions/imagestringup.xml:1.5 --- phpdoc/en/reference/image/functions/imagestringup.xml:1.4 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagestringup.xml Sat Jan 13 17:11:46 2007 @@ -1,35 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagestringup"> - <refnamediv> - <refname>imagestringup</refname> - <refpurpose>Draw a string vertically</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagestringup</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>int</type><parameter>font</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam><type>string</type><parameter>s</parameter></methodparam> - <methodparam><type>int</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagestringup</function> draws the string - <parameter>s</parameter> vertically in the image identified by - <parameter>image</parameter> at coordinates - <parameter>x</parameter>, <parameter>y</parameter> (top left is - 0, 0) in color <parameter>col</parameter>. If font is 1, 2, 3, 4 - or 5, a built-in font is used. - </para> - <para> - See also <function>imageloadfont</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagestringup"> + <refnamediv> + <refname>imagestringup</refname> + <refpurpose>Draw a string vertically</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagestringup</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>int</type><parameter>font</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam><type>string</type><parameter>s</parameter></methodparam> + <methodparam><type>int</type><parameter>col</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagestringup</function> draws the string + <parameter>s</parameter> vertically in the image identified by + <parameter>image</parameter> at coordinates + <parameter>x</parameter>, <parameter>y</parameter> (top left is + 0, 0) in color <parameter>col</parameter>. If font is 1, 2, 3, 4 + or 5, a built-in font is used. + </para> + <para> + See also <function>imageloadfont</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagesx.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagesx.xml diff -u phpdoc/en/reference/image/functions/imagesx.xml:1.5 phpdoc/en/reference/image/functions/imagesx.xml:1.6 --- phpdoc/en/reference/image/functions/imagesx.xml:1.5 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagesx.xml Sat Jan 13 17:11:46 2007 @@ -1,24 +1,23 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagesx"> - <refnamediv> - <refname>imagesx</refname> - <refpurpose>Get image width</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagesx</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagesx</function> returns the width of the image - identified by <parameter>image</parameter>. - </para> - <example> - <title>Using <function>imagesx</function></title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagesx"> + <refnamediv> + <refname>imagesx</refname> + <refpurpose>Get image width</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagesx</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagesx</function> returns the width of the image + identified by <parameter>image</parameter>. + </para> + <example> + <title>Using <function>imagesx</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -28,16 +27,16 @@ echo imagesx($img); // 300 ?> -]]> - </programlisting> - </example> - <para> - See also <function>imagecreatetruecolor</function>, - <function>getimagesize</function> and - <function>imagesy</function>. - </para> - </refsect1> - </refentry> +]]> + </programlisting> + </example> + <para> + See also <function>imagecreatetruecolor</function>, + <function>getimagesize</function> and + <function>imagesy</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagesy.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagesy.xml diff -u phpdoc/en/reference/image/functions/imagesy.xml:1.5 phpdoc/en/reference/image/functions/imagesy.xml:1.6 --- phpdoc/en/reference/image/functions/imagesy.xml:1.5 Wed Aug 10 04:48:11 2005 +++ phpdoc/en/reference/image/functions/imagesy.xml Sat Jan 13 17:11:46 2007 @@ -1,24 +1,23 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagesy"> - <refnamediv> - <refname>imagesy</refname> - <refpurpose>Get image height</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagesy</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagesy</function> returns the height of the image - identified by <parameter>image</parameter>. - </para> - <example> - <title>Using <function>imagesy</function></title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagesy"> + <refnamediv> + <refname>imagesy</refname> + <refpurpose>Get image height</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagesy</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagesy</function> returns the height of the image + identified by <parameter>image</parameter>. + </para> + <example> + <title>Using <function>imagesy</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -28,16 +27,16 @@ echo imagesy($img); // 200 ?> -]]> - </programlisting> - </example> - <para> - See also <function>imagecreatetruecolor</function>, - <function>getimagesize</function> and - <function>imagesx</function>. - </para> - </refsect1> - </refentry> +]]> + </programlisting> + </example> + <para> + See also <function>imagecreatetruecolor</function>, + <function>getimagesize</function> and + <function>imagesx</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagetruecolortopalette.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/image/functions/imagetruecolortopalette.xml diff -u phpdoc/en/reference/image/functions/imagetruecolortopalette.xml:1.5 phpdoc/en/reference/image/functions/imagetruecolortopalette.xml:1.6 --- phpdoc/en/reference/image/functions/imagetruecolortopalette.xml:1.5 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/imagetruecolortopalette.xml Sat Jan 13 17:11:46 2007 @@ -1,41 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.34 --> - <refentry id="function.imagetruecolortopalette"> - <refnamediv> - <refname>imagetruecolortopalette</refname> - <refpurpose>Convert a true color image to a palette image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagetruecolortopalette</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>bool</type><parameter>dither</parameter></methodparam> - <methodparam><type>int</type><parameter>ncolors</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagetruecolortopalette</function> converts a truecolor image - to a palette image. The code for this function was originally drawn from - the Independent JPEG Group library code, which is excellent. The code - has been modified to preserve as much alpha channel information as - possible in the resulting palette, in addition to preserving colors as - well as possible. This does not work as well as might be hoped. It is - usually best to simply produce a truecolor output image instead, which - guarantees the highest output quality. - </para> - <para> - <parameter>dither</parameter> indicates if the image should be dithered - - if it is &true; then dithering will be used which will result in a more - speckled image but with better color approximation. - </para> - <para> - <parameter>ncolors</parameter> sets the maximum number of colors that - should be retained in the palette. - </para> - &note.gd.2; - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.imagetruecolortopalette"> + <refnamediv> + <refname>imagetruecolortopalette</refname> + <refpurpose>Convert a true color image to a palette image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagetruecolortopalette</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>bool</type><parameter>dither</parameter></methodparam> + <methodparam><type>int</type><parameter>ncolors</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagetruecolortopalette</function> converts a truecolor image + to a palette image. The code for this function was originally drawn from + the Independent JPEG Group library code, which is excellent. The code + has been modified to preserve as much alpha channel information as + possible in the resulting palette, in addition to preserving colors as + well as possible. This does not work as well as might be hoped. It is + usually best to simply produce a truecolor output image instead, which + guarantees the highest output quality. + </para> + <para> + <parameter>dither</parameter> indicates if the image should be dithered - + if it is &true; then dithering will be used which will result in a more + speckled image but with better color approximation. + </para> + <para> + <parameter>ncolors</parameter> sets the maximum number of colors that + should be retained in the palette. + </para> + &note.gd.2; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagettfbbox.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/image/functions/imagettfbbox.xml diff -u phpdoc/en/reference/image/functions/imagettfbbox.xml:1.7 phpdoc/en/reference/image/functions/imagettfbbox.xml:1.8 --- phpdoc/en/reference/image/functions/imagettfbbox.xml:1.7 Thu Aug 18 16:09:37 2005 +++ phpdoc/en/reference/image/functions/imagettfbbox.xml Sat Jan 13 17:11:46 2007 @@ -1,119 +1,118 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagettfbbox"> - <refnamediv> - <refname>imagettfbbox</refname> - <refpurpose>Give the bounding box of a text using TrueType fonts</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imagettfbbox</methodname> - <methodparam><type>float</type><parameter>size</parameter></methodparam> - <methodparam><type>float</type><parameter>angle</parameter></methodparam> - <methodparam><type>string</type><parameter>fontfile</parameter></methodparam> - <methodparam><type>string</type><parameter>text</parameter></methodparam> - </methodsynopsis> - <para> - This function calculates and returns the bounding box in pixels - for a TrueType text. - <variablelist> - <varlistentry> - <term> - <parameter>size</parameter> - </term> - <listitem> - <simpara>The font size in pixels.</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <parameter>angle</parameter> - </term> - <listitem> - <simpara> - Angle in degrees in which <parameter>text</parameter> will be - measured. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <parameter>fontfile</parameter> - </term> - <listitem> - <simpara> - The name of the TrueType font file (can be a URL). Depending on - which version of the GD library that PHP is using, it may attempt to - search for files that do not begin with a leading '/' by appending - '.ttf' to the filename and searching along a library-defined font path. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <parameter>text</parameter> - </term> - <listitem> - <simpara>The string to be measured.</simpara> - </listitem> - </varlistentry> - </variablelist> - <function>imagettfbbox</function> returns an array with 8 - elements representing four points making the bounding box of the - text: - <informaltable> - <tgroup cols="2"> - <tbody> - <row> - <entry>0</entry> - <entry>lower left corner, X position</entry> - </row> - <row> - <entry>1</entry> - <entry>lower left corner, Y position</entry> - </row> - <row> - <entry>2</entry> - <entry>lower right corner, X position</entry> - </row> - <row> - <entry>3</entry> - <entry>lower right corner, Y position</entry> - </row> - <row> - <entry>4</entry> - <entry>upper right corner, X position</entry> - </row> - <row> - <entry>5</entry> - <entry>upper right corner, Y position</entry> - </row> - <row> - <entry>6</entry> - <entry>upper left corner, X position</entry> - </row> - <row> - <entry>7</entry> - <entry>upper left corner, Y position</entry> - </row> - </tbody> - </tgroup> - </informaltable> - The points are relative to the <emphasis>text</emphasis> - regardless of the angle, so "upper left" means in the top - left-hand corner seeing the text horizontally. - </para> - <para> - This function requires both the GD library and the FreeType - library. - </para> - <para> - See also <function>imagettftext</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<refentry id="function.imagettfbbox"> + <refnamediv> + <refname>imagettfbbox</refname> + <refpurpose>Give the bounding box of a text using TrueType fonts</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>imagettfbbox</methodname> + <methodparam><type>float</type><parameter>size</parameter></methodparam> + <methodparam><type>float</type><parameter>angle</parameter></methodparam> + <methodparam><type>string</type><parameter>fontfile</parameter></methodparam> + <methodparam><type>string</type><parameter>text</parameter></methodparam> + </methodsynopsis> + <para> + This function calculates and returns the bounding box in pixels + for a TrueType text. + <variablelist> + <varlistentry> + <term> + <parameter>size</parameter> + </term> + <listitem> + <simpara>The font size in pixels.</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>angle</parameter> + </term> + <listitem> + <simpara> + Angle in degrees in which <parameter>text</parameter> will be + measured. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>fontfile</parameter> + </term> + <listitem> + <simpara> + The name of the TrueType font file (can be a URL). Depending on + which version of the GD library that PHP is using, it may attempt to + search for files that do not begin with a leading '/' by appending + '.ttf' to the filename and searching along a library-defined font path. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>text</parameter> + </term> + <listitem> + <simpara>The string to be measured.</simpara> + </listitem> + </varlistentry> + </variablelist> + <function>imagettfbbox</function> returns an array with 8 + elements representing four points making the bounding box of the + text: + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry>lower left corner, X position</entry> + </row> + <row> + <entry>1</entry> + <entry>lower left corner, Y position</entry> + </row> + <row> + <entry>2</entry> + <entry>lower right corner, X position</entry> + </row> + <row> + <entry>3</entry> + <entry>lower right corner, Y position</entry> + </row> + <row> + <entry>4</entry> + <entry>upper right corner, X position</entry> + </row> + <row> + <entry>5</entry> + <entry>upper right corner, Y position</entry> + </row> + <row> + <entry>6</entry> + <entry>upper left corner, X position</entry> + </row> + <row> + <entry>7</entry> + <entry>upper left corner, Y position</entry> + </row> + </tbody> + </tgroup> + </informaltable> + The points are relative to the <emphasis>text</emphasis> + regardless of the angle, so "upper left" means in the top + left-hand corner seeing the text horizontally. + </para> + <para> + This function requires both the GD library and the FreeType + library. + </para> + <para> + See also <function>imagettftext</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagettftext.xml?r1=1.19&r2=1.20&diff_format=u Index: phpdoc/en/reference/image/functions/imagettftext.xml diff -u phpdoc/en/reference/image/functions/imagettftext.xml:1.19 phpdoc/en/reference/image/functions/imagettftext.xml:1.20 --- phpdoc/en/reference/image/functions/imagettftext.xml:1.19 Fri Aug 25 00:05:45 2006 +++ phpdoc/en/reference/image/functions/imagettftext.xml Sat Jan 13 17:11:46 2007 @@ -1,110 +1,109 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Revision: 1.19 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagettftext"> - <refnamediv> - <refname>imagettftext</refname> - <refpurpose>Write text to the image using TrueType fonts</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imagettftext</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>float</type><parameter>size</parameter></methodparam> - <methodparam><type>float</type><parameter>angle</parameter></methodparam> - <methodparam><type>int</type><parameter>x</parameter></methodparam> - <methodparam><type>int</type><parameter>y</parameter></methodparam> - <methodparam><type>int</type><parameter>color</parameter></methodparam> - <methodparam><type>string</type><parameter>fontfile</parameter></methodparam> - <methodparam><type>string</type><parameter>text</parameter></methodparam> - </methodsynopsis> - <para> - <variablelist> - <varlistentry> - <term><parameter>image</parameter></term> - <listitem> - <simpara> - The image resource. See <function>imagecreatetruecolor</function>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>size</parameter></term> - <listitem> - <simpara> - The font size. Depending on your version of GD, this should be - specified as the pixel size (GD1) or point size (GD2). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>angle</parameter></term> - <listitem> - <simpara> - The angle in degrees, with 0 degrees being left-to-right reading text. - Higher values represent a counter-clockwise rotation. For example, - a value of 90 would result in bottom-to-top reading text. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>x</parameter></term> - <listitem> - <simpara> - The coordinates given by <parameter>x</parameter> and - <parameter>y</parameter> will define the basepoint of the first - character (roughly the lower-left corner of the character). This - is different from the <function>imagestring</function>, where - <parameter>x</parameter> and <parameter>y</parameter> define the - upper-left corner of the first character. For example, "top left" - is 0, 0. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>y</parameter></term> - <listitem> - <simpara> - The y-ordinate. This sets the position of the fonts baseline, not - the very bottom of the character. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>color</parameter></term> - <listitem> - <simpara> - The color index. Using the negative of a color index has - the effect of turning off antialiasing. - See <function>imagecolorallocate</function>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>fontfile</parameter></term> - <listitem> - <simpara> - The path to the TrueType font you wish to use. - </simpara> - <simpara> - Depending on which version of the GD library PHP is using, <emphasis>when - <parameter>fontfile</parameter> does not begin with a leading - <literal>/</literal> then <literal>.ttf</literal> will be appended</emphasis> - to the filename and the library will attempt to search for that - filename along a library-defined font path. - </simpara> - <simpara> - When using versions of the GD library lower than 2.0.18, a <literal>space</literal> character, - rather than a semicolon, was used as the 'path separator' for different font files. - Unintentional use of this feature will result in the warning message: - <literal>Warning: Could not find/open font</literal>. For these affected versions, the - only solution is moving the font to a path which does not contain spaces. - </simpara> - <para> - In many cases where a font resides in the same directory as the script using it - the following trick will alleviate any include problems. - <programlisting role="php"> +<!-- $Revision: 1.20 $ --> +<refentry id="function.imagettftext"> + <refnamediv> + <refname>imagettftext</refname> + <refpurpose>Write text to the image using TrueType fonts</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>imagettftext</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>float</type><parameter>size</parameter></methodparam> + <methodparam><type>float</type><parameter>angle</parameter></methodparam> + <methodparam><type>int</type><parameter>x</parameter></methodparam> + <methodparam><type>int</type><parameter>y</parameter></methodparam> + <methodparam><type>int</type><parameter>color</parameter></methodparam> + <methodparam><type>string</type><parameter>fontfile</parameter></methodparam> + <methodparam><type>string</type><parameter>text</parameter></methodparam> + </methodsynopsis> + <para> + <variablelist> + <varlistentry> + <term><parameter>image</parameter></term> + <listitem> + <simpara> + The image resource. See <function>imagecreatetruecolor</function>. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>size</parameter></term> + <listitem> + <simpara> + The font size. Depending on your version of GD, this should be + specified as the pixel size (GD1) or point size (GD2). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>angle</parameter></term> + <listitem> + <simpara> + The angle in degrees, with 0 degrees being left-to-right reading text. + Higher values represent a counter-clockwise rotation. For example, + a value of 90 would result in bottom-to-top reading text. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>x</parameter></term> + <listitem> + <simpara> + The coordinates given by <parameter>x</parameter> and + <parameter>y</parameter> will define the basepoint of the first + character (roughly the lower-left corner of the character). This + is different from the <function>imagestring</function>, where + <parameter>x</parameter> and <parameter>y</parameter> define the + upper-left corner of the first character. For example, "top left" + is 0, 0. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>y</parameter></term> + <listitem> + <simpara> + The y-ordinate. This sets the position of the fonts baseline, not + the very bottom of the character. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>color</parameter></term> + <listitem> + <simpara> + The color index. Using the negative of a color index has + the effect of turning off antialiasing. + See <function>imagecolorallocate</function>. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>fontfile</parameter></term> + <listitem> + <simpara> + The path to the TrueType font you wish to use. + </simpara> + <simpara> + Depending on which version of the GD library PHP is using, <emphasis>when + <parameter>fontfile</parameter> does not begin with a leading + <literal>/</literal> then <literal>.ttf</literal> will be appended</emphasis> + to the filename and the library will attempt to search for that + filename along a library-defined font path. + </simpara> + <simpara> + When using versions of the GD library lower than 2.0.18, a <literal>space</literal> character, + rather than a semicolon, was used as the 'path separator' for different font files. + Unintentional use of this feature will result in the warning message: + <literal>Warning: Could not find/open font</literal>. For these affected versions, the + only solution is moving the font to a path which does not contain spaces. + </simpara> + <para> + In many cases where a font resides in the same directory as the script using it + the following trick will alleviate any include problems. + <programlisting role="php"> <![CDATA[ <?php // Set the enviroment variable for GD @@ -114,50 +113,50 @@ $font = 'SomeFont'; ?> ]]> - </programlisting> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>text</parameter></term> - <listitem> - <simpara> - The text string. - </simpara> - <simpara> - May include decimal numeric character references (of the form: - &amp;#8364;) to access characters in a font beyond position 127. - The hexadecimal format (like &amp;#xA9;) is supported as of PHP 5.2.0. - Strings in UTF-8 encoding can be passed directly. - </simpara> - <simpara> - Named entities, such as &amp;copy;, are not supported. Consider using <function>html_entity_decode</function> - to decode these named entities into UTF-8 strings (html_entity_decode() supports this as of PHP 5.0.0). - </simpara> - <simpara> - If a character is used in the string which is not supported by the - font, a hollow rectangle will replace the character. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> + </programlisting> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>text</parameter></term> + <listitem> + <simpara> + The text string. + </simpara> + <simpara> + May include decimal numeric character references (of the form: + &amp;#8364;) to access characters in a font beyond position 127. + The hexadecimal format (like &amp;#xA9;) is supported as of PHP 5.2.0. + Strings in UTF-8 encoding can be passed directly. + </simpara> + <simpara> + Named entities, such as &amp;copy;, are not supported. Consider using <function>html_entity_decode</function> + to decode these named entities into UTF-8 strings (html_entity_decode() supports this as of PHP 5.0.0). + </simpara> + <simpara> + If a character is used in the string which is not supported by the + font, a hollow rectangle will replace the character. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + <function>imagettftext</function> returns an array with 8 + elements representing four points making the bounding box of the + text. The order of the points is lower left, lower right, upper + right, upper left. The points are relative to the text + regardless of the angle, so "upper left" means in the top + left-hand corner when you see the text horizontally. + </para> + <para> + <example> + <title><function>imagettftext</function> example</title> <para> - <function>imagettftext</function> returns an array with 8 - elements representing four points making the bounding box of the - text. The order of the points is lower left, lower right, upper - right, upper left. The points are relative to the text - regardless of the angle, so "upper left" means in the top - left-hand corner when you see the text horizontally. + This example script will produce a white PNG 400x30 pixels, with + the words "Testing..." in black (with grey shadow), in the font Arial. </para> - <para> - <example> - <title><function>imagettftext</function> example</title> - <para> - This example script will produce a white PNG 400x30 pixels, with - the words "Testing..." in black (with grey shadow), in the font Arial. - </para> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php // Set the content-type @@ -188,18 +187,18 @@ imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - This function requires both the GD library and the <ulink - url="&url.freetype;">FreeType</ulink> library. - </para> - <para> - See also <function>imagettfbbox</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + This function requires both the GD library and the <ulink + url="&url.freetype;">FreeType</ulink> library. + </para> + <para> + See also <function>imagettfbbox</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagetypes.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/image/functions/imagetypes.xml diff -u phpdoc/en/reference/image/functions/imagetypes.xml:1.4 phpdoc/en/reference/image/functions/imagetypes.xml:1.5 --- phpdoc/en/reference/image/functions/imagetypes.xml:1.4 Mon Apr 12 22:43:56 2004 +++ phpdoc/en/reference/image/functions/imagetypes.xml Sat Jan 13 17:11:46 2007 @@ -1,26 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.61 --> - <refentry id="function.imagetypes"> - <refnamediv> - <refname>imagetypes</refname> - <refpurpose>Return the image types supported by this PHP build</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imagetypes</methodname> - <void/> - </methodsynopsis> - <para> - This function returns a bit-field corresponding to the image - formats supported by the version of GD linked into PHP. The - following bits are returned, <constant>IMG_GIF</constant> | <constant>IMG_JPG</constant> - | <constant>IMG_PNG</constant> | <constant>IMG_WBMP</constant> | <constant>IMG_XPM</constant>. - To check for PNG support, for example, do this: - <example> - <title><function>imagetypes</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.imagetypes"> + <refnamediv> + <refname>imagetypes</refname> + <refpurpose>Return the image types supported by this PHP build</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>imagetypes</methodname> + <void/> + </methodsynopsis> + <para> + This function returns a bit-field corresponding to the image + formats supported by the version of GD linked into PHP. The + following bits are returned, <constant>IMG_GIF</constant> | <constant>IMG_JPG</constant> + | <constant>IMG_PNG</constant> | <constant>IMG_WBMP</constant> | <constant>IMG_XPM</constant>. + To check for PNG support, for example, do this: + <example> + <title><function>imagetypes</function> example</title> + <programlisting role="php"> <![CDATA[ <?php if (imagetypes() & IMG_PNG) { @@ -28,11 +27,11 @@ } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagewbmp.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/image/functions/imagewbmp.xml diff -u phpdoc/en/reference/image/functions/imagewbmp.xml:1.6 phpdoc/en/reference/image/functions/imagewbmp.xml:1.7 --- phpdoc/en/reference/image/functions/imagewbmp.xml:1.6 Fri Aug 25 17:33:25 2006 +++ phpdoc/en/reference/image/functions/imagewbmp.xml Sat Jan 13 17:11:46 2007 @@ -1,51 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> - <refentry id="function.imagewbmp"> - <refnamediv> - <refname>imagewbmp</refname> - <refpurpose>Output image to browser or file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagewbmp</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>foreground</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.7 $ --> +<refentry id="function.imagewbmp"> + <refnamediv> + <refname>imagewbmp</refname> + <refpurpose>Output image to browser or file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagewbmp</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>foreground</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagewbmp</function> creates the + <acronym>WBMP</acronym> file in filename from the image + <parameter>image</parameter>. The <parameter>image</parameter> argument + is the return from the <function>imagecreatetruecolor</function> function. + </para> + <para> + The filename argument is optional, and if left off or filled with a + &null; value, the raw image stream will be output directly. + 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. + <note> <para> - <function>imagewbmp</function> creates the - <acronym>WBMP</acronym> file in filename from the image - <parameter>image</parameter>. The <parameter>image</parameter> argument - is the return from the <function>imagecreatetruecolor</function> function. + WBMP support is only available if PHP was compiled + against GD-1.8 or later. </para> - <para> - The filename argument is optional, and if left off or filled with a - &null; value, the raw image stream will be output directly. - 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. - <note> - <para> - WBMP support is only available if PHP was compiled - against GD-1.8 or later. - </para> - </note> - </para> - <para> - Using the optional <parameter>foreground</parameter> - parameter, you can set the foreground color. Use an - identifier obtained from <function>imagecolorallocate</function>. - The default foreground color is black. - </para> - <para> - See also <function>image2wbmp</function>, <function>imagepng</function>, - <function>imagegif</function>, <function>imagejpeg</function>, - <function>imagetypes</function>. - </para> - </refsect1> - </refentry> + </note> + </para> + <para> + Using the optional <parameter>foreground</parameter> + parameter, you can set the foreground color. Use an + identifier obtained from <function>imagecolorallocate</function>. + The default foreground color is black. + </para> + <para> + See also <function>image2wbmp</function>, <function>imagepng</function>, + <function>imagegif</function>, <function>imagejpeg</function>, + <function>imagetypes</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagexbm.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/image/functions/imagexbm.xml diff -u phpdoc/en/reference/image/functions/imagexbm.xml:1.3 phpdoc/en/reference/image/functions/imagexbm.xml:1.4 --- phpdoc/en/reference/image/functions/imagexbm.xml:1.3 Mon Jun 21 11:45:37 2004 +++ phpdoc/en/reference/image/functions/imagexbm.xml Sat Jan 13 17:11:46 2007 @@ -1,25 +1,23 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.3 $ --> - <refentry id="function.imagexbm"> - <refnamediv> - <refname>imagexbm</refname> - <refpurpose> - Output XBM image to browser or file - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>imagexbm</methodname> - <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>foreground</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.4 $ --> +<refentry id="function.imagexbm"> + <refnamediv> + <refname>imagexbm</refname> + <refpurpose>Output XBM image to browser or file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>imagexbm</methodname> + <methodparam><type>resource</type><parameter>image</parameter></methodparam> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>foreground</parameter></methodparam> + </methodsynopsis> - &warn.undocumented.func; - &note.bundled.gd; - </refsect1> - </refentry> + &warn.undocumented.func; + &note.bundled.gd; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/iptcembed.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/image/functions/iptcembed.xml diff -u phpdoc/en/reference/image/functions/iptcembed.xml:1.3 phpdoc/en/reference/image/functions/iptcembed.xml:1.4 --- phpdoc/en/reference/image/functions/iptcembed.xml:1.3 Thu Jun 23 16:53:23 2005 +++ phpdoc/en/reference/image/functions/iptcembed.xml Sat Jan 13 17:11:46 2007 @@ -1,24 +1,23 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.70 --> - <refentry id='function.iptcembed'> - <refnamediv> - <refname>iptcembed</refname> - <refpurpose>Embed binary IPTC data into a JPEG image</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>iptcembed</methodname> - <methodparam><type>string</type><parameter>iptcdata</parameter></methodparam> - <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> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id='function.iptcembed'> + <refnamediv> + <refname>iptcembed</refname> + <refpurpose>Embed binary IPTC data into a JPEG image</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>mixed</type><methodname>iptcembed</methodname> + <methodparam><type>string</type><parameter>iptcdata</parameter></methodparam> + <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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/iptcparse.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/image/functions/iptcparse.xml diff -u phpdoc/en/reference/image/functions/iptcparse.xml:1.1 phpdoc/en/reference/image/functions/iptcparse.xml:1.2 --- phpdoc/en/reference/image/functions/iptcparse.xml:1.1 Sun Jun 16 11:57:57 2002 +++ phpdoc/en/reference/image/functions/iptcparse.xml Sat Jan 13 17:11:46 2007 @@ -1,28 +1,24 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- splitted from ./en/functions/misc.xml, last change in rev 1.2 --> - <refentry id="function.iptcparse"> - <refnamediv> - <refname>iptcparse</refname> - <refpurpose> - Parse a binary IPTC <ulink url="&url.iptc;">&url.iptc;</ulink> - block into single tags. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>iptcparse</methodname> - <methodparam><type>string</type><parameter>iptcblock</parameter></methodparam> - </methodsynopsis> - <simpara> - This function parses a binary IPTC block into its single tags. It - returns an array using the tagmarker as an index and the value as - the value. It returns &false; on error or if no IPTC data was - found. See <function>getimagesize</function> for a sample. - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.2 $ --> +<refentry id="function.iptcparse"> + <refnamediv> + <refname>iptcparse</refname> + <refpurpose>Parse a binary IPTC <ulink url="&url.iptc;">&url.iptc;</ulink> block into single tags.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>iptcparse</methodname> + <methodparam><type>string</type><parameter>iptcblock</parameter></methodparam> + </methodsynopsis> + <simpara> + This function parses a binary IPTC block into its single tags. It + returns an array using the tagmarker as an index and the value as + the value. It returns &false; on error or if no IPTC data was + found. See <function>getimagesize</function> for a sample. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/jpeg2wbmp.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/image/functions/jpeg2wbmp.xml diff -u phpdoc/en/reference/image/functions/jpeg2wbmp.xml:1.3 phpdoc/en/reference/image/functions/jpeg2wbmp.xml:1.4 --- phpdoc/en/reference/image/functions/jpeg2wbmp.xml:1.3 Mon Feb 21 20:59:54 2005 +++ phpdoc/en/reference/image/functions/jpeg2wbmp.xml Sat Jan 13 17:11:46 2007 @@ -1,37 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.61 --> - <refentry id="function.jpeg2wbmp"> - <refnamediv> - <refname>jpeg2wbmp</refname> - <refpurpose>Convert JPEG image file to WBMP image file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>jpeg2wbmp</methodname> - <methodparam><type>string</type><parameter>jpegname</parameter></methodparam> - <methodparam><type>string</type><parameter>wbmpname</parameter></methodparam> - <methodparam><type>int</type><parameter>d_height</parameter></methodparam> - <methodparam><type>int</type><parameter>d_width</parameter></methodparam> - <methodparam><type>int</type><parameter>threshold</parameter></methodparam> - </methodsynopsis> - <para> - Converts the <parameter>jpegname</parameter> JPEG file - to WBMP format, and saves it as <parameter>wbmpname</parameter>. - With the <parameter>d_height</parameter> and - <parameter>d_width</parameter> you specify the height - and width of the destination image. - </para> +<!-- $Revision: 1.4 $ --> +<refentry id="function.jpeg2wbmp"> + <refnamediv> + <refname>jpeg2wbmp</refname> + <refpurpose>Convert JPEG image file to WBMP image file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>jpeg2wbmp</methodname> + <methodparam><type>string</type><parameter>jpegname</parameter></methodparam> + <methodparam><type>string</type><parameter>wbmpname</parameter></methodparam> + <methodparam><type>int</type><parameter>d_height</parameter></methodparam> + <methodparam><type>int</type><parameter>d_width</parameter></methodparam> + <methodparam><type>int</type><parameter>threshold</parameter></methodparam> + </methodsynopsis> + <para> + Converts the <parameter>jpegname</parameter> JPEG file + to WBMP format, and saves it as <parameter>wbmpname</parameter>. + With the <parameter>d_height</parameter> and + <parameter>d_width</parameter> you specify the height + and width of the destination image. + </para> - &note.config.jpeg; - &note.config.wbmp; + &note.config.jpeg; + &note.config.wbmp; - <para> - See also <function>png2wbmp</function>. - </para> - </refsect1> - </refentry> + <para> + See also <function>png2wbmp</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/png2wbmp.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/image/functions/png2wbmp.xml diff -u phpdoc/en/reference/image/functions/png2wbmp.xml:1.3 phpdoc/en/reference/image/functions/png2wbmp.xml:1.4 --- phpdoc/en/reference/image/functions/png2wbmp.xml:1.3 Mon Feb 21 20:59:54 2005 +++ phpdoc/en/reference/image/functions/png2wbmp.xml Sat Jan 13 17:11:46 2007 @@ -1,34 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/image.xml, last change in rev 1.13 --> - <refentry id="function.png2wbmp"> - <refnamediv> - <refname>png2wbmp</refname> - <refpurpose>Convert PNG image file to WBMP image file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>png2wbmp</methodname> - <methodparam><type>string</type><parameter>pngname</parameter></methodparam> - <methodparam><type>string</type><parameter>wbmpname</parameter></methodparam> - <methodparam><type>int</type><parameter>d_height</parameter></methodparam> - <methodparam><type>int</type><parameter>d_width</parameter></methodparam> - <methodparam><type>int</type><parameter>threshold</parameter></methodparam> - </methodsynopsis> - <para> - Converts the <parameter>pngname</parameter> PNG file - to WBMP format, and saves it as <parameter>wbmpname</parameter>. - With the <parameter>d_height</parameter> and - <parameter>d_width</parameter> you specify the height - and width of the destination image. - </para> - &note.config.wbmp; - <para> - See also <function>jpeg2wbmp</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.png2wbmp"> + <refnamediv> + <refname>png2wbmp</refname> + <refpurpose>Convert PNG image file to WBMP image file</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>png2wbmp</methodname> + <methodparam><type>string</type><parameter>pngname</parameter></methodparam> + <methodparam><type>string</type><parameter>wbmpname</parameter></methodparam> + <methodparam><type>int</type><parameter>d_height</parameter></methodparam> + <methodparam><type>int</type><parameter>d_width</parameter></methodparam> + <methodparam><type>int</type><parameter>threshold</parameter></methodparam> + </methodsynopsis> + <para> + Converts the <parameter>pngname</parameter> PNG file + to WBMP format, and saves it as <parameter>wbmpname</parameter>. + With the <parameter>d_height</parameter> and + <parameter>d_width</parameter> you specify the height + and width of the destination image. + </para> + &note.config.wbmp; + <para> + See also <function>jpeg2wbmp</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: