UI\Draw\Pen::clip()函式—用法及示例

函式名稱：UI\Draw\Pen::clip()

適用版本：PHP 7.4.0 及以上版本

函式描述：該函式用於設定繪圖區域的剪裁範圍，只有在剪裁範圍內的繪圖操作才會生效。

用法：

public UI\Draw\Pen::clip ( UI\Point $point, UI\Size $size ) : void

引數：

• $point (UI\Point)：剪裁範圍的起始點座標。
• $size (UI\Size)：剪裁範圍的尺寸。

示例：

// 建立一個繪圖區域
$area = new UI\Area(400, 300);

// 建立一個畫筆
$pen = new UI\Draw\Pen();

// 設定剪裁範圍
$point = new UI\Point(50, 50);
$size = new UI\Size(200, 150);
$pen->clip($point, $size);

// 在剪裁範圍內繪製一個矩形
$pen->rectangle(0, 0, 400, 300);

// 清除剪裁範圍
$pen->clip(new UI\Point(0, 0), new UI\Size(400, 300));

// 在整個繪圖區域繪製一個圓形
$pen->ellipse($area->width / 2, $area->height / 2, $area->width / 2, $area->height / 2);

在上述示例中，我們首先建立了一個繪圖區域 $area，然後建立了一個畫筆 $pen。透過呼叫 $pen->clip() 函式，我們設定了剪裁範圍為一個矩形區域，起始點座標為 (50, 50)，尺寸為 200x150。接下來，在剪裁範圍內繪製了一個矩形，然後透過再次呼叫 $pen->clip() 函式來清除剪裁範圍，最後在整個繪圖區域繪製了一個圓形。