imagecolorallocate

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecolorallocate — 為一幅圖像分配顏色

說明

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

imagecolorallocate() 返回一個(gè)標(biāo)識符，代表了由給定的 RGB 成分組成的顏色。red，green 和 blue 分別是所需要的顏色的紅，綠，藍(lán)成分。這些參數(shù)是 0 到 255 的整數(shù)或者十六進(jìn)制的 0x00 到 0xFF。imagecolorallocate() 必須被調(diào)用以創(chuàng)建每一種用在 image 所代表的圖像中的顏色。

注意:
第一次對 imagecolorallocate() 的調(diào)用會給基于調(diào)色板的圖像填充背景色，即用 imagecreate() 建立的圖像。

示例 #1 imagecolorallocate() 例子


<?php
$im = imagecreate('example.jpg', 100, 100);
// 背景設(shè)為紅色
$background = imagecolorallocate($im, 255, 0, 0);
// 設(shè)定一些顏色
$white = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);
// 十六進(jìn)制方式
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
$black = imagecolorallocate($im, 0x00, 0x00, 0x00);
?>

如果分配失敗則返回 -1。

參見 imagecolorallocatealpha() 和 imagecolordeallocate()。