class

FGeometricAcousticsSystem

The scene's geometric acoustics. On its first tick it builds the acoustic geometry — its own scan hierarchy over the level when the ScanHierarchy plugin is loaded, else the physics scene — and installs the scan hierarchy for the world, which moves every occlusion query (world sources, proximity voice, radio, AI hearing) onto the scanned walls. Then, a few times a second, it re-traces the space around the listener: the decay and the absorption the walls really have go to the echo tail, and the exact early reflections replace its per-distance guess in the reverb impulse response.

Module
Game
Header
#include "Gameplay/GeometricAcousticsSystem.h"
Namespace
Mowo

Echolocation: Echolocate sends a click out of a cone, reports the echoes, tells the AI a click was heard, and plays each returning echo from where it bounced once its round trip has elapsed (audio.Acoustics.EchoClip).

Constructors

SignatureNameDescription
FGeometricAcousticsSystem()FGeometricAcousticsSystem
~FGeometricAcousticsSystem() override~FGeometricAcousticsSystem
FGeometricAcousticsSystem(const FGeometricAcousticsSystem&) = deleteFGeometricAcousticsSystem

Public functions

ReturnsNameDescription
FGeometricAcousticsSystem&operator=
SystemPhaseGetPhase
const char*GetDebugName
voidInitialize
voidUpdate
voidShutdown
voidInvalidateGeometryDrops the geometry so the next tick builds it again — after a level streamed in or the source setting changed.
voidSetGeometryTraces against geometry instead of building one, and installs it for the world's occlusion when forOcclusion.
const IAcousticGeometry*GetGeometry
boolIsOcclusionInstalled
voidTraceListenerRe-traces the listener now instead of waiting for the next update slot.
const FAcousticReverb&GetReverb
const std::vector<FAcousticReflection>&GetReflections
uint32_tGetTraceCount
const FEcholocationResult&Echolocate
const FEcholocationResult&GetLastEcholocation
uint32_tGetPendingEchoCount
uint32_tGetReleasedEchoCount
FGeometricAcousticsSystem*Find

Function details

FGeometricAcousticsSystem

C++
FGeometricAcousticsSystem()

~FGeometricAcousticsSystem

C++
~FGeometricAcousticsSystem() override

FGeometricAcousticsSystem

C++
FGeometricAcousticsSystem(const FGeometricAcousticsSystem&) = delete

operator=

C++
FGeometricAcousticsSystem& operator=(const FGeometricAcousticsSystem&) = delete

GetPhase

C++
SystemPhase GetPhase() const override

GetDebugName

C++
const char* GetDebugName() const override

Initialize

C++
void Initialize(World* world) override

Update

C++
void Update(float deltaTime) override

Shutdown

C++
void Shutdown() override

InvalidateGeometry

C++
void InvalidateGeometry()

Drops the geometry so the next tick builds it again — after a level streamed in or the source setting changed.

SetGeometry

C++
void SetGeometry(std::shared_ptr<IAcousticGeometry> geometry, bool forOcclusion)

Traces against geometry instead of building one, and installs it for the world's occlusion when forOcclusion. Tools and tests.

GetGeometry

C++
const IAcousticGeometry* GetGeometry() const

IsOcclusionInstalled

C++
bool IsOcclusionInstalled() const

TraceListener

C++
void TraceListener(const Vec3& listener)

Re-traces the listener now instead of waiting for the next update slot.

GetReverb

C++
const FAcousticReverb& GetReverb() const

GetReflections

C++
const std::vector<FAcousticReflection>& GetReflections() const

GetTraceCount

C++
uint32_t GetTraceCount() const

Echolocate

C++
const FEcholocationResult& Echolocate(const Vec3& origin, const Vec3& direction, EntityID instigator)

GetLastEcholocation

C++
const FEcholocationResult& GetLastEcholocation() const

GetPendingEchoCount

C++
uint32_t GetPendingEchoCount() const

GetReleasedEchoCount

C++
uint32_t GetReleasedEchoCount() const

Find

C++
static FGeometricAcousticsSystem* Find(World& world)
Generated from Gameplay/GeometricAcousticsSystem.h via game.json · Nov 5, 2026Version 1.0.0