imagecolorallocate
(PHP 4, PHP 5, PHP 7)
imagecolorallocate — Asigna un color para una imagen
Descripción
$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().
Parámetros
-
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.
Valores devueltos
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.
Historial de cambios
| Versión | Descripción |
|---|---|
| 5.1.3 |
Devuelve FALSE si falló la asignación. Anteriormente
devolvía -1.
|
Ejemplos
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);
?>
Ver también
- imagecolorallocatealpha() - Asignar un color para una imagen
- imagecolordeallocate() - Desasignar un color de una imagen