PHP: imagecolorallocate

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.

Notatka: 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.

User Contributed Notes


This works! A Black-Image with vertical centered white Aliased Arial-Text and same left and right margin - used for Menu-Buttons.



<?php



  function createImgText ($string="", $fontsize=0, $marginX=0, $imgH=0 , $fontfile="", $imgColorHex="", $txtColorHex=""){

    if($string!=""){

        Header("Content-type: image/png");     

        //

        $spacing = 0;

          $line = array("linespacing" => $spacing);

        $box = @imageftbbox($fontsize,0,$fontfile,$string,$line)

        or die("ERROR");

        $tw=$box[4]-$box[0]; //image width

        $marginY = $imgH - (($imgH - $fontsize) / 2);

        $imgWidth = $tw + (2*$marginX);

        $im = ImageCreate($imgWidth, $imgH); 

        $int = hexdec($imgColorHex);

        $arr = array("red" => 0xFF & ($int >> 0x10),

               "green" => 0xFF & ($int >> 0x8),

               "blue" => 0xFF & $int);

        $black = ImageColorAllocate($im, $arr["red"], $arr["green"], $arr["blue"]); 

        $int = hexdec($txtColorHex);

        $arr = array("red" => 0xFF & ($int >> 0x10),

               "green" => 0xFF & ($int >> 0x8),

               "blue" => 0xFF & $int);

        $white = ImageColorAllocate($im, $arr["red"], $arr["green"], $arr["blue"]); 

        ImageFtText($im, $fontsize, 0, $marginX, $marginY, $white, $fontfile, $string, array()); 

        ImagePng($im); 

        ImageDestroy($im);

    }else{

        echo "ERROR!";

    }

}

createImgText ("Hello World", 9, 10, 18, "arial.ttf", "000000", "FFFFFF");

?>


Another more general variation on the theme using the same naming conventions as the hexdec and dechex built-in functions ...



Prototype:



array hexrgb ( string hex_string )



Returns:



An associative array of the RGB components specified in hex_string.



hexrgb() example:



<?php

$rgb = hexrgb("0xAABBCC");

print_r($rgb);

?>



Output is:



Array

(

  [red] => 170

  [green] => 187

  [blue] => 204

)



Implementation:



<?php

function hexrgb ($hexstr)

{

  $int = hexdec($hexstr);



  return array("red" => 0xFF & ($int >> 0x10),

               "green" => 0xFF & ($int >> 0x8),

               "blue" => 0xFF & $int);

}

?>



The output of hexdec can then be passed to imagecolorallocate and manipulated as required.


improvement upon fromhex function by avi at amarcus dot com



<?php

   

   function fromhex($string,&$image) {

      sscanf($string, "%2x%2x%2x", $red, $green, $blue);

      return ImageColorAllocate($image,$red,$green,$blue);

   }

   

   //Example for calling a hex color:

   ImageFill($image, 0, 0, fromhex('FFFFFF'));



?>


Here's a very simple and very effective code to change a HEX color to RGB.



-------------------------



function HEX2RGB($color){

 $color_array = array();

 $hex_color = strtoupper($color);

 for($i = 0; $i < 6; $i++){

  $hex = substr($hex_color,$i,1);

  switch($hex){

   case "A": $num = 10; break;

   case "B": $num = 11; break;

   case "C": $num = 12; break;

   case "D": $num = 13; break;

   case "E": $num = 14; break;

   case "F": $num = 15; break;

   default: $num = $hex; break;

  }

  array_push($color_array,$num);

 }

 $R = (($color_array[0] * 16) + $color_array[1]);

 $G = (($color_array[2] * 16) + $color_array[3]);

 $B = (($color_array[4] * 16) + $color_array[5]);

 return array($R,$G,$B);

 unset($color_array,$hex,$R,$G,$B);

}



-------------------------


This nifty function will produce the negative of a given image!



<?php



/********************************



     Code by Kailash Nadh

     http://kailashnadh.name



     usage:

     img2neg("my_pic.jpg");



*********************************/



function img2neg($pic) {



    header("Content-type: image/jpeg");



    $source=imagecreatefromjpeg($pic);    // Source

    $width=imagesx($source);    $height=imagesy($source);



    $im = imagecreatetruecolor($width, $height);    // Our negative img in the making



    for($y=0; $y < $height; $y++) {

        for($x=0; $x < $width; $x++) {



        $colors=imagecolorsforindex($source, imagecolorat($source, $x,$y));



            // this is what makes the colors negative

            $r=255-$colors['red'];

            $g=255-$colors['green'];

            $b=255-$colors['blue'];

            $test=imagecolorallocate($im, $r,$g,$b);

            imagesetpixel($im,$x, $y, $test);

        }

    }



    imagejpeg($im);

    imagedestroy($im);

}



?>


hsl to RGB

(not yet optimized but it function)



function hslToRgb ($h, $s, $l) {

    if ($h>240 || $h<0) return array(0,0,0);

    if ($s>240 || $s<0) return array(0,0,0);

    if ($l>240 || $l<0) return array(0,0,0);     

    if ($h<=40) {

        $R=255;

        $G=(int)($h/40*256);

        $B=0;

    }

    elseif ($h>40 && $h<=80) {

        $R=(1-($h-40)/40)*256;

        $G=255;

        $B=0;

    }

    elseif ($h>80 && $h<=120) {

        $R=0;

        $G=255;

        $B=($h-80)/40*256;

    }

    elseif ($h>120 && $h<=160) {

        $R=0;

        $G=(1-($h-120)/40)*256;

        $B=255;

    }

    elseif ($h>160 && $h<=200) {

        $R=($h-160)/40*256;

        $G=0;

        $B=255;

    }

    elseif ($h>200) {

        $R=255;

        $G=0;

        $B=(1-($h-200)/40)*256;

    }

    $R=$R+(240-$s)/240*(128-$R);

    $G=$G+(240-$s)/240*(128-$G);

    $B=$B+(240-$s)/240*(128-$B);

    if ($l<120) {

        $R=($R/120)*$l;

        $G=($G/120)*$l;

        $B=($B/120)*$l;

    }

    else {

        $R=$l*((256-$R)/120)+2*$R-256;

        $G=$l*((256-$G)/120)+2*$G-256;

        $B=$l*((256-$B)/120)+2*$B-256;

    }

    if ($R<0) $R=0;

    if ($R>255) $R=255;

    if ($G<0) $G=0;

    if ($G>255) $G=255;

    if ($B<0) $B=0;

    if ($B>255) $B=255;

    

    return array((int)$R,(int)$G,(int)$B);

}


<?



/**

 * Create a image bar using lib GD

 * Ege. <img src="color_sample.php?color=FF0000" width="10 height="30">

 */



// Split the HTML color representation

$hexcolor = str_split($_GET["color"], 2); 



// Convert HEX values to DECIMAL

$bincolor[0] = hexdec("0x{$hexcolor[0]}");

$bincolor[1] = hexdec("0x{$hexcolor[1]}");

$bincolor[2] = hexdec("0x{$hexcolor[2]}");



$im = ImageCreate(100, 100);

$colorallocate = ImageColorAllocate($im, $bincolor[0], $bincolor[1], $bincolor[2]);

ImageFilledRectangle($im, 0, 0, 100, 100, $colorallocate);

header('Content-Type: image/png');

ImagePNG($im);



?>


When you are using truecolor images, you can also use bitwise operations to generate the color:

<?php

$color = ($r << 16) | ($g << 8) | $b; // 2261213

?>

This is identical to the imagecolorallocate() function, in truecolor images!


This will let you tint an image to any specific color. The blacks of the source image become your specified color, and the whites remain white. Works best for colorizing greyscale images. 



<?php



$r = 224;

$g = 192;

$b = 0;

$source_file = "picture.jpg";



$im_src = ImageCreateFromJpeg($source_file);

$im_tint = ImageCreate(imagesx($im_src),imagesy($im_src));

for ($c = 0; $c < 255; $c++) {

     ImageColorAllocate($im_tint, max($r,$c), max($g,$c), max($b,$c));

}

ImageCopyMerge($im_tint,$im_src,0,0,0,0, imagesx($im_src), imagesy($im_src), 100);

ImageDestroy($im_src);



header("Content-type: image/jpeg");

imagejpeg($im_tint);



?>


Here is an easier way to set the color without use imagecolorallocate();



<?php



$image = imagecreatetruecolor();



imagefill($image, 0, 0, 0xFFFFFF); // white color (#FFFFFF)



?>



Use hexadecimal values just like you do in HTML codes:



0xFF0000 = red

0x00FF00 = green

0x0000FF = blue

0xFFFF00 = yellow



... and so on



Hope this will help many people...



Carlos Reche


2 functions to convert from HSV colorspace (hue/saturation/brightness) to RGB (red/green/blue) colorspace and back. 

<?php

// $c = array($red, $green, $blue)

// $red=[0..1], $green=[0..1], $blue=[0..1];

function rgb2hsv($c) {

 list($r,$g,$b)=$c;

 $v=max($r,$g,$b);

 $t=min($r,$g,$b);

 $s=($v==0)?0:($v-$t)/$v;

 if ($s==0)

  $h=-1;

 else {

  $a=$v-$t;

  $cr=($v-$r)/$a;

  $cg=($v-$g)/$a;

  $cb=($v-$b)/$a;

  $h=($r==$v)?$cb-$cg:(($g==$v)?2+$cr-$cb:(($b==$v)?$h=4+$cg-$cr:0));

  $h=60*$h;

  $h=($h<0)?$h+360:$h;

 }

 return array($h,$s,$v);

}



// $c = array($hue, $saturation, $brightness)

// $hue=[0..360], $saturation=[0..1], $brightness=[0..1]

function hsv2rgb($c) {

 list($h,$s,$v)=$c;

 if ($s==0)

  return array($v,$v,$v);

 else {

  $h=($h%=360)/60;

  $i=floor($h);

  $f=$h-$i;

  $q[0]=$q[1]=$v*(1-$s);

  $q[2]=$v*(1-$s*(1-$f));

  $q[3]=$q[4]=$v;

  $q[5]=$v*(1-$s*$f);

  return(array($q[($i+4)%5],$q[($i+2)%5],$q[$i%5]));

 }

}

?>


quote from "tim at phantomrpg dot com"



Here is a simpler way of using a hex color with ImageColorAllocate().

sscanf("FFFF00", "%2x%2x%2x", $red, $green, $blue);

$stringColor=ImageColorAllocate($image,$red,$green,$blue);



I made it into a simple function:

<?php

function fromhex($string){

    GLOBAL $image;

    sscanf($string, "%2x%2x%2x", $red, $green, $blue);

    return ImageColorAllocate($image,$red,$green,$blue);

    }

//Example for calling a hex color:

ImageFill($image, 0, 0, fromhex('FFFFFF'));

?>


Some of you maybe want to use HSV color model for drawing color selectors and circles:



<?

  function &colormap_hsv_to_rgb($h, $s, $v)

  {

    $ret = new stdClass();



    if($s == 0)

    {

      $ret->r = $v;

      $ret->g = $v;

      $ret->b = $v;



      return $ret;

    }

    else

    {

      $h = floatval($h) / 255.0;

      $s = floatval($s) / 255.0;

      $v = floatval($v) / 255.0;



      $hue = $h;



      if($hue == 1.0)

        $hue = 0.0;



      $hue *= 6.0;



      $i = intval($hue);

      $f = $hue - floatval($i);

      $w = $v * (1.0 - $s);

      $q = $v * (1.0 - ($s * $f));

      $t = $v * (1.0 - ($s * (1.0 - $f)));



      switch($i)

      {

         case 0: $ret->r = $v; $ret->g = $t; $ret->b = $w; break;

         case 1: $ret->r = $q; $ret->g = $v; $ret->b = $w; break;

         case 2: $ret->r = $w; $ret->g = $v; $ret->b = $t; break;

         case 3: $ret->r = $w; $ret->g = $q; $ret->b = $v; break;

         case 4: $ret->r = $t; $ret->g = $w; $ret->b = $v; break;

         case 5: $ret->r = $v; $ret->g = $w; $ret->b = $q; break;

      }

    }

    

    $ret->r = intval($ret->r * 255.0);

    $ret->g = intval($ret->g * 255.0);

    $ret->b = intval($ret->b * 255.0);



    return $ret;

  }

?>


this might help someone, how to allocate an color from an html color-definition:



$fg = "#ff0080";



$red = 100;

$green = 100;

$blue = 100;

if( eregi( "[#]?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})", $fg, $ret ) )

{

    $red = hexdec( $ret[1] );

    $green = hexdec( $ret[2] );

    $blue = hexdec( $ret[3] );

}



$text_color = ImageColorAllocate( $img1, $red, $green, $blue );


<?php



/*

An example combining the use of ImageColorAllocate, Imagesetpixel, Imagecopyresized and some basic Trig

*/



Header("Content-type: image/png");



$height = 128;

$width = 128;



$imA = ImageCreate($width, $height);

$imB = ImageCreate($width*4, $height*4);

$bckA = ImageColorAllocate($imA, 0,0,0);

$bckB = ImageColorAllocate($imB, 0,0,0);



//GENERATE GRAY SCALE PALLETE



for($c=0;$c<256;$c++){

                ImageColorAllocate($imA, $c, $c, $c);

                }



//PRODUCE DATA



$m=rand(0,10);

for($c=0;$c<128;$c++){

                $s=  (sin( deg2rad($c*360*$m/128) )+1)*127;

                $col_arr[$c]=$s;

                }

for($y=0;$y<$height;$y++){

        for($x=0;$x<$width;$x++){

                $imgA[$x][$y]=$col_arr[$x];

                }

        }

for($y=0;$y<$height;$y++){

        for($x=0;$x<$width;$x++){

                $imgB[$x][$y]=$col_arr[$y];

                }

        }



//SET PIXELS



for($y=0;$y<$height;$y++){

        for($x=0;$x<$width;$x++){

                $imgC[$x][$y]=$imgA[$x][$y]+$imgB[$x][$y];

                $s=$imgC[$x][$y]/2;

                Imagesetpixel($imA,$x,$y,$s);

                }

        }



//RESIZE IMAGE FOR DISPLAY



Imagecopyresized ($imB, $imA, 0, 0, 0, 0, $width*4, $height*4, $width, $width);

ImagePNG($imB);

?>


Doiveo's suggestion for getting the font colors to behave with JPEG's does (at least for PHP 4.1.2 - GD version 1) stop the problem (that I had) with fonts becoming outlined instead of solid, however the font colors were still incorrect.



There is however a much simpler (and faster) solution, just use imageColorClosest instead of imageColorAllocate, e.g:



$near_white = imageColorClosest($img, 255,255,255);

imageTTFtext($img, 10, 0, 20, 20, $near_white, "font file path", "text to add to JPEG");



For most JPEG's there should be a fairly close matching color to the one you want to use.


I was unable to get any of the posted methods for converting colour to grayscale to work.  The problem appears to be the way gd creates images from jpeg inconsistently over various versions.  Eventually I wrote my own that works for me - this approach allocates the 256 color pallete first.  You can also play with separate $r, $g, $b variables before using imagecolorallocate in order to tone or tint the image.





<?php


$resource = 'whatever.jpg';


$im_size = GetImageSize($resource);


$imageWidth = $im_size[0];


$imageHeight = $im_size[1];


$im = imageCreate($imageWidth,$imageHeight);


for ($c = 0; $c < 256; $c++) {     


     ImageColorAllocate($im, $c,$c,$c);


}


$im2 = ImageCreateFromJpeg($resource);


ImageCopyMerge($im,$im2,0,0,0,0, $imageWidth, $imageHeight, 100);


ImageDestroy($im2);


?>





go on using $im as your image, it is now grayscale ....