Gmagick::charcoalimage()函式—用法及示例

函式名：Gmagick::charcoalimage()

適用版本：PHP 5 >= 5.3.0, PECL gmagick >= 1.0.0

用法：Gmagick::charcoalimage() 方法用於將影象轉換成炭筆畫效果。它可以模擬出具有粗糙紋理和粗糙輪廓的效果。

語法：bool Gmagick::charcoalimage(float $radius, float $sigma)

引數：

• $radius: 炭筆畫效果的半徑。較大的值會產生更大的粗糙紋理。預設值為1.0。
• $sigma: 控制炭筆畫紋理的標準差。預設值為0.5。

返回值：如果成功則返回 true，否則返回 false。

示例：

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

// 讀取影象檔案
$image->readImage('input.jpg');

// 應用炭筆畫效果
$image->charcoalimage(1.0, 0.5);

// 儲存處理後的影象
$image->writeImage('output.jpg');

// 輸出影象
header('Content-type: image/jpeg');
echo $image;
?>

上述示例程式碼首先建立了一個 Gmagick 物件，並使用 readImage() 方法讀取了一個名為 input.jpg 的影象檔案。然後，透過呼叫 charcoalimage() 方法，並傳入半徑為 1.0，標準差為 0.5 的引數，將影象轉換為炭筆畫效果。最後，使用 writeImage() 方法將處理後的影象儲存為 output.jpg 檔案，並透過 header() 函式設定響應頭，將影象輸出到瀏覽器。

請注意，在使用 Gmagick 擴充套件之前，需要先安裝 Gmagick 擴充套件並啟用 PHP。