Home/ Manual/ image / functions/ imagecreatetruecolor

imagecreatetruecolor

PHP function Edit on GitHub ✎

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

Create a new true color image

Description

imagecreatetruecolor(int $width, int $height): GdImage|false

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

Parameters

width: Image width.
height: Image height.

Return Values

Identifier

Changelog

Version	Description
8.0.0	On success, this function returns a `GDImage` instance now; previously, a `resource` was returned.

Examples

Creating a new GD image stream and outputting an image.

php

<?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);
?>

The above example will output something similar to: Output of example : Creating a new GD image stream and outputting an image.