JailDesigner
d3698a1504
Afig una capa d'efectes oberta a la unitat d'àudio. Els sons puntuals
es poden reproduir processats per un eco o un reverb (Freeverb 8C/4AP)
sense afectar la música ni canviar el camí ràpid existent (playSound
sense efecte segueix sent una sola crida sense cost extra).
- data/sounds.yaml: catàleg de presets nominats (echo: cave/short,
reverb: stone_hall/small_room).
- core/audio/audio_effects: processadors purs que prenen un Ja::Sound
(U8/S16, mono o estèreo) i tornen PCM S16 amb la cua de l'efecte
(cap a 800 ms eco, 1500 ms reverb).
- core/audio/sound_effects_config: Meyers singleton que parseja
sounds.yaml a EchoParams/ReverbParams indexats per nom; l'API
pública d'Audio fa el lookup per nom.
- jail_audio::Engine: nou camí playSoundWith{Echo,Reverb} que empenta
el buffer ja processat a un canal lliure marcat com a has_effect.
El cap MAX_EFFECT_CHANNELS limita a 4 sons amb efecte simultanis;
si està al límit, l'engine retorna -1 i Audio cau a la versió seca.
- Audio::playSoundWith{Echo,Reverb}(name, preset, group) com a única
via pública. Si el preset no existeix, fallback dry amb avís.
- director: load("data/sounds.yaml") abans d'Audio::init.
39 lines
1.5 KiB
C++
39 lines
1.5 KiB
C++
#pragma once
|
|
|
|
#include <SDL3/SDL.h>
|
|
|
|
#include <cstdint>
|
|
#include <optional>
|
|
#include <vector>
|
|
|
|
// Forward-declaració per no incloure jail_audio.hpp (cicle d'inclusió: aquest
|
|
// header viu sota els params declarats a jail_audio.hpp, i alhora jail_audio
|
|
// usa applyEcho/applyReverb).
|
|
namespace Ja {
|
|
struct Sound;
|
|
struct EchoParams;
|
|
struct ReverbParams;
|
|
} // namespace Ja
|
|
|
|
// Processadors d'efectes per a sons puntuals. Reben un Ja::Sound (qualsevol
|
|
// format suportat pel decodificador WAV: U8/S16, mono o estèreo) i tornen un
|
|
// buffer PCM en S16 + el seu spec, llest per empenyer a un SDL_AudioStream.
|
|
//
|
|
// El buffer de sortida inclou la cua (decay) generada per l'efecte: per al
|
|
// reverb, fins a 1500 ms; per a l'eco, fins a 800 ms. Aquests caps eviten
|
|
// allargar indefinidament la reproducció quan els paràmetres reinjecten molt.
|
|
//
|
|
// Si el format del so d'origen no es pot processar, retornen std::nullopt
|
|
// (el caller ha de fer fallback a reproducció seca).
|
|
namespace AudioEffects {
|
|
|
|
struct ProcessedSound {
|
|
std::vector<std::uint8_t> bytes; // PCM S16 entrellaçat (LRLRLR... si stereo)
|
|
SDL_AudioSpec spec; // Format/canals/freqüència del buffer
|
|
};
|
|
|
|
[[nodiscard]] auto applyEcho(const Ja::Sound& src, const Ja::EchoParams& params) -> std::optional<ProcessedSound>;
|
|
[[nodiscard]] auto applyReverb(const Ja::Sound& src, const Ja::ReverbParams& params) -> std::optional<ProcessedSound>;
|
|
|
|
} // namespace AudioEffects
|