Imagick::setIteratorIndex

(PECL imagick 2.0.0)

Imagick::setIteratorIndex — Set the iterator position

설명

bool Imagick::setIteratorIndex ( int $index )

Set the iterator to the position in the image list specified with the index parameter. 이 메쏘드는 Imagick을 ImageMagick 6.2.9 이상으로 컴파일 했을 때만 사용할 수 있습니다.

인수

index: The position to set the iterator to

반환값

성공시에 TRUE를 반환합니다.

예제

Example #1 Using Imagick::setIteratorIndex():

Create images, set and get the iterator index


<?php
$im = new Imagick();
$im->newImage(100, 100, new ImagickPixel("red"));
$im->newImage(100, 100, new ImagickPixel("green"));
$im->newImage(100, 100, new ImagickPixel("blue"));

$im->setIteratorIndex(1);
echo $im->getIteratorIndex();
?>

참고

Imagick::getIteratorIndex() - Gets the index of the current active image
Imagick::getImageIndex() - Gets the index of the current active image
Imagick::setImageIndex() - Set the iterator position

add a note

User Contributed Notes 1 note

down

wilcobeekhuizen at gmail dot com ¶

13 years ago


This function returns true on success but setting the iterator to an invalid index throws an exception instead of returning false:

Fatal error: Uncaught exception 'ImagickException' with message 'Unable to set iterator index'



This can happen when counting images inside a gif file, because the iterator count starts at zero and not one. If you count the number of images in a gif file be sure to use iterator 0 for the first image, like this:



<?php

$image = new Imagick('simple.gif');

$image->setIteratorIndex(0);

?>

add a note