---
title: "animatedImage(with:duration:)"
framework: uikit
role: symbol
role_heading: Type Method
path: "uikit/uiimage/animatedimage(with:duration:)"
---

# animatedImage(with:duration:)

Creates and returns an animated image from an existing set of images.

## Declaration

```swift
class func animatedImage(with images: [UIImage], duration: TimeInterval) -> UIImage?
```

## Parameters

- `images`: An array of doc://com.apple.uikit/documentation/UIKit/UIImage objects.
- `duration`: The duration of the animation.

## Return Value

Return Value A new image object.

## Discussion

Discussion All images included in the animated image should share the same size and scale.

## See Also

### Creating animated images

- [animatedImageNamed(_:duration:)](uikit/uiimage/animatedimagenamed(_:duration:).md)
- [animatedResizableImageNamed(_:capInsets:duration:)](uikit/uiimage/animatedresizableimagenamed(_:capinsets:duration:).md)
- [animatedResizableImageNamed(_:capInsets:resizingMode:duration:)](uikit/uiimage/animatedresizableimagenamed(_:capinsets:resizingmode:duration:).md)