reference/image/functions/imagepolygon.xml
8a2141dcc084f72feb4e0ae2feaff3b440e5c59e
8a2141dcc084f72feb4e0ae2feaff3b440e5c59e
...
...
@@ -7,9 +7,17 @@
7
7
</refnamediv>
8
8
<refsect1 role="description">
9
9
&reftitle.description;
10
+
<simpara>Signature as of PHP 8.0.0 (not supported with named arguments)</simpara>
10
11
<methodsynopsis>
11
12
<type>bool</type><methodname>imagepolygon</methodname>
12
-
<methodparam><type>resource</type><parameter>image</parameter></methodparam>
13
+
<methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
14
+
<methodparam><type>array</type><parameter>points</parameter></methodparam>
15
+
<methodparam><type>int</type><parameter>color</parameter></methodparam>
16
+
</methodsynopsis>
17
+
<simpara>Alternative signature (deprecated as of PHP 8.1.0)</simpara>
18
+
<methodsynopsis>
19
+
<type>bool</type><methodname>imagepolygon</methodname>
20
+
<methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
13
21
<methodparam><type>array</type><parameter>points</parameter></methodparam>
14
22
<methodparam><type>int</type><parameter>num_points</parameter></methodparam>
15
23
<methodparam><type>int</type><parameter>color</parameter></methodparam>
...
...
@@ -58,16 +66,20 @@
58
66
<term><parameter>num_points</parameter></term>
59
67
<listitem>
60
68
<para>
61
-
Total number of points (vertices).
69
+
Total number of points (vertices), which must be at least 3.
62
70
</para>
71
+
<simpara>
72
+
If this parameter is omitted as per the second signature, <parameter>points</parameter>
73
+
must have an even number of elements, and <parameter>num_points</parameter> is
74
+
assumed to be <code>count($points)/2</code>.
75
+
</simpara>
63
76
</listitem>
64
77
</varlistentry>
65
78
<varlistentry>
66
79
<term><parameter>color</parameter></term>
67
80
<listitem>
68
81
<para>
69
-
A color identifier created with
70
-
<function>imagecolorallocate</function>.
82
+
&gd.identifier.color;
71
83
</para>
72
84
</listitem>
73
85
</varlistentry>
...
...
@@ -80,6 +92,30 @@
80
92
&return.success;
81
93
</para>
82
94
</refsect1>
95
+
96
+
<refsect1 role="changelog">
97
+
&reftitle.changelog;
98
+
<informaltable>
99
+
<tgroup cols="2">
100
+
<thead>
101
+
<row>
102
+
<entry>&Version;</entry>
103
+
<entry>&Description;</entry>
104
+
</row>
105
+
</thead>
106
+
<tbody>
107
+
<row>
108
+
<entry>8.1.0</entry>
109
+
<entry>
110
+
The parameter <parameter>num_points</parameter> has been deprecated.
111
+
</entry>
112
+
</row>
113
+
&gd.changelog.image-param;
114
+
</tbody>
115
+
</tgroup>
116
+
</informaltable>
117
+
</refsect1>
118
+
83
119
<refsect1 role="examples">
84
120
&reftitle.examples;
85
121
<para>
...
...
@@ -123,15 +159,14 @@ imagedestroy($image);
123
159
</refsect1>
124
160
<refsect1 role="seealso">
125
161
&reftitle.seealso;
126
-
<para>
127
-
<simplelist>
128
-
<member><function>imagecreate</function></member>
129
-
<member><function>imagecreatetruecolor</function></member>
130
-
</simplelist>
131
-
</para>
162
+
<simplelist>
163
+
<member><function>imagefilledpolygon</function></member>
164
+
<member><function>imageopenpolygon</function></member>
165
+
<member><function>imagecreate</function></member>
166
+
<member><function>imagecreatetruecolor</function></member>
167
+
</simplelist>
132
168
</refsect1>
133
169
</refentry>
134
-
135
170
<!-- Keep this comment at the end of the file
136
171
Local variables:
137
172
mode: sgml
138
173