imagecolorallocate

說明

int imagecolorallocate ( resource image, int red, int green, int blue )

imagecolorallocate() 返回一個標識符，代表了由給定的 RGB 成分組成的彩色。image 參數是 imagecreatetruecolor() 函數的返回值。red，green 和 blue 分別是所需要的彩色的紅，綠，藍成分。這些參數是 0 到 255 的整數或是十六進位的 0x00 到 0xFF。imagecolorallocate() 必須被呼叫以建立每一種用在 image 所代表的圖像中的彩色。

注: 第一次對 imagecolorallocate() 的呼叫會填充背景色。


<?php
$im = imagecreatetruecolor('example.jpg');
// 背景設為紅色
$background = imagecolorallocate($im, 255, 0, 0);
// 設定一些彩色
$white = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);
// 十六進位模式
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
$black = imagecolorallocate($im, 0x00, 0x00, 0x00);
?>

若果配置失敗則返回 -1。

參見 imagecolorallocatealpha() 和 imagecolordeallocate()。