A type that stores the options that affect the image-generation process.
Create an instance of this structure and use it to specify the options you
want to use when generating images. Apply these options to your SwiftUI sheet
using the <doc://com.apple.documentation/documentation/swiftui/view/imagePlaygroundOptions(_:)>
modifier, or assign them to properties of the ``ImagePlaygroundViewController``
or ``ImageCreator`` type before generating any images.
Members (9)
get · iOS 26.4+
creationVariety
TypeScript
get creationVariety(): ImagePlaygroundOptions_CreationVariety
Swift declaration
var creationVariety: ImagePlaygroundOptions.CreationVariety
The amount to vary the creation parameters when generating multiple images from the
same inputs.
When creating multiple images from the same inputs, the system adjusts parameters
programmatically to create images with different content. Use this property to specify
the amount of variability you want in the final images. For example, specify
``CreationVariety/high`` to generate images with greater numbers of differences,
or specify ``CreationVariety/low`` to generate images that are closer together.
The default value of this property is ``ImagePlaygroundOptions/CreationVariety/automatic``.
set · iOS 26.4+
creationVariety
TypeScript
set creationVariety(value: ImagePlaygroundOptions_CreationVariety)
Swift declaration
var creationVariety: ImagePlaygroundOptions.CreationVariety
The amount to vary the creation parameters when generating multiple images from the
same inputs.
When creating multiple images from the same inputs, the system adjusts parameters
programmatically to create images with different content. Use this property to specify
the amount of variability you want in the final images. For example, specify
``CreationVariety/high`` to generate images with greater numbers of differences,
or specify ``CreationVariety/low`` to generate images that are closer together.
The default value of this property is ``ImagePlaygroundOptions/CreationVariety/automatic``.
get · iOS 26.4+
personalization
TypeScript
get personalization(): ImagePlaygroundOptions_Personalization
Swift declaration
var personalization: ImagePlaygroundOptions.Personalization
The option to enable or disable personalization features.
When personalization features are enabled, the system interfaces make the people
picker available for choosing an initial photo. If one of the prompts contains a
name, the system also uses that information to identify the associated person. The
system uses any referenced people to influence the images it generates. For example,
it can incorporate the person’s appearance and skin tone into any generated images.
If you disable personalization, the system uses only the provided inputs to
generate the images.
The default value of this property is ``ImagePlaygroundOptions/Personalization/automatic``.
set · iOS 26.4+
personalization
TypeScript
set personalization(value: ImagePlaygroundOptions_Personalization)
Swift declaration
var personalization: ImagePlaygroundOptions.Personalization
The option to enable or disable personalization features.
When personalization features are enabled, the system interfaces make the people
picker available for choosing an initial photo. If one of the prompts contains a
name, the system also uses that information to identify the associated person. The
system uses any referenced people to influence the images it generates. For example,
it can incorporate the person’s appearance and skin tone into any generated images.
If you disable personalization, the system uses only the provided inputs to
generate the images.
The default value of this property is ``ImagePlaygroundOptions/Personalization/automatic``.
get · iOS 27.0+
creationStrategy
TypeScript
get creationStrategy(): ImagePlaygroundOptions_CreationStrategy
Swift declaration
var creationStrategy: ImagePlaygroundOptions.CreationStrategy
The options that specify how to interpret the content in the provided input image.
If one of the inputs to the image generation process is an image, this property
determines how the system uses that image to generate new images. You can specify
an image programmatically, but people can also select images from the system interface.
Creation strategies include generating new images that closely resemble the
original or using the original only for inspiration.
The default value of this property is ``ImagePlaygroundOptions/CreationStrategy/automatic``.
set · iOS 27.0+
creationStrategy
TypeScript
set creationStrategy(value: ImagePlaygroundOptions_CreationStrategy)
Swift declaration
var creationStrategy: ImagePlaygroundOptions.CreationStrategy
The options that specify how to interpret the content in the provided input image.
If one of the inputs to the image generation process is an image, this property
determines how the system uses that image to generate new images. You can specify
an image programmatically, but people can also select images from the system interface.
Creation strategies include generating new images that closely resemble the
original or using the original only for inspiration.
The default value of this property is ``ImagePlaygroundOptions/CreationStrategy/automatic``.
get · iOS 27.0+
sizeSpecification
TypeScript
get sizeSpecification(): ImagePlaygroundOptions_SizeSpecification
Swift declaration
var sizeSpecification: ImagePlaygroundOptions.SizeSpecification
The requested size for any generated images.
The default value of this property requests the smallest image size with
a square aspect ratio.
set · iOS 27.0+
sizeSpecification
TypeScript
set sizeSpecification(value: ImagePlaygroundOptions_SizeSpecification)
Swift declaration
var sizeSpecification: ImagePlaygroundOptions.SizeSpecification
The requested size for any generated images.
The default value of this property requests the smallest image size with
a square aspect ratio.
init · iOS 26.4+
init
TypeScript
static init(): ImagePlaygroundOptions
Swift declaration
init()
Initializes a new instance of this structure with a default set of options.
