imageopenpolygon

オープンポリゴンを描画する

説明

PHP 8.0.0 以降のシグネチャ (名前付き引数をサポートしていません)

bool imageopenpolygon(GdImage $image, array $points, int $color)

代替のシグネチャ (PHP 8.1.0 以降は非推奨)

bool imageopenpolygon(
    GdImage $image,
    array $points,
    int $num_points,
    int $color
)

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_pointscount($points)/2 であると仮定されます。
color

imagecolorallocate で作成された色識別子。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン 説明
8.1.0 引数 num_points は、推奨されなくなりました。
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な gd 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);
?>

上の例の出力は、 たとえば以下のようになります。

imageopenpolygon() の出力例

参考

  • imagepolygon