# imagecolorallocate

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

imagecolorallocate — 为图像分配颜色

### 说明

imagecolorallocate(
GdImage `$image`,
int `$red`,
int `$green`,
int `$blue`
): int|false

返回颜色标识符，表示由指定 RGB 成分组成的颜色。

必须调用 imagecolorallocate() 创建要在 `image` 表示的图像中使用的每种颜色。

> 注意:

> 第一次调用 imagecolorallocate() 会对基于调色板的图像填充背景色——使用 imagecreate() 建立的图像。

### 参数

`image`

  由图象创建函数(例如imagecreatetruecolor())返回的 GdImage 对象。

`red`

  红色成分的值。

`green`

  绿色成分的值。

`blue`

  蓝色成分的值。

这些参数是 0 到 255 之间的整数或者 0x00 到 0xFF 之间的十六进制数字。

### 返回值

颜色标识符，如果分配失败，则为 `false`。

警告

此函数可能返回布尔值 `false`，但也可能返回等同于 `false` 的非布尔值。请阅读 布尔类型章节以获取更多信息。应使用 === 运算符来测试此函数的返回值。

### 更新日志

版本 | 说明
--- | ---
8.0.0 | `image` 现在需要 GdImage 实例；之前需要有效的 `gd` resource。

### 示例

示例 #1 imagecolorallocate() 示例

`<?php
$im = imagecreate(100, 100);
// 设置背景为红色
$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);
?>`

### 参见

- imagecolorallocatealpha() - 为图像分配颜色
- imagecolordeallocate() - 取消图像颜色的分配

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open