php8.5
Home/ Manual/ imagick / imagick/ Imagick::colorizeImage

Imagick::colorizeImage

PHP function Edit on GitHub ✎

(PECL imagick 2, PECL imagick 3)

Blends the fill color with the image

Description

Imagick::colorizeImage(mixed $colorize, mixed $opacity, bool $legacy = false): bool

Blends the fill color with each pixel in the image.

Parameters

colorize

ImagickPixel object or a string containing the colorize color

opacity

ImagickPixel object or an float containing the opacity value. 1.0 is fully opaque and 0.0 is fully transparent.

Return Values

Success

Errors/Exceptions

Throws

Changelog

VersionDescription
PECL imagick 2.1.0Now allows a string representing the color as the first parameter and a float representing the opacity value as the second parameter. Previous versions allow only an ImagickPixel objects.

Examples

Imagick::colorizeImage()

php
<?php
function colorizeImage($imagePath, $color, $opacity) {
    $imagick = new \Imagick(realpath($imagePath));
    $opacity = $opacity / 255.0;
    $opacityColor = new \ImagickPixel("rgba(0, 0, 0, $opacity)");
    $imagick->colorizeImage($color, $opacityColor);
    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();
}

?>

Source: reference/imagick/imagick/colorizeimage.xml · from the official PHP manual (php/doc-en)