---
title: "imagePlaygroundSheet(isPresented:concepts:sourceImage:onCompletion:onCancellation:)"
framework: swiftui
role: symbol
role_heading: Instance Method
path: "swiftui/view/imageplaygroundsheet(ispresented:concepts:sourceimage:oncompletion:oncancellation:)"
---

# imagePlaygroundSheet(isPresented:concepts:sourceImage:onCompletion:onCancellation:)

Presents the system sheet to create an image using one or more concepts and an optional starting image.

## Declaration

```swift
@MainActor @preconcurrency func imagePlaygroundSheet(isPresented: Binding<Bool>, concepts: [ImagePlaygroundConcept] = [], sourceImage: Image? = nil, onCompletion: @escaping (URL) -> Void, onCancellation: (() -> Void)? = nil) -> some View

```

## Parameters

- `isPresented`: A binding to a variable with a Boolean value. Set the Boolean value to true to display the sheet, and set it to false to dismiss the sheet.
- `concepts`: An array of initial concepts (text descriptions, concepts extracted from text, drawings) that describe the expected contents of the image. The person reviewing the image can change these prompts inside the creation UI.
- `sourceImage`: An existing image to use as source input for the new image. The person viewing the sheet can override the image you provide, and choose different images and concepts inside the creation UI. If you don’t provide a starting image, the system creates the new image using only the contents of the concepts parameter.
- `onCompletion`: The block to receive the generated image. The block has no return value and receives the following parameter:
- `onCancellation`: The block to execute when the person exits the creation UI without choosing an image. After executing this block, the system automatically dismisses the sheet.

## Discussion

Discussion Use this modifier to display the image-creation sheet from one of your SwiftUI views. The sheet presents a system-provided UI to generate an image from one or more strings or concepts and an optional image. The sheet gives the person controls to modify the image before returning it to your app. When the person dismisses the sheet, the system runs one of the blocks you provided. Use the completion block to integrate the generated image into your app’s content. This modifier works only on devices that support the creation of new images. Check the ImagePlayground/SwiftUICore/EnvironmentValues/supportsImagePlayground environment variable to determine the availability of the feature. The following code creates a button to display the sheet only when the feature is available: @State private var showSheet = false @State private var createdImageURL: URL? = nil @Environment(\.supportsImagePlayground) private var supportsImagePlayground // ....

if supportsImagePlayground {   Button("Show Generation Sheet") {     showSheet = true   }.imagePlaygroundSheet(isPresented: $showSheet) { url in       createdImageURL = url   } }

## See Also

### Generating images

- [imagePlaygroundGenerationStyle(_:in:)](swiftui/view/imageplaygroundgenerationstyle(_:in:).md)
- [imagePlaygroundOptions(_:)](swiftui/view/imageplaygroundoptions(_:).md)
- [imagePlaygroundSheet(isPresented:concept:sourceImage:onCompletion:onCancellation:)](swiftui/view/imageplaygroundsheet(ispresented:concept:sourceimage:oncompletion:oncancellation:).md)
- [imagePlaygroundSheet(isPresented:concept:sourceImage:onCompletion:onAdaptiveImageGlyphCreation:onCancellation:)](swiftui/view/imageplaygroundsheet(ispresented:concept:sourceimage:oncompletion:onadaptiveimageglyphcreation:oncancellation:).md)
- [imagePlaygroundSheet(isPresented:concept:sourceImageURL:onCompletion:onCancellation:)](swiftui/view/imageplaygroundsheet(ispresented:concept:sourceimageurl:oncompletion:oncancellation:).md)
- [imagePlaygroundSheet(isPresented:concept:sourceImageURL:onCompletion:onAdaptiveImageGlyphCreation:onCancellation:)](swiftui/view/imageplaygroundsheet(ispresented:concept:sourceimageurl:oncompletion:onadaptiveimageglyphcreation:oncancellation:).md)
- [imagePlaygroundSheet(isPresented:concepts:sourceImage:onCompletion:onAdaptiveImageGlyphCreation:onCancellation:)](swiftui/view/imageplaygroundsheet(ispresented:concepts:sourceimage:oncompletion:onadaptiveimageglyphcreation:oncancellation:).md)
- [imagePlaygroundSheet(isPresented:concepts:sourceImageURL:onCompletion:onCancellation:)](swiftui/view/imageplaygroundsheet(ispresented:concepts:sourceimageurl:oncompletion:oncancellation:).md)
- [imagePlaygroundSheet(isPresented:concepts:sourceImageURL:onCompletion:onAdaptiveImageGlyphCreation:onCancellation:)](swiftui/view/imageplaygroundsheet(ispresented:concepts:sourceimageurl:oncompletion:onadaptiveimageglyphcreation:oncancellation:).md)