Allocate a color for an image - Справочник: PHP5.4

Описание

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: Ресурс изображения, полученный одной из функций создания изображений, например, такой как imagecreatetruecolor().
red: Значение красного компонента цвета.
green: Значение зеленого компонента цвета.
blue: Значение синего компонента цвета.

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

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

A color identifier or FALSE if the allocation failed.

Внимание

Эта функция может возвращать как boolean FALSE, так и не-boolean значение, которое приводится к FALSE. За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

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

Версия	Описание
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() - Allocate a color for an image
imagecolordeallocate() - De-allocate a color for an image