---
title: "replace(using:options:)"
framework: realitykit
role: symbol
role_heading: Instance Method
path: "realitykit/textureresource/replace(using:options:)"
---

# replace(using:options:)

Asynchronously replaces the texture with a Core Graphics image.

## Declaration

```swift
@MainActor @preconcurrency func replace(using cgImage: CGImage, options: TextureResource.CreateOptions) async throws
```

## Parameters

- `cgImage`: The source image.
- `options`: Options that specify the type of texture to create. To preserve TextureResource usage, specify the same semantic.

## Discussion

Discussion Don’t use this method for updates at frame-rate frequency. For frequent texture changes, see replace(withDrawables:). To ensure consistent usage of this texture resource, pass the same semantic in options that you use to create the resource. note: The contents of a modified texture resource don’t sync between network clients.

## See Also

### Modifying the texture

- [replace(withDrawables:)](realitykit/textureresource/replace(withdrawables:).md)
- [replace(withImage:options:)](realitykit/textureresource/replace(withimage:options:).md)
- [replace(with:)](realitykit/textureresource/replace(with:).md)