Friday, June 12, 2026
HomeLanguagesPHP | Imagick getPixelRegionIterator() Function

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(
  
$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(
  
$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

RELATED ARTICLES

Most Popular

Dominic
32515 POSTS0 COMMENTS
Milvus
131 POSTS0 COMMENTS
Nango Kala
6897 POSTS0 COMMENTS
Nicole Veronica
12013 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12109 POSTS0 COMMENTS
Shaida Kate Naidoo
7019 POSTS0 COMMENTS
Ted Musemwa
7262 POSTS0 COMMENTS
Thapelo Manthata
6976 POSTS0 COMMENTS
Umr Jansen
6963 POSTS0 COMMENTS