Imagick::setIteratorIndex

(PECL imagick 2, PECL imagick 3)

Imagick::setIteratorIndex — Déplace l'itérateur

Description

public Imagick::setIteratorIndex(int $index): bool

Déplace l'itérateur à la position index dans la séquence d'images. Cette méthode n'est disponible que si Imagick a été compilé avec ImageMagick version 6.2.9 ou supérieur.

Liste de paramètres

index: La position finale de l'itérateur

Valeurs de retour

Retourne true en cas de succès.

Exemples

Exemple #1 Exemple avec Imagick::setIteratorIndex()

Crée des images, définit et récupère l'index de l'itérateur.

<?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();
?>

Voir aussi

Imagick::getIteratorIndex() - Lit l'index de l'image active courante
Imagick::getImageIndex() - Lit l'index de l'image courante
Imagick::setImageIndex() - Modifie la position de l'itérateur

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