Imagick::getPixelIterator

(PECL imagick 2, PECL imagick 3)

Imagick::getPixelIteratorReturns a MagickPixelIterator

说明

public Imagick::getPixelIterator ( ) : ImagickPixelIterator

Returns a MagickPixelIterator.

参数

此函数没有参数。

返回值

Returns an ImagickPixelIterator on success.

错误/异常

错误时抛出 ImagickException。

范例

Example #1 Imagick::getPixelIterator()

<?php
function getPixelIterator($imagePath) {
    
$imagick = new \Imagick(realpath($imagePath));
    
$imageIterator $imagick->getPixelIterator();

    foreach (
$imageIterator as $row => $pixels) { /* Loop through pixel rows */
        
foreach ($pixels as $column => $pixel) { /* Loop through the pixels in the row (columns) */
            /** @var $pixel \ImagickPixel */
            
if ($column 2) {
                
$pixel->setColor("rgba(0, 0, 0, 0)"); /* Paint every second pixel black*/
            
}
        }
        
$imageIterator->syncIterator(); /* Sync the iterator, this is important to do on each iteration */
    
}

    
header("Content-Type: image/jpg");
    echo 
$imagick;
}

?>

User Contributed Notes

Sebastian Herold 30-Jun-2008 01:06
For me it was very helpful to read a article at Mikko's blog. He showed that the PixelIterator is not read-only, if you sync it regularly:

<?php
     
/* Create new object with the image */
     
$im = new Imagick( "strawberry.png" );

     
/* Get iterator */
     
$it = $im->getPixelIterator();
      
     
/* Loop trough pixel rows */
     
foreach( $it as $row => $pixels )
      {
         
/* For every second row */
         
if ( $row % 2 )
          {
             
/* Loop trough the pixels in the row (columns) */
             
foreach ( $pixels as $column => $pixel )
              {
                     
/* Paint every second pixel black*/
                     
if ( $column % 2 )
                      {
                             
$pixel->setColor( "black" );
                      }
              }

          }
        
         
/* Sync the iterator, this is important to do on each iteration */
         
$it->syncIterator();
      }
      
     
/* Display the image */
     
header( "Content-Type: image/png" );
      echo
$im;
      
?>