texture2DArray(slices:named:options:)

Declaration

@MainActor @preconcurrency static func texture2DArray(slices: [CGImage], named resourceName: String? = nil, options: TextureResource.CreateOptions) async throws -> TextureResource

Parameters

• slices:

  The source images, one per 2D array index. All images need to have the same size and format.

• 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

RealityKit creates a MTLTextureType.type2DArray texture with arrayLength == slices.count from an array of images.

You can assign the resulting texture to a material you create in Reality Composer Pro that requires a 2D texture array.

// Create a 2D array texture from image slices.
let texture2DArray = try TextureResource.texture2DArray(
    slices: [image0, image1, image2],
    options: TextureResource.CreateOptions(semantic: .color))

Task {
    // Assign the 2D array texture to a compatible shader graph material parameter.
    var material = try await ShaderGraphMaterial(
        named: "/Root/Spaceship/MaterialWith2DArray", from: url)

    try material.setParameter(
        name: "input2DArray", value: .textureResource(texture2DArray))
}