PHP Manual
Prev |  | Next

# imagecolorallocate

(PHP 3, PHP 4 , PHP 5)

imagecolorallocate -- Allocate a color for an image

## Description

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

imagecolorallocate() returns a color identifier representing the color composed of the given RGB components. The `image` argument is the return from the imagecreate() function. `red`, `green` and `blue` are the values of the red, green and blue component of the requested color respectively. These parameters are integers between 0 and 255 or hexadecimals between 0x00 and 0xFF. imagecolorallocate() must be called to create each color that is to be used in the image represented by `image`.

> Note: The first call to imagecolorallocate() fills the background color.

`<?php // 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); ?>`

Returns -1 if the allocation failed.

See also imagecolorallocatealpha() and imagecolordeallocate().

Prev | Home | Next
imagecharup | Up | imagecolorallocatealpha