imagecolorallocate

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

imagecolorallocateAllocate a color for an image

Опис

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

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

Об'єкт GdImage, що повертається однією з функцій створення зображення, такою як 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.

Увага

Ця функція може повертати як логічне false, так і не логічне значення, яке прирівнюється до false. Докладніше про це описано в розділі Логічні типи даних. Для перевірки значення, яке повертає ця функція, використовується оператор ===.

Журнал змін

Версія Опис
8.0.0 Тепер image має бути примірником GdImage. Раніше очікувався gd-resource.

Приклади

Приклад #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);

?>

Прогляньте також