Contents

replace(withImage:options:)

Dynamically replaces the texture with a Core Graphics image.

Declaration

@MainActor @preconcurrency func replace(withImage cgImage: CGImage, options: TextureResource.CreateOptions) throws

Parameters

  • cgImage:

    The source image.

  • options:

    Options that specify the type of texture to create.

Discussion

This method blocks until the resource updates. Don’t use this method for updates at frame-rate frequency. For frequent texture changes, see replace(withDrawables:). If you have an attached TextureResource.DrawableQueue on this resource, this function detaches it.

To ensure consistent usage of this texture resource, pass the same semantic in options that you use to create the resource.

See Also

Modifying the texture