绘制虚线

# 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() 组合替代。

### 参数

`image`
  由图象创建函数(例如imagecreatetruecolor())返回的 GdImage 对象。
`x1`

  左上 x 坐标。

`y1`

  左上 y 坐标。0，0 为图像的左上角。

`x2`

  右下 x 坐标。

`y2`

  右下 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