Dutch PHP Conference 2025 - Call For Papers

Imagick::compareImages

(PECL imagick 2, PECL imagick 3)

Imagick::compareImagesCompara uma imagem com uma imagem reconstruída

Descrição

public Imagick::compareImages(Imagick $compare, int $metric): array

Retorna um array contendo uma imagem reconstruída e a diferença entre as imagens.

Parâmetros

compare

Uma imagem para comparar.

metric

Forneça uma constante de tipo de métrica válida. Consulte esta lista de constantes métricas.

Valor Retornado

Retorna um array contendo uma imagem reconstruída e a diferença entre as imagens.

Erros/Exceções

Lança uma exceção ImagickException em caso de erro.

Exemplos

Exemplo #1 Usando Imagick::compareImages():

Compara imagens e exibe a imagem reconstruída

<?php

$image1
= new imagick("image1.png");
$image2 = new imagick("image2.png");

$result = $image1->compareImages($image2, Imagick::METRIC_MEANSQUAREERROR);
$result[0]->setImageFormat("png");

header("Content-Type: image/png");
echo
$result[0];

?>

add a note

User Contributed Notes 2 notes

up
9
info at celeste-design dot de
10 years ago
If you get the following non-descriptive error message:

Uncaught exception 'ImagickException' with message 'Compare images failed'

Check your picture dimensions! i compared a 21x20 png to a 20x20 png which resulted in that error. Took me forever to figure out that the dimensions have to be exactly the same.
up
1
Tim K and Sam M @netflix
10 years ago
The *Absolute Error* metric is not listed as an available metric constant. However, you can still use it if needed by passing the internal constant definition for AE which is 1. This is useful when you wish to compare using a desired fuzz factor. Example:

<?php
// init the image objects
$image1 = new imagick();
$image2 = new imagick();

// set the fuzz factor (must be done BEFORE reading in the images)
$image1->SetOption('fuzz', '2%');

// read in the images
$image1->readImage("php_step29_actual.png");
$image2->readImage("php_step29_correct.png");

// compare the images using METRIC=1 (Absolute Error)
$result = $image1->compareImages($image2, 1);

// print out the result
echo "The image comparison 2% Fuzz factor is: " . $result[1];
?>
To Top