Open In App

PHP | Imagick getPixelRegionIterator() Function

Last Updated : 26 Nov, 2019
Improve
Improve
Like Article
Like
Save
Share
Report

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



Like Article
Suggest improvement
Share your thoughts in the comments