currentFrame

Specifies the current frame of an animated GIF.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

set the currentFrame of image to frameNumber

# Examples

set the currentFrame of image "Process" to 1 -- back to the beginning

# Description

Use the currentFrame property to check where an animated GIF image is in its sequence. Set this property in order to change the current frame of an animated GIF: for example, to examine the animation frame by frame.

If the image is not a GIF, the currentFrame property always reports 1, and setting it has no effect.

# Tags

multimedia,

# See

- **keyword:** image, integer - **property:** repeatCount, frameCount, endFrame, startFrame, currentTime, palindromeFrames - **object:** image - **glossary:** frame, animated GIF, property