<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/Entity/WriteOptions/preferSmallTextureFiles(quality:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation6EntityC12WriteOptionsV23preferSmallTextureFiles7qualityA2E0H7QualityV_tFZ"
  },
  "title" : "preferSmallTextureFiles(quality:)"
}
-->

# preferSmallTextureFiles(quality:)

Reduce textures’ file size while preserving its dimensions.

```
static func preferSmallTextureFiles(quality: Entity.WriteOptions.TextureQuality) -> Entity.WriteOptions
```

## Discussion

The returned option instructs RealityKit to encode textures using smaller file
representations. RealityKit selects the best strategy for each texture based
on context, which may include lossy image encoding, preserving the original
source image, or regenerating mipmaps.

> Warning: While writing smaller texture files reduces the size of reality files on disk,
> loading those textures can increase memory usage and load times
> compared to the default compressed format. Larger memory region
> can also consume more power during rendering due to increased
> cache pressure.

> Note: RealityKit ignores this option for textures created with ``doc://com.apple.RealityKit/documentation/RealityKit/TextureResource/Compression/none``.

---

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)