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

# imagecolorallocate

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

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

### Описание

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

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

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

> Замечание:

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

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

`image`
  Объект GdImage, который вернула функция imagecreatetruecolor() или другая функция генерации изображений.
`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