# imagecreatetruecolor

(PHP 4 >= 4.0.6, PHP 5, PHP 7)

imagecreatetruecolor — Create a new true color image

### Description

imagecreatetruecolor ( int `$width` , int `$height` ) : resource

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

### Parameters

`width`

  Image width.

`height`

  Image height.

### Return Values

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

### Examples

Example #1 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:

### See Also

- imagedestroy() - Destroy an image
- imagecreate() - Create a new palette based image