International PHP Conference Berlin 2025

imagecolorstotal

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

imagecolorstotalFind out the number of colors in an image's palette

Description

imagecolorstotal(GdImage $image): int

Returns the number of colors in an image palette.

Parameters

image

A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().

Return Values

Returns the number of colors in the specified image's palette or 0 for truecolor images.

Changelog

Version Description
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.

Examples

Example #1 Getting total number of colors in an image using imagecolorstotal()

<?php
// Create image instance
$im = imagecreatefromgif('php.gif');

echo
'Total colors in image: ' . imagecolorstotal($im);

// Free image
imagedestroy($im);
?>

The above example will output something similar to:

Total colors in image: 128

See Also

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top