imagepolygon
(PHP 4, PHP 5, PHP 7, PHP 8)
imagepolygon — 多角形を描画する
説明
PHP 8.0.0 以降のシグネチャ(名前付き引数をサポートしていません)
代替のシグネチャ (PHP 8.1.0 以降は非推奨)
imagepolygon() は、指定した
image に多角形を作成します。
パラメータ
-
image -
imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。
-
points -
多角形の頂点からなる PHP の配列で、 次のようになります。
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 imagepolygon() の例
<?php
// 空の画像を生成します
$image = imagecreatetruecolor(400, 300);
// 多角形の色を選択します
$col_poly = imagecolorallocate($image, 255, 255, 255);
// 多角形を描画します
imagepolygon($image, array(
0, 0,
100, 200,
300, 200
),
3,
$col_poly);
// 画像を出力します
header('Content-type: image/png');
imagepng($image);
imagedestroy($image);
?>
上の例の出力は、 たとえば以下のようになります。
参考
- imagefilledpolygon() - 塗りつぶした多角形を描画する
- imageopenpolygon() - オープンポリゴンを描画する
- imagecreate() - パレットを使用する新規画像を作成する
- imagecreatetruecolor() - TrueColor イメージを新規に作成する