Руководство по PHP
Пред. |  | След.

# imagecolorallocate

(PHP 3, PHP 4, PHP 5)

imagecolorallocate -- Allocate a color for an image

## Описание

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

Returns a color identifier representing the color composed of the given RGB components.

imagecolorallocate() must be called to create each color that is to be used in the image represented by `image`.

> Замечание: The first call to imagecolorallocate() fills the background color in palette-based images - images created using imagecreate().

## Список параметров

`image`

  An image resource, returned by one of the image creation functions, such as imagecreatetruecolor().

`red`

  Value of red component

`green`

  Value of green component

`blue`

  Value of blue component

These parameters are integers between 0 and 255 or hexadecimals between 0x00 and 0xFF.

## Возвращаемые значения

A color identifier or `FALSE` if the allocation failed.

## Список изменений

Версия | Описание
--- | ---
Prior to 5.1.3 | Returns -1 if the allocation failed.

## Примеры

Пример 1. imagecolorallocate() example

`<?php $im = imagecreate(100, 100); // sets background to red $background = imagecolorallocate($im, 255, 0, 0); // sets some colors $white = imagecolorallocate($im, 255, 255, 255); $black = imagecolorallocate($im, 0, 0, 0); // hexadecimal way $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF); $black = imagecolorallocate($im, 0x00, 0x00, 0x00); ?>`

## Смотрите также

imagecolorallocatealpha()
imagecolordeallocate()

Пред. | Начало | След.
imagecharup | Уровень выше | imagecolorallocatealpha