How iosr-surrey/roomacousticpp works
RoomAcoustiC++ is a real-time room-acoustics library exposed through a C API for host applications. A host configures the room, sources, listener, and acoustic options through the API; the Context coordinates the simulation, and audio processing combines direct/early sound with optional late reverberation before spatialized output. The README documents diffraction variants, two late-reverb models, custom HRTFs, and dynamic geometry. Several internal links below are limited to imports or explicit excerpts; unsampled implementation details are not inferred.
Main entry points: Context.cpp Simulation context · SourceManager.h Audio processing · ImageSource.cpp Image sources · SourceManager.cpp Source manager
Components 18
Host API
- C API
RoomAcoustiCpp/source/Spatialiser/Main.cpp - Simulation context
RoomAcoustiCpp/source/Spatialiser/Context.cpp - Unity interface
RoomAcoustiCpp/source/Unity/UnityInterface.cpp
Acoustic Scene
- Room geometry
RoomAcoustiCpp/source/Spatialiser/Room.cpp - Walls and edges
RoomAcoustiCpp/source/Spatialiser/Wall.cpp - Source manager
RoomAcoustiCpp/source/Spatialiser/SourceManager.cpp - Audio source
RoomAcoustiCpp/source/Spatialiser/Source.cpp - Path tracing
RoomAcoustiCpp/source/Spatialiser/TracingThread.cpp
Audio Processing
- Audio processing
RoomAcoustiCpp/include/Spatialiser/SourceManager.h - DSP filters
RoomAcoustiCpp/source/DSP/IIRFilter.cpp - Binaural spatializer
RoomAcoustiCpp/source/Spatialiser/Context.cpp
Acoustic Models
- Image sources
RoomAcoustiCpp/source/Spatialiser/ImageSource.cpp - Diffraction models
RoomAcoustiCpp/source/Spatialiser/Diffraction/Models.cpp - NN-IIR prediction
RoomAcoustiCpp/codegen/dll/myNN/predict.cpp - FDN reverberation
RoomAcoustiCpp/source/Spatialiser/FDN.cpp - RAVES reverberation
RoomAcoustiCpp/include/Spatialiser/RAVESResidue.h - Reverb control
RoomAcoustiCpp/source/Spatialiser/Reverb.cpp
Other components
- Host application
Connections 19
- Host application → C API: configures and processes
README.md - C API → Simulation context: controls simulation
- Simulation context → Room geometry: manages geometry
RoomAcoustiCpp/source/Spatialiser/Context.cpp - Simulation context → Source manager: initializes sources
RoomAcoustiCpp/source/Spatialiser/Context.cpp - Simulation context → Reverb control: controls reverberation
RoomAcoustiCpp/source/Spatialiser/Context.cpp - Source manager → Audio source: manages sources
- Source manager → Image sources: processes image sources
- Audio processing → Image sources: processes audio
RoomAcoustiCpp/include/Spatialiser/SourceManager.h - Audio processing → FDN reverberation: sends reverb input
RoomAcoustiCpp/include/Spatialiser/SourceManager.h - Audio processing → RAVES reverberation: sends reverb input
RoomAcoustiCpp/include/Spatialiser/SourceManager.h - Image sources → Diffraction models: models diffraction
- Diffraction models → NN-IIR prediction: uses NN-IIR option
- Reverb control → FDN reverberation: selects late model
- Reverb control → RAVES reverberation: selects late model
- Audio processing → DSP filters: filters audio
- Simulation context → Binaural spatializer: uses binaural processing
README.md - Host application → Unity interface: integrates through
README.md - Room geometry → Walls and edges: supports room geometry
- Path tracing → Image sources: generates reflection paths