PHP | Imagick getPixelRegionIterator() Function

The Imagick::getPixelRegionIterator() function is an inbuilt function in PHP which is used to get an ImagickPixelIterator for an image section.

Syntax:

ImagickPixelIterator Imagick::getPixelRegionIterator( int $x, int $y, int $columns, int $rows )

Parameters:This function accepts four parameters as mentioned above and described below:

• $x: It specifies the x-coordinate of the region.
• $y: It specifies the y-coordinate of the region.
• $columns: It specifies the width of the region.
• $rows: It specifies the height of the region.

Return Value: This function returns an ImagickPixelIterator for an image section.

Errors/Exceptions: This function throws ImagickException on error.

Below programs illustrate the Imagick::getPixelRegionIterator() function in PHP:

Program 1:

<?php

// Create a new imagick object
$imagick = new Imagick(
'https://media.geeksforgeeks.org/wp-content/uploads/20190918234528/colorize1.png');

$imageIterator = $imagick->getPixelRegionIterator(0, 0, 330, 200);

// Change the color of every second pixel of region to blue
foreach ($imageIterator as $row => $pixels) {
    foreach ($pixels as $column => $pixel) {
        if ($column % 2) {
            $pixel->setColor("blue");
        }
    }
    $imageIterator->syncIterator();
}

// Display the output
header("Content-Type:image/png");
echo $imagick;
?>

Output:

Program 2:

<?php

// Create a new imagick object
$imagick = new Imagick(
'https://media.geeksforgeeks.org/wp-content/uploads/20190918234528/colorize1.png');

$imageIterator = $imagick->getPixelRegionIterator(330, 0, 338, 200);

// Change the color of every second pixel of region to green
foreach ($imageIterator as $row => $pixels) {
    foreach ($pixels as $column => $pixel) {
        if ($column % 2) {
            $pixel->setColor("green");
        }
    }
    $imageIterator->syncIterator();
}

// Display the output
header("Content-Type:image/png");
echo $imagick;
?>

Output:

Reference: https://www.php.net/manual/en/imagick.getpixelregioniterator.php