<!--
{
  "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/UnlitMaterial/textureCoordinateTransform-swift.property",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation13UnlitMaterialV26textureCoordinateTransformAA0D14ParameterTypesV07TexturefG0Vvp"
  },
  "title" : "textureCoordinateTransform"
}
-->

# textureCoordinateTransform

A two-dimensional transformation to apply to the entity’s primary
texture coordinates.

```
var textureCoordinateTransform: UnlitMaterial.TextureCoordinateTransform { get set }
```

## Discussion

An entity’s UV texture coordinates control how RealityKit materials map
image textures onto an entity. This property allows you to transform the
texture coordinates to change the way this material maps its textures.
You might, for example, change the scale of a property to apply a tiled,
repeating pattern, or continuously rotate or translate the texture
coordinates to animate materials to create special effects, such as fire
or flowing liquids.

The following example shows how to set a material’s UV transformation:

```swift
let rotationRadians = Float(45.0) * .pi / 180 // 45 degrees converted to radians.
material.textureCoordinateTransform = .init(offset: SIMD2<Float>(x:0.5, y: 0.5),
                                            scale: SIMD2<Float>(x:0.5, y: 0.5),
                                            rotation: rotationRadians)
```

Some entities imported from USDZ files have more than one set of UV
coordinates. This property affects the primary UV set (sometimes called
“UV1”). To transform the secondary UV coordinates (”UV2”), use
[`secondaryTextureCoordinateTransform`](/documentation/RealityKit/UnlitMaterial/secondaryTextureCoordinateTransform).

---

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)