ITERATION

Specifies the number of times to repeat the GIF or SVG animation loop.

Used by:	GOPTIONS statement
Default:	0
Restriction:	GIFANIM and SVGANIM drivers only
See:	DELAY Generating Web Animation with GIFANIM Animating Output with the SVGANIM Printer

Syntax

The syntax for GIF animations is as follows:

ITERATION=0 | iteration-count

The syntax for SVG animations is as follows:

ITERATION=0 | 1

0 | iteration-count: specifies the number of times that your complete GIF animation loop is repeated. It is assumed that the animation is always played once; this option specifies how many times the animation is repeated. A value of 0 causes the animation to loop continuously. The value of iteration-count can be up to 65535.

0 | 1: specifies whether your SVG animation loop is repeated continuously (0) or is played only once (1). When ITERATION=1, your users can use the SVG Viewer reset and play buttons to replay the animation as desired.

Note: If a value other than 0 or 1 is specified, a value of 1 is assumed when the SVG animation is replayed.

When an SVG animation plays, each page is held in view for a period of time. After that time, the page display fades out as the next page fades in. You can use the DELAY= graphics option to change the length of time that each page is held in view.

In Version 6, the GCOPIES graphics option controlled ITERATION for the GIFANIM driver.