(PHP 4, PHP 5)
imagecolorallocate — Asigna un color para una imagen
$image
, int $red
, int $green
, int $blue
)Devuelve un identificador de color representando el color compuesto por los componentes RGB dados.
imagecolorallocate() debe ser llamada
para crear cada color que va a ser usado en la imagen representada
por image
.
Nota:
La primera llamada a imagecolorallocate() rellena el color de fondo en imágenes basadas en paleta de colores - imágenes creadas usando imagecreate().
image
Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().
red
Valor del componente rojo.
green
Valor del componente verde.
blue
Valor del componente azul.
Un identificador de color o FALSE
si la asignación falló.
Esta función puede
devolver el valor booleano FALSE
, pero también puede devolver un valor no booleano que se
evalúa como FALSE
. Por favor lea la sección sobre Booleanos para más información. Use
el operador === para comprobar el valor devuelto por esta
función.
Versión | Descripción |
---|---|
5.1.3 |
Devuelve FALSE si falló la asignación. Anteriormente
devolvía -1.
|
Ejemplo #1 Ejemplo de imagecolorallocate()
<?php
$im = imagecreate(100, 100);
// establece el fondo a rojo
$fondo = imagecolorallocate($im, 255, 0, 0);
// establece más colores
$blanco = imagecolorallocate($im, 255, 255, 255);
$negro = imagecolorallocate($im, 0, 0, 0);
// forma hexadecimal
$blanco = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
$negro = imagecolorallocate($im, 0x00, 0x00, 0x00);
?>