imageopenpolygon
(PHP 7 >= 7.2.0, PHP 8)
imageopenpolygon — オープンポリゴンを描画する
説明
PHP 8.0.0 以降のシグネチャ (名前付き引数をサポートしていません)
代替のシグネチャ (PHP 8.1.0 以降は非推奨)
imageopenpolygon() 関数は、
与えられた image のオープンポリゴンを描画します。
imagepolygon() とは異なり、
始点と終点の間の線は描かれません。
パラメータ
-
image -
imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。
-
points -
ポリゴンの点を含む配列:
points[0] = x0 points[1] = y0 points[2] = x1 points[3] = y1 -
num_points -
全ての点の数。少なくとも3以上である必要があります。
代替のシグネチャ(PHP 8.0.0 以降) でこの引数が省略された場合、pointsは偶数でなければいけません。また、num_pointsはcount($points)/2であると仮定されます。 -
color -
imagecolorallocate() で作成された色識別子。
戻り値
成功した場合に true を、失敗した場合に false を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 8.1.0 |
引数 num_points は、推奨されなくなりました。
|
| 8.0.0 |
image は、
GdImage
クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、resource が期待されていました。
|
例
例1 imageopenpolygon() の例
<?php
// 空の画像を生成します。
$image = imagecreatetruecolor(400, 300);
// 色をポリゴンに割り当てます。
$col_poly = imagecolorallocate($image, 255, 255, 255);
// ポリゴンを描画します。
imageopenpolygon($image, array(
0, 0,
100, 200,
300, 200
),
3,
$col_poly);
// 画像をブラウザに出力します。
header('Content-type: image/png');
imagepng($image);
imagedestroy($image);
?>
上の例の出力は、 たとえば以下のようになります。
参考
- imagepolygon() - 多角形を描画する