<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/TextureResource/init(image:withName:options:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation15TextureResourceC5image8withName7optionsACSo10CGImageRefa_SSSgAC13CreateOptionsVtYaKcfc::OverloadGroup"
  },
  "title" : "init(image:withName:options:)"
}
-->

# init(image:withName:options:)

Asynchronously creates a texture resource from an in-memory Core
Graphics image.

```
@MainActor @preconcurrency convenience init(image cgImage: CGImage, withName resourceName: String? = nil, options: TextureResource.CreateOptions) async throws
```

## Parameters

`cgImage`

The source image.

`resourceName`

A unique name for syncing the texture resource across the network.
The name is empty if you don’t include one.

`options`

A configuration for generating the texture.

## Discussion

This method creates a texture resource from an existing
<doc://com.apple.documentation/documentation/CoreGraphics/CGImage> with
specific options.

RealityKit uses the resource name to identify
resources, and to match texture resources between networked peers.
Specify a unique name for each texture resource you load or generate.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)