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. За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

Примеры

Пример #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() - Разрыв ассоциации переменной с цветом для заданного изображения