imagecolorallocate

(PHP 4, PHP 5, PHP 7)

imagecolorallocate Создание цвета для изображения

Описание

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

Возвращает идентификатор цвета в соответствии с заданными RGB компонентами.

imagecolorallocate() должна вызываться для создания каждого цвета, который будет использоваться в изображении image.

Замечание:

Первый вызов imagecolorallocate() задает цвет фона в палитровых изображениях - изображениях, созданных функцией imagecreate().

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

image

Ресурс изображения, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().

red

Значение красного компонента цвета.

green

Значение зеленого компонента цвета.

blue

Значение синего компонента цвета.

Эти аргументы могут принимать либо целочисленные значение в диапазоне от 0 до 255, либо шестнадцатеричные в диапазоне от 0x00 до 0xFF.

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

Идентификатор цвета, либо FALSE в случае возникновения ошибки.

Внимание

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

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

Версия Описание
5.1.3 Возвращает FALSE в случае возникновения ошибки. В предыдущих версиях в этом случае возвращалось значение -1.

Примеры

Пример #1 Пример использования imagecolorallocate()

<?php

$im 
imagecreate(100100);

// делаем фон красным
$background imagecolorallocate($im25500);

// создадим несколько цветов
$white imagecolorallocate($im255255255);
$black imagecolorallocate($im000);

// шестнадцатеричный способ
$white imagecolorallocate($im0xFF0xFF0xFF);
$black imagecolorallocate($im0x000x000x00);

?>

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