php-doc-en/reference/image/functions/imagefilledarc.xml
Nuno Lopes a5750a8f03 fix #28737: add GD 2 info
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@161074 c90b9560-bf6c-de11-be94-00142212c4b1
2004-06-11 08:25:38 +00:00

115 lines
4.4 KiB
XML

<?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.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
// this example is provided by poxy at klam dot is
// create image
$image = imagecreate(100, 100);
// allocate some solors
$white = imagecolorallocate($image, 0xFF, 0xFF, 0xFF);
$gray = imagecolorallocate($image, 0xC0, 0xC0, 0xC0);
$darkgray = imagecolorallocate($image, 0x90, 0x90, 0x90);
$navy = imagecolorallocate($image, 0x00, 0x00, 0x80);
$darknavy = imagecolorallocate($image, 0x00, 0x00, 0x50);
$red = imagecolorallocate($image, 0xFF, 0x00, 0x00);
$darkred = imagecolorallocate($image, 0x90, 0x00, 0x00);
// make the 3D effect
for ($i = 60; $i > 50; $i--) {
imagefilledarc($image, 50, $i, 100, 50, 0, 45, $darknavy, IMG_ARC_PIE);
imagefilledarc($image, 50, $i, 100, 50, 45, 75 , $darkgray, IMG_ARC_PIE);
imagefilledarc($image, 50, $i, 100, 50, 75, 360 , $darkred, IMG_ARC_PIE);
}
imagefilledarc($image, 50, 50, 100, 50, 0, 45, $navy, IMG_ARC_PIE);
imagefilledarc($image, 50, 50, 100, 50, 45, 75 , $gray, IMG_ARC_PIE);
imagefilledarc($image, 50, 50, 100, 50, 75, 360 , $red, IMG_ARC_PIE);
// flush image
header('Content-type: image/png');
imagepng($image);
imagedestroy($image);
?>
]]>
</programlisting>
</example>
</para>
&note.gd.2;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->