imagecolorallocate

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

    imagecolorallocate — Asigna un color para una imagen

    Descripción

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

    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.

    Estos parámetros son enteros entre 0 y 255 o hexadecimales entre 0x00 y 0xFF.

    Valores devueltos

    Un identificador de color o false si la asignación falló.

    Advertencia

    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ónDescripció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

    To Top