Delicious Bookmark this on Delicious Share on Facebook SlashdotSlashdot It! Digg! Digg



PHP : Function Reference : Image Functions : imagecreatetruecolor

imagecreatetruecolor

Create a new true color image (PHP 4 >= 4.0.6, PHP 5)
resource imagecreatetruecolor ( int width, int height )

imagecreatetruecolor() returns an image identifier representing a black image of the specified size.

Depending on your PHP and GD versions this function is defined or not. With PHP 4.0.6 through 4.1.x this function always exists if the GD module is loaded, but calling it without GD2 being installed PHP will issue a fatal error and exit. With PHP 4.2.x this behaviour is different in issuing a warning instead of an error. Other versions only define this function, if the correct GD version is installed.

Parameters

width

Image width

height

Image height

Return Values

Returns an image resource identifier on success, FALSE on errors.

Examples

Example 1005.  Creating a new GD image stream and outputting an image.

<?php
header
("Content-type: image/png");
$im = @imagecreatetruecolor(120, 20)
     or die(
"Cannot Initialize new GD image stream");
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);
imagepng($im);
imagedestroy($im);
?>

The above example will output something similar to:


Notes

Note:

This function requires GD 2.0.1 or later (2.0.28 or later is recommended).

Note:

This function will not work with GIF file formats.

Related Examples ( Source code ) » imagecreatetruecolor


Code Examples / Notes » imagecreatetruecolor

php

Why not just use function_exists?  
http://www.php.net/function_exists
Just because they have version 2.0 GD doesn't mean that they haven't disabled that function.
Also instead of determining which one you have on your machine and then writing setup specific code, you can write a universal code usable on either setups.
::pseudo code::
if (function_exists(imagecreatetruecolor)){
use imagecreatetruecolor()
}else{
use imagecreate()
}


kai

using imagecolorallocate to specify the image's background color does not work with truecolor-image.
instead you have to use imagefill to force flood-filling the image with the backgorund-color previously allocated:
$bgColor = imagecolorallocate($img, 255,255,255);
imagefill($img , 0,0 , $bgColor);
kai


justin greer

Unfortunately the @imagecreatetruecolor() method doesn't even work because php dies with a fatal error noting that GD 2 is required.  You can't even capture this error with a custom error handler.
I have come up with a function to get the GD version number that seems to work pretty well on every version of PHP and GD I've thrown at it (even CLI versions.)  It's obviously not the most efficient thing in the world, but it does cache the result in a static variable so calling it multiple times doesn't slow down further.
function gd_version() {
static $gd_version_number = null;
if ($gd_version_number === null) {
// Use output buffering to get results from phpinfo()
// without disturbing the page we're in.  Output
// buffering is "stackable" so we don't even have to
// worry about previous or encompassing buffering.
ob_start();
phpinfo(8);
$module_info = ob_get_contents();
ob_end_clean();
if (preg_match("/\bgd\s+version\b[^\d\n\r]+?([\d\.]+)/i",
$module_info,$matches)) {
$gd_version_number = $matches[1];
} else {
$gd_version_number = 0;
}
}
return $gd_version_number;
}
Then you can simply use it something like this:
if (gd_version() >= 2) {
$image = ImageCreateTrueColor($width, $height);
} else {
$image = ImageCreate($width, $height);
}


eric

This little function does it for you:
<?
$image_id = imageCreateFromJPEG($image);
for($a=0;$a<imagecolorstotal ($image_id);$a++)
{
$color = ImageColorsForIndex($image_id,$i);
$R=.299 * ($color['red'])+ .587 * ($color['green'])+ .114 * ($color['blue']);
$G=.299 * ($color['red'])+ .587 * ($color['green'])+ .114 * ($color['blue']);
$B=.299 * ($color['red'])+ .587 * ($color['green'])+ .114 * ($color['blue']);
ImageColorSet($image_id, $a, $R, $G, $B);
}
imageJPEG($image_id,"$image");
?>
The .299 , .578 , .114 values are estimations, and add a gamma correction to the colors. For more or less luminace in the result, you can change these values.
Goodluck,
Eric Mulders, Netherlands


thomas dot urban

This is another approach to get an initially transparent truecolor canvas and in comparison to the one below it does not declare black to be transparent (which might be okay on indexed-color images and unless you want to draw in black) ...
$im = imagecreatetruecolor( $w, $h );
imagealphablending( $im, false );
$col = imagecolorallocate( $im, 0, 0, 0, 127 );
imagefilledrectangle( $im, 0, 0, $w, $h, $col );
imagealphablending( $im, true );
Without disabling blending mode this would paint transparent rectangle over current background thus not changing anything. Nevertheless blending mode is required e.g. to get proper results from using imagettftext ... that's why it is enabled after filling, again.
Don't miss to disable blending mode and enable savealpha prior to generating a PNG ...
imagealphablending( $im, false );
imagesavealpha( $im, true );
imagepng( $im );


andreas from www.ems-p.de

The request of gdlib from brad at brwebdesign dot com won't work with PHP < 4.1 (version_compare).
Some phpinfo versions offer the version number without space so you better ask for the dot:
ob_start();
phpinfo(8);
$phpinfo=ob_get_contents();
ob_end_clean();
$phpinfo=strip_tags($phpinfo);
$phpinfo=stristr($phpinfo,"gd version");
$phpinfo=stristr($phpinfo,"version");
$end=strpos($phpinfo,".");
$phpinfo=substr($phpinfo,0,$end);
$length = strlen($phpinfo)-1;
$phpinfo=substr($phpinfo,$length);
if($phpinfo<2){
$dst_img=ImageCreate($new_w,$new_h);}
else {
$dst_img=ImageCreateTrueColor($new_w,$new_h);
}


send

Thanks to OverFlow636 at gmail dot com and kuya1284 at techie dot com for their original coding which this function is based upon.
PHP lacks an imagecreatefromtga function, so I have prepared a simple function to include in your library if you deal with TGA images. In addition to creating an image from TGA, it also, optionally, will output an array with the dimensions of the image because getimagesize() does not function with TGA files.
Hopefully this function will eventually be unneeded if GD is ever updated to support the TGA format.
Please keep in mind that TGA's come in many different compressions, color settings, and as a result this function will not work 100% of the time. Resulting images will fit the symptoms kuya1284 at techie dot com mentioned, and as a result you may need to create a second function. Keep in mind that using her code causes the "mirror" effect on images that load properly with the following function.
<?php
function imagecreatefromtga ( $filename, $return_array = 0 )
{
$handle = fopen ( $filename, 'rb' );
$data = fread ( $handle, filesize( $filename ) );
fclose ( $handle );

$pointer = 18;
$x = 0;
$y = 0;
$w = base_convert ( bin2hex ( strrev ( substr ( $data, 12, 2 ) ) ), 16, 10 );
$h = base_convert ( bin2hex ( strrev ( substr ( $data, 14, 2 ) ) ), 16, 10 );
$img = imagecreatetruecolor( $w, $h );
while ( $pointer < strlen ( $data ) )
{
imagesetpixel ( $img, $x, $y, base_convert ( bin2hex ( strrev ( substr ( $data, $pointer, 3 ) ) ), 16, 10 ) );
$x++;
if ($x == $w)
{
$y++;
$x=0;
}
$pointer += 3;
}

if ( $return_array )
return array ( $img, $w, $h );
else
return $img;
}
?>
Example Usage
<?php
// Get the image & its dimensions
$array = imagecreatefromtga("source_image.tga",1);
// the image ( resource image )
$image = $array[0];
// its dimensions ( integers )
$dimensions['width'] = $array[1];
$dimensions['height'] = $array[2];
// Delete the image resource array entry to free memory
imagedestroy($array[0]);
?>
The second variable, $return_array is optional. If you simply want to load a TGA, leave the variable off the function's call as such:
<?
// Return the resource image alone
$resource_image = imagecreatefromtga ( "source_image.tga" );
// Declare the content-type as a JPEG image.
header ( 'Content-type: image/jpeg' );
// Convert the image to JPEG for smaller file size and compatability
imagejpeg ( $resource_image, NULL, 100 );
imagedestroy ( $resource_image );
?>


hallvord rm steen
Regarding choosing the TrueColor or the plain version of imagecreate automatically, I've found that the following works for me:
<?php
$newImg=@ImageCreateTrueColor($width, $height)
   or $newImg=ImageCreate($width, $height);
?>


kuya1284

OverFlow636,
It appears that your code was causing TGA's to be inverted horizontally and upside down.  I modified your code accordingly. The sample below is an example of what I did to convert a tga to jpg. The for loop was taken from the comment below (Eric Mulders) to properly render the image.
Nice job with the code buddy.
function tga2jpg ($image)
{
   $handle = fopen($image, "rb");
   $data = fread($handle, filesize($image));
   fclose($handle);
   $pointer = 18;
   $w = fileint (substr ($data, 12, 2));
   $h = fileint (substr ($data, 14, 2));
   $x = 0;
   $y = $h;
   $img = imagecreatetruecolor($w, $h);
   while ($pointer < strlen($data))
   {
       imagesetpixel ($img, $x, $y, fileint (substr ($data, $pointer, 3)));

       $x++;
       if ($x == $w)
       {
           $y--;
           $x = 0;
       }
       $pointer += 3;
   }

   for($a = 0; $a < imagecolorstotal ($img); $a++)
   {
       $color = imagecolorsforindex ($img, $a);
 
       $R=.299 * ($color['red'])+ .587 * ($color['green'])+ .114 * ($color['blue']);
       $G=.299 * ($color['red'])+ .587 * ($color['green'])+ .114 * ($color['blue']);
       $B=.299 * ($color['red'])+ .587 * ($color['green'])+ .114 * ($color['blue']);
         
       imagecolorset ($img, $a, $R, $G, $B);
   }
   
   imagejpeg ($img, 'test.jpg', 100);
   imagedestroy ($img);
}
function fileint($str)
{
   return base_convert (bin2hex (strrev ($str)), 16, 10);
}
tga2jpg ('test.tga');


d dot duquenoy

My function to know how much bytes imagecreate or imagecreatetruecolor require before using it.
<?php
function getNeededMemoryForImageCreate($width, $height, $truecolor) {
 return $width*$height*(2.2+($truecolor*3));
}
?>


termian

kai wrote:
//using imagecolorallocate to specify the image's background
//color does not work with truecolor-image.
//
//instead you have to use imagefill to force flood-filling the
//image with the backgorund-color previously allocated:
//
//$bgColor = imagecolorallocate($img, 255,255,255);
//imagefill($img , 0,0 , $bgColor);
even this doesn't work for my configuration - fedora core2, php 4.3.8 + gd bundled (2.0.23 compatible) and I have to do this:
$img = imagecreatetruecolor($x, $y);
$bgColor = imagecolorallocate($img, 255,255,255);
imagefilledrectangle($img, 0, 0, $x-1, $y-1, $bgColor);


phpnet

Just a small rectification for the msg by '
thomas dot urban at toxa dot de' (23-May-2006 03:28) about transparency.
Line 3 in the example returns a 'wrong parameter warning': 'imagecolorallocate' should be replaced by 'imagecolorallocatealpha'.
(You better just alter that note and delete this one.)


jami

It's good to use the imagecopyresampled- function when creating thumbnails with true colors, it might look better than imagecopyresized..

behun

imagecreatetruecolor() returns not only image identifier representing a black image of size x_size by y_size.
imagecreatetruecolor() is called to create truecolor images, with an essentially unlimited number of colors (also not only 256 colors).


steve

ImageCreateTrueColor is used to create an image resource with an unlimited number of colors, which is useful when manipulating JPEG images, for example.
ImageCreate is used to create an image resource with a 256 color palette, sometimes called indexed color.
In previous versions, ImageCreate worked OK for manipulating JPEG images. But in experimenting with the Win32 version of PHP 4.0.6, which I think relies on the GD 2.0.1 lib beta, you have to use ImageCreateTrueColor to get accurate color results with JPEGs.


unigram

If your hosting system does not have imagecreatetruecolor() because of PHP<4.2 and GD<2.0 then a get around is
<?
$thumb = imagecreate ($width, $height);
imageJPEG($thumb,"images/temp.jpg");
$thumb = @imagecreatefromjpeg("images/temp.jpg");
?>
which creates a thumbnail of right size, saves as a jpeg and then reads it, in true color.
This corrected the degradation caused by using palette images as destination for imagecopyresized ()


richard davey rich

If you want to create a *transparent* PNG image, where the background is fully transparent, and all draw operations happen on-top of this, then do the following:
<?php
   $png = imagecreatetruecolor(800, 600);
   imagesavealpha($png, true);
   $trans_colour = imagecolorallocatealpha($png, 0, 0, 0, 127);
   imagefill($png, 0, 0, $trans_colour);
   
   $red = imagecolorallocate($png, 255, 0, 0);
   imagefilledellipse($png, 400, 300, 400, 300, $red);
   
   header("Content-type: image/png");
   imagepng($png);
?>
What you do is create a true colour image, make sure that the alpha save-state is on, then fill the image with a colour that has had its alpha level set to fully transparent (127).
The resulting PNG from the code above will have a red circle on a fully transparent background (drag the image into Photoshop to see for yourself)


send

If you want a simple way to mirror images, use the function I've included below.
<?php
function image_mirror ($input_image_resource)
{
$width = imagesx ( $input_image_resource );
$height = imagesy ( $input_image_resource );
$output_image_resource = imagecreatetruecolor ( $width, $height );
$y = 1;
while ( $y < $height )
{
for ( $i = 1; $i <= $width; $i++ )
imagesetpixel ( $output_image_resource, $i, $y, imagecolorat ( $input_image_resource, ( $i ), ( $height - $y ) ) );
$y = $y + 1;
}

return $output_image_resource;
}
?>
Example Usage:
<?php
// A good use of this is when a user uploads a TGA file,
// on the completion screen show the image and have a link
// that asks if the image appears mirrored, and if so
// that link will execute these commands below.
// I suggest checking $HTTP_REFERER for security.
// $_GET['file'] in this case would be something along the lines
// of johndoe-img0001 (Basename is necessary to prevent
// abuse of this script!)
if ( isset( $_GET['file'] ) )
{
$filename = "./" . basename ( $_GET['file'] ) . ".jpg";
// Making the image resource that needs to be mirrored
// Taking it from a previously exported to JPEG file.
$output_resource_image = image_mirror ( imagecreatefromjpeg ( $filename ) );
if ( imagejpeg ( $output_resource_image, $filename, 75 ) )
echo "Image resaved successfully";
else
echo "Image couldn't be written over (Check permissions)!";
}
?>


justin greer

I know it's not a discussion board, but when incorrect info is posted, it should be corrected.
The function_exists() check does not work correctly because if PHP is compiled with an older GD library, the imagecreatetruecolor() function still exists -- it just gives a fatal error when called, stating that GD2 is required.  Therefore, the function_exists() method will fail on any new-ish copy of PHP that only has GD 1.x.  (That includes most of the 4.1.x and 4.2.x installs I've seen.)


bjorntje

I just fiddled around with Phpix, which had some problems using the GD lib
(washed out colours).
I changed the lines, which did the trick.
Just in case some of you are still having problems and
you can't change the PHP-install
on the hosting side:
$im = ImageCreateFromJPEG($source);
$new_im = ImageCreate($new_width,$new_height);

ImageCopyResized($new_im,$im,0,0,0,0,
$new_width,$new_height,ImageSX($im),ImageSY($im));
TO
$im = ImageCreateFromJPEG($source);
$new_im = ImageCreateTrueColor($new_width,$new_height);

ImageCopyResized($new_im,$im,0,0,0,0,$new_width,
$new_height,ImageSX($im),ImageSY($im));


j.fenin _at_ seekport d0t biz

I had a strange bug occurring under Debian Linux with PHP5.
In file B (where I create the image) I included a file (file A). The image that was produced was always corrupt. When I did not include file A, everything was fine.
After 2 hours of searching I found that there were some extra spaces and linefeeds after the PHP closing tag ?> in file A. After removing those chars, everything works fine again.
Obviously those extra bytes of file A were added to the image and corrupted it.


overflow636

i dont know if there was an easyer way to do this, but heres my code to convert a .tga image to whatever you want to output it as
it works with basic tga files only
<?
$handle = fopen("xxx.tga","rb");
$data = fread($handle,filesize("xxx.tga"));
fclose($handle);
$pointer = 18;
$x = 0;
$y = 0;
$w = fileint(substr($data,12,2));
$h = fileint(substr($data,14,2));
$img = imagecreatetruecolor($w,$h);
while ($pointer < strlen($data))
{
imagesetpixel($img, $x,$y,fileint(substr($data,$pointer,3)));
$x++;
if ($x==$w)
{
$y++;
$x=0;
}
$pointer += 3;
}
header("Content-type: image/jpeg");
imagepng($img);
imagedestroy($img);
function fileint($str)
{
 return base_convert(bin2hex(strrev($str)),16,10);
}
?>


marc

I discovered when installing GD 2+ that ImageCreate() doesn't work well with JPEGS, it makes a true colour JPEG into a 16 colour mess when combining ImageCreateFromJPEG(). If you have GD 2+ you must use ImageCreateTrueColor() for things like thumbnails, etc.

brad

I came up with this today.  You need GD2.0 or greater to use imagecreatetruecolor so you can parse phpinfo to get the needed information.  this will have to go at the very top of the page with no whitespace above it
<?php
ob_start();
phpinfo(8);
$phpinfo=ob_get_contents();
ob_end_clean();
$phpinfo=strip_tags($phpinfo);
$phpinfo=stristr($phpinfo,"gd version");
$phpinfo=stristr($phpinfo,"version");
$end=strpos($phpinfo," ");
$phpinfo=substr($phpinfo,0,$end);
$phpinfo=substr($phpinfo,7);
if(version_compare("2.0", "$phpinfo")==1)
echo "you have a version less then 2";
?>
The if statement is for PHP 4.1 or greater, but you can use other methods of comparing the version numbers if the server you are on do not have that version of php


micke micke dot prag

Here is my solution for creating images with the same code for both GD < 2 and GD > 2:
$dst_img = @imageCreateTrueColor($width, $height);
if (!$dst_img) { $dst_img = imageCreate($width, $height); }


pmas7354

Here is answer for first question 'why do I need true color images'.
True color images you need when you want to work with images such as photos (snapshots), video frames and so on.
When you need to combine some these images for user, or to send him only small part of your image, and you try to use 256 colors, image will be ugly (try it if you want). Some colors will change dramatically.
"Antialias" lines which you may see are probably the result of using JPEG compression. JPEG is not looseless compression so "small image details may be changed" in order to reduce image size dramatically. On really true-color images such as your snapshots of landscape and so on and using small compression level you will hardly see differences. But on exact objects, such as lines, circles, which you draw on solid background using single color, you can see that if you save and load this image that some details are changed.


rossa

function ConvertGreyscale($image){
# this file outputs a grey version of specified image
 $total = ImageColorsTotal($image);
 for( $i=0; $i<$total; $i++){
    $old = ImageColorsForIndex($image, $i);
   
    #trying to keep proper saturation when converting
    $commongrey = (int)(($old[red] + $old[green] + $old[blue]) / 3);
    ImageColorSet($image, $i, $commongrey, $commongrey, $commongrey);
 }
}


linkoovi

Fao all who r trying tu upload image and auto resize (make a thumba nail) and fet black thumb nail.
Try this:
U upload the image tu a specific DIR and when the big img is uploaded give the path tu big img to the function that makes the thumb nill.
i think that the problem is in
imagecreatefromjpeg($_FILE["bal"]["tmpName]");
SOLUTION:
imagecreatefromjpeg("test/thisimage.jpg");
the image MUST be there!
I hope this solves ur problems


billet_jerome

Because imagecreatetruecolor exist both in gd and gd2,
you can't use function_exists or get_extension_funcs to check for gd2 !
But ... there is a difference in imagettfbbox between gd and gd2:
gd use pixels and gd2 use points.
Then you can check gd2 with this function:
function sysB_chkgd2()
{
$rep=false;
if(isset($GLOBALS["gBGDVersion"]))
   {
   $rep=$GLOBALS["gBGDVersion"];
   }
else
   {
   if(function_exists("gd_info"))
      {
      $gdver=gd_info();
      if(strstr($gdver["GD Version"],"1.")!=false)
         {
         $rep=false;
         }
      else
          {
          $rep=true;
          }
      }
   else
       {
       $size=40;
       $font= your font file path here;
       $b=imagettfbbox ($size,0,$font,"abcdefghijklmnopqrstuvwxyz
ABCDEFGHIJKLMNOPQRSTUVWXYZ");
       if(($size+1)<abs($b[5]-$b[3]))
          {
          $rep=true;
          }
        }
   $GLOBALS["gBGDVersion"]=$rep;
   }
return $rep;
}


aaron

Actually GD <2.0 had imagecreattruecolor, it just didn't work :P
This is a better test:
function chkgd2(){
 $testGD = get_extension_funcs("gd"); // Grab function list
 if (!$testGD){ echo "GD not even installed."; exit; }
 if (in_array ("imagegd2",$testGD)) $gd_version = "<2"; // Check
 if ($gd_version == "<2") return false; else return true;
}
if (chkgd2()) echo "<h1>GD2+ is installed.</h1>"; // Test for GD2
else echo "<h1>GD2+ is not installed.</h1>";


florin florin.at.flachi.dot.net

A very simple and efficient way to create RGB color from hexadecimal (HTML) notation:
<?php
   function color_hex2dec ($color) {
       return array (hexdec (substr ($color, 0, 2)), hexdec (substr ($color, 2, 2)), hexdec (substr ($color, 4, 2)));
   }
   list ($r, $g, $b) = color_hex2dec ('FFEECC');
?>


fixxxer

A note to post by Justin Greer @ 18-Nov-2003 10:40:
While this information has already been posted by php at REMOVEreallynicejerk dot com @ 16-Sep-2002 12:01, I feel it neccesary to notice 'cause Justin's post is in the top and it can make people go the wrong way: Justin's way of detecting which imagecreate function to use is too complicated, while there's an easy standard way:
<?php
if (function_exists('imagecreatetruecolor') {
// use imagecreatetruecolor
} else {
// use imagecreate
}


21-jun-2005 11:17

// Creates a transparent image rather than the default black image
function imageCreateTransparent($x, $y) {
$imageOut = imagecreate($x, $y);
$colourBlack = imagecolorallocate($imageOut, 0, 0, 0);
imagecolortransparent($imageOut, $colourBlack);
return $imageOut;
}


Change Language


Follow Navioo On Twitter
gd_info
getimagesize
image_type_to_extension
image_type_to_mime_type
image2wbmp
imagealphablending
imageantialias
imagearc
imagechar
imagecharup
imagecolorallocate
imagecolorallocatealpha
imagecolorat
imagecolorclosest
imagecolorclosestalpha
imagecolorclosesthwb
imagecolordeallocate
imagecolorexact
imagecolorexactalpha
imagecolormatch
imagecolorresolve
imagecolorresolvealpha
imagecolorset
imagecolorsforindex
imagecolorstotal
imagecolortransparent
imageconvolution
imagecopy
imagecopymerge
imagecopymergegray
imagecopyresampled
imagecopyresized
imagecreate
imagecreatefromgd2
imagecreatefromgd2part
imagecreatefromgd
imagecreatefromgif
imagecreatefromjpeg
imagecreatefrompng
imagecreatefromstring
imagecreatefromwbmp
imagecreatefromxbm
imagecreatefromxpm
imagecreatetruecolor
imagedashedline
imagedestroy
imageellipse
imagefill
imagefilledarc
imagefilledellipse
imagefilledpolygon
imagefilledrectangle
imagefilltoborder
imagefilter
imagefontheight
imagefontwidth
imageftbbox
imagefttext
imagegammacorrect
imagegd2
imagegd
imagegif
imagegrabscreen
imagegrabwindow
imageinterlace
imageistruecolor
imagejpeg
imagelayereffect
imageline
imageloadfont
imagepalettecopy
imagepng
imagepolygon
imagepsbbox
imagepsencodefont
imagepsextendfont
imagepsfreefont
imagepsloadfont
imagepsslantfont
imagepstext
imagerectangle
imagerotate
imagesavealpha
imagesetbrush
imagesetpixel
imagesetstyle
imagesetthickness
imagesettile
imagestring
imagestringup
imagesx
imagesy
imagetruecolortopalette
imagettfbbox
imagettftext
imagetypes
imagewbmp
imagexbm
iptcembed
iptcparse
jpeg2wbmp
png2wbmp
eXTReMe Tracker