<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/Audio/Scattering",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation5AudioO10ScatteringV"
  },
  "title" : "Audio.Scattering"
}
-->

# Audio.Scattering

An object that holds a set of scattering data.

```
struct Scattering
```

## Overview

The scattering coefficient is a value between zero and one that describes the proportion of
incident sound energy that is diffused or redirected by a surface, rather than absorbed.

Create scattering data from an array of ten octave-band coefficients, a dictionary of
frequency–coefficient pairs, or a dictionary literal:

```swift
// From an array of ten octave-band coefficients:
let data = Audio.Scattering([0.01, 0.02, 0.03, 0.04, 0.05, 0.06, 0.07, 0.08, 0.09, 0.10])

// From a dictionary of frequency–coefficient pairs:
let data = Audio.Scattering([500: 0.3, 1000: 0.4, 4000: 0.5])

// From a dictionary literal:
let data: Audio.Scattering = [500: 0.3, 1000: 0.4, 4000: 0.5]
```

## Topics

### Creating a scattering value

[`static func uniform(Float) -> Audio.Scattering`](/documentation/RealityKit/Audio/Scattering/uniform(_:))

Creates a scattering data set with the coefficient applied uniformly for every frequency.

### Scaling scattering

[`func scaled(by: (Float) -> Float) -> Audio.Scattering`](/documentation/RealityKit/Audio/Scattering/scaled(by:))

Scale the scattering data by a frequency-dependent scalar value between -1 and 1.

### Initializers

[`init(_:)`](/documentation/RealityKit/Audio/Scattering/init(_:))

Creates a scattering data set from a sequence of pairs of center frequency and scattering coefficient.

### Type Properties

[`static let `default`: Audio.Scattering`](/documentation/RealityKit/Audio/Scattering/default)

The default set of scattering data.

### Default Implementations

[ExpressibleByDictionaryLiteral Implementations](/documentation/RealityKit/Audio/Scattering/ExpressibleByDictionaryLiteral-Implementations)

## Relationships

### Conforms To

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Sendable`](/documentation/Swift/Sendable)

[`Hashable`](/documentation/Swift/Hashable)

[`ExpressibleByDictionaryLiteral`](/documentation/Swift/ExpressibleByDictionaryLiteral)

[`Escapable`](/documentation/Swift/Escapable)

[`Copyable`](/documentation/Swift/Copyable)

[`Equatable`](/documentation/Swift/Equatable)

---

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)