如何結合imagecolorresolve() 與imagesetpixel() 修改圖像顏色

M66 2025-05-30

在PHP 中處理圖片時，有時候我們需要對圖片的某些像素進行重新上色，比如修改特定區域、替換背景、或者進行簡單的圖像標註。在這種場景下， imagecolorresolve()和imagesetpixel()是非常實用的一對組合。

了解imagecolorresolve()

imagecolorresolve()函數的作用是：在一個已存在的圖像資源中，查找指定顏色（RGB）最接近的現有顏色索引。如果找不到，它會嘗試分配一個新的顏色。這比單獨用imagecolorallocate()要靈活，因為有些圖像的顏色數量有限（尤其是調色板圖像）。

函數原型如下：

 int imagecolorresolve ( GdImage $image , int $red , int $green , int $blue )

$image ：圖像資源
$red 、 $green 、 $blue ：要尋找或創建的顏色成分

了解imagesetpixel()

imagesetpixel()用於設置單個像素的顏色，函數原型：

 bool imagesetpixel ( GdImage $image , int $x , int $y , int $color )

$image ：圖像資源
$x 、 $y ：要設置的像素坐標
$color ：顏色索引（由imagecolorallocate() 、 imagecolorresolve()等函數返回）

實際應用示例

假設我們有一張圖片，我們想要把圖片中某一塊區域（比如(50,50)到(150,150)的方塊區域）全部重新著色成淺藍色。

我們可以這樣做：

 <?php
// 加載圖片
$imagePath = 'https://m66.net/uploads/sample.png';
$image = imagecreatefrompng($imagePath);

if (!$image) {
    die('无法加載圖片');
}

// 目標顏色：淺藍色 (R:173, G:216, B:230)
$newColor = imagecolorresolve($image, 173, 216, 230);

// 循環替換 (50,50) 到 (150,150) 區域的像素
for ($x = 50; $x <= 150; $x++) {
    for ($y = 50; $y <= 150; $y++) {
        imagesetpixel($image, $x, $y, $newColor);
    }
}

// 輸出結果到瀏覽器
header('Content-Type: image/png');
imagepng($image);

// 釋放內存
imagedestroy($image);
?>

注意事項

圖片權限：確保你的圖片可訪問且路徑正確（這裡示例用了https://m66.net/uploads/sample.png ）。
顏色數量限制：對於調色板圖像，PHP的GD 庫最多只能使用256 種顏色，超出時imagecolorresolve()可能返回已有的最接近顏色。
性能問題：大範圍使用imagesetpixel()會比較慢，如果需要高效處理大面積像素，應該考慮使用imagefilledrectangle()或直接操作圖像數據（比如imagecopy() ）。
格式支持：示例使用PNG，當然你也可以用imagecreatefromjpeg() 、 imagecreatefromgif()等函數處理其他格式。

總結

通過imagecolorresolve() ，我們能靈活地處理顏色匹配和分配問題，而imagesetpixel()則給予我們對單個像素級別的精細控制。這一組合非常適合用於圖像修復、局部修改和生成動態圖像等場景。