Audio performance rework

examples/audio/audio_system_example.py

@@ -3,7 +3,6 @@
 from nexora import Game
 
 from nexora.audio import (
-    AudioChannel,
     AudioSource,
     RepeatMode,
 )
@@ -25,7 +24,7 @@ class AudioSystemExample(Game):
         - fade in / fade out
         - 2D spatial audio
         - listener movement
-        - channel volume
+        - bus volume
         - audio bus volume
         - audio bus mute
         - master volume
@@ -361,7 +360,6 @@ def initialize(
         self.source = AudioSource(
             self.sound,
 
-            channel=AudioChannel.SFX,
 
             volume=1.0,
 
@@ -381,7 +379,6 @@ def initialize(
         self.spatial_source = AudioSource(
             self.sound,
 
-            channel=AudioChannel.SFX,
 
             volume=1.0,
 
@@ -943,8 +940,8 @@ def update(
                 - 0.1,
             )
 
-            self.audio.set_volume(
-                AudioChannel.MASTER,
+            self.audio.set_bus_volume(
+                "Master",
                 self.master_volume,
             )
 
@@ -962,8 +959,8 @@ def update(
                 + 0.1,
             )
 
-            self.audio.set_volume(
-                AudioChannel.MASTER,
+            self.audio.set_bus_volume(
+                "Master",
                 self.master_volume,
             )
 

examples/audio/step_sequencer_ui.py

@@ -7,7 +7,6 @@
 import sdl3
 
 from nexora.audio import (
-    AudioChannel,
     AudioSource,
     AudioSystem,
 )
@@ -219,23 +218,20 @@ def main() -> None:
 
         kick_source = AudioSource(
             kick_sound,
-            channel=AudioChannel.SFX,
             volume=1.0,
             pitch=1.0,
             bus=sfx_bus,
         )
 
         hat_source = AudioSource(
             hat_sound,
-            channel=AudioChannel.SFX,
             volume=0.8,
             pitch=1.0,
             bus=sfx_bus,
         )
 
         snare_source = AudioSource(
             snare_sound,
-            channel=AudioChannel.SFX,
             volume=1.0,
             pitch=1.0,
             bus=sfx_bus,
@@ -569,8 +565,8 @@ def main() -> None:
             emit=False,
         )
 
-        audio.set_volume(
-            AudioChannel.MASTER,
+        audio.set_bus_volume(
+            "Master",
             master_volume,
         )
 
@@ -974,8 +970,8 @@ def master_changed(
 
             master_volume = value
 
-            audio.set_volume(
-                AudioChannel.MASTER,
+            audio.set_bus_volume(
+                "Master",
                 value,
             )
 

nexora/audio/__init__.py

@@ -1,8 +1,23 @@
 from .audio import AudioSystem
 from .buffer import AudioBuffer
 from .bus import AudioBus
-from .channel import AudioChannel
 from .device import AudioDevice
+from .effects import (
+    AudioEffect,
+    GainEffect,
+    LimiterEffect,
+    LowPassFilterEffect,
+    HighPassFilterEffect,
+    ParametricEQEffect,
+    CompressorEffect,
+    DelayEffect,
+    ReverbEffect,
+    DistortionEffect,
+    NoiseGateEffect,
+    StereoWidthEffect,
+)
+from .send import AudioSend
+from .preset import AudioPreset, AudioPresetRegistry, create_builtin_presets
 from .mixer import AudioMixer
 from .player import AudioPlayer
 from .sound import Sound
@@ -16,8 +31,23 @@
     "AudioSystem",
     "AudioBuffer",
     "AudioBus",
-    "AudioChannel",
     "AudioDevice",
+    "AudioEffect",
+    "GainEffect",
+    "LimiterEffect",
+    "LowPassFilterEffect",
+    "HighPassFilterEffect",
+    "ParametricEQEffect",
+    "CompressorEffect",
+    "DelayEffect",
+    "ReverbEffect",
+    "DistortionEffect",
+    "NoiseGateEffect",
+    "StereoWidthEffect",
+    "AudioSend",
+    "AudioPreset",
+    "AudioPresetRegistry",
+    "create_builtin_presets",
     "AudioMixer",
     "MusicPlayer",
     "AudioPlayer",