ImagickDraw::pushClipPath()函式—用法及示例

函式名稱：ImagickDraw::pushClipPath()

適用版本：Imagick 3.3.0以上版本

用法：該方法用於將當前影象繪製上下文中的剪下路徑推送到剪下路徑堆疊中。剪下路徑定義了繪製操作的剪下區域，只有在該區域內的內容才會被繪製。

語法：bool ImagickDraw::pushClipPath ( string $clip_mask_id )

引數：

• clip_mask_id：剪下路徑的唯一識別符號，用於在之後的繪製操作中引用剪下路徑。

返回值：成功時返回 true，失敗時返回 false。

示例：

<?php
// 建立一個新的ImagickDraw物件
$draw = new ImagickDraw();

// 定義剪下路徑
$clipPathId = 'myClipPath';
$draw->pushClipPath($clipPathId);

// 在剪下路徑內繪製一個矩形
$draw->rectangle(50, 50, 150, 150);

// 彈出剪下路徑
$draw->popClipPath();

// 建立一個新的Imagick物件
$image = new Imagick();
$image->newImage(200, 200, 'white');
$image->setImageFormat('png');

// 將繪製操作應用於影象
$image->drawImage($draw);

// 顯示影象
header('Content-Type: image/png');
echo $image;
?>

在上面的示例中，我們建立了一個新的ImagickDraw物件，並定義了一個名為"myClipPath"的剪下路徑。然後，在剪下路徑內繪製了一個矩形。最後，將繪製操作應用於影象並顯示影象。透過使用剪下路徑，只有位於矩形區域內的內容才會被繪製出來。