imagecolorallocate

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

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

    Описание

    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);

    ?>

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

    To Top