Spatialization (Azimuth)

How to distribute the signal across channels with azimuth calculation

This example demonstrates how to position a stereo audio source in a three-dimensional environment using an azimuth-based spatializer. The system models interaction with the listener’s anatomy, generating a realistic perception of direction and depth.

// Configure the graph for rendering
let context = Assembler(rendering: .live).createAudioGraph()

// Configure an audio source (Renderer) from a local audio file
let url = URL(fileURLWithPath: "/path/to/source.wav")
let source = FileRenderer(contentsOf: url)

// Configure a stereo spatializer and parameters
let destination = AzimuthSpatializer(distanceModel: .distanceModelInverse)
destination.position = .init(x: 0.0, y: 0.0, z: 0.0)
context.listener.up = Vector3<Float64>(x: 0, y: 1.0, z: 0)
context.listener.position = Vector3<Float64>(x: 0.0, y: 0.0, z: 0.0)
context.listener.forward = Vector3<Float64>(x: 0, y: 0, z: -1.0)

// Configure node connections
try context.connect(source: source, to: destination)
try context.connect(source: destination, to: context.destination)
source.play(after: 0)

The following video shows the sample code in action and its real-time processing.

For a complete description of each class, method, and property referenced in this section, refer to the official API documentation, where you will find detailed references, available components, parameters, and additional usage code examples.