<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/PhysicallyBasedMaterial/secondaryTextureCoordinateTransform",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation23PhysicallyBasedMaterialV35secondaryTextureCoordinateTransformAA0E14ParameterTypesV0ghI0Vvp"
  },
  "title" : "secondaryTextureCoordinateTransform"
}
-->

# secondaryTextureCoordinateTransform

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

```
var secondaryTextureCoordinateTransform: PhysicallyBasedMaterial.TextureCoordinateTransform { get set }
```

## Discussion

An entity’s UV texture coordinates define how RealityKit maps image
textures onto an entity. This property allows you to transform the
secondary texture coordinates to change the way this material maps
textures onto an entity. If an entity has multiple materials assigned to
it, the transformation doesn’t affect how the other materials map their
textures.

You might, for example, change the scale of the UV coordinates to apply
a tiled, repeating pattern to the surface of your entity, or
continuously rotate or translate the texture coordinates to animate
materials to create special effects, such as fire or flowing liquids.

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

```swift
let rotationRadians = Float(45.0) * .pi / 180 // 45 degrees converted to radians.
secondaryTextureCoordinateTransform =.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 transforms the secondary set. To transform
the primary UV coordinates in a material, see
[`textureCoordinateTransform`](/documentation/RealityKit/PhysicallyBasedMaterial/textureCoordinateTransform-swift.property).

---

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)