破線を描画する

# imagedashedline

(PHP 4, PHP 5, PHP 7, PHP 8)

imagedashedline — 破線を描画する

### 説明

function imagedashedline(
GdImage `$image`,
int `$x1`,
int `$y1`,
int `$x2`,
int `$y2`,
int `$color`
): true

これは古い関数です。代わりに imagesetstyle() と imageline() の組み合せを使用してください。0, 0 は画像の左上の角です。

### パラメータ

`image`
  imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。
`x1`

  1 つ目の点の x 座標。

`y1`

  1 つ目の点の y 座標。

`x2`

  2 つ目の点の x 座標。

`y2`

  2 つ目の点の y 座標。

`color`

  塗りつぶし色。imagecolorallocate() で作成された色識別子。

### 戻り値

常に `true` を返します。

### 変更履歴

バージョン | 説明
--- | ---
8.0.0 | `image` は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な `gd` resource が期待されていました。

### 例

例1 imagedashedline() の例

    <?php
    // 100x100 の画像を作成します
    $im = imagecreatetruecolor(100, 100);
    $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

    // 縦の破線を描画します
    imagedashedline($im, 50, 25, 50, 75, $white);

    // 画像を保存します
    imagepng($im, './dashedline.png');
    ?>

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

例2 imagedashedline() のもうひとつの使用法

    <?php
    // 100x100 の画像を作成します
    $im = imagecreatetruecolor(100, 100);
    $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

    // 独自のスタイルの作成: 最初の 4 ピクセルを白色、
    // 次の 4 ピクセルを透明とし、破線風の効果を作成します
    $style = Array(
                    $white,
                    $white,
                    $white,
                    $white,
                    IMG_COLOR_TRANSPARENT,
                    IMG_COLOR_TRANSPARENT,
                    IMG_COLOR_TRANSPARENT,
                    IMG_COLOR_TRANSPARENT
                    );

    imagesetstyle($im, $style);

    // 破線を描画します
    imageline($im, 50, 25, 50, 75, IMG_COLOR_STYLED);

    // 画像を保存します
    imagepng($im, './imageline.png');
    ?>

### 参考

- imagesetstyle() - 線描画用のスタイルを設定する
- imageline() - 直線を描画する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open