Skip to content

Structure

All function calls from interface.h get passed to the Context class which controls how this data is passed to other classes in RAC.

Key Classes

  • Context: Represents the main context for the RoomAcoustiC++ library, managing the overall state and configuration.
  • DSPData / DSPConfig: Stores initialization parameters and runtime DSP configuration flags (e.g., enable states and mode selection).
  • Room: Stores the room geometry.
  • SourceManager: Stores sound sources.
  • Source: Represents a sound source within the room.
  • ImageSourceManager: Manages a fixed pool of image sources used for early reflections and diffraction.
  • ImageSource: Represents an image source used for early reflections and diffraction.
  • ImageEdge: Runs the image edge model (IEM).
  • TracingThread: Performs late reverberation ray tracing updates.
  • Reverb: Base class for late reverberation processing (implemented by SingleFDN and RAVES).
    • The RAVES late reverb model implements MoD-ART, while the SingleFDN late reverb model (featured in the original version of RoomAcoustiC++) is closer to RAZR.

Threads

The Context creates a background thread that continuously runs the image edge model at 10ms intervals (or longer if processing exceeds 10ms). When developing RAC, care must be taken to ensure thread safety between the background thread and function calls that will occur on the update thread (geometry and acoustic model configuration updates) and the audio thread. As much as possible, the audio thread should be lock free and avoid the use of std::mutex. Current usage of std::atomic<std::shared_ptr<>>, which is not implemented by compilers in a lock free manner, mean some locks exist.