# Imagick::setImageIterations

(PECL imagick 2.0.0)

Imagick::setImageIterations — Sets the image iterations

### Description

Imagick::setImageIterations ( int `$iterations` ) : bool

Sets the number of iterations an animated image is repeated.

### Parameters

`iterations`

  The number of iterations the image should loop over. Set to '0' to loop continuously.

### Return Values

Returns `TRUE` on success.

### Errors/Exceptions

Throws ImagickException on error.

### Examples

Example #1 Basic Imagick::setImageIterations() usage

`<?php
$imagick = new Imagick(realpath("Test.gif"));
$imagick = $imagick->coalesceImages();
$imagick->setImageIterations(1);
$imagick = $imagick->deconstructImages();
$imagick->writeImages('/path/to/save/OnceOnly.gif', true);
?>`