diff --git a/docs/audit-core-audio.md b/docs/audit-core-audio.md index 8fecae9..0f5d44e 100644 --- a/docs/audit-core-audio.md +++ b/docs/audit-core-audio.md @@ -72,7 +72,7 @@ Los IDs se mantienen estables una vez asignados. Cada entrada apunta al(los) fic |----|---------------|----------|-----------|--------|-------| | INCONS-01 | `audio.cpp:128,135,142,149,172,180` | Métodos `const` que mutan globals de `Ja` (const miente) | Importante | DONE | `const` tret de 6 mètodes (`playSound` x2, `stopAllSounds`, `fadeOutMusic`, `setSoundVolume`, `setMusicVolume`). `effectiveVolume` es queda `const` (pur sobre membres). Cap caller extern via `const Audio*` | | INCONS-02 | `audio.hpp:44-48` + `jail_audio.hpp:44-50` | Dos `MusicState` paralelos + `getRealMusicState` como puente | Importante | DONE | Eliminat `music_.state` (cache) i `getRealMusicState`. `getMusicState()` consulta Ja::* directament i projecta INVALID/DISABLED → STOPPED. La font de veritat passa a ser Ja. `update()` ja no necessita sincronització | -| INCONS-03 | `audio.cpp` varios | Comentarios mezclan catalán y español | Menor | PENDING | Unificar a catalán | +| INCONS-03 | `audio.cpp` varios | Comentarios mezclan catalán y español | Menor | DONE | Tots els comentaris en castellà passats a català (incloent-hi els dels enums, constants, `--- Secció ---`, includes `Per a ...`, variables membre). Resta els comentaris en català que ja hi eren | | INCONS-04 | `audio.hpp:70,78` | `playMusic` `loop=-1` vs `playSound` `loop=0` | Menor | WONTFIX | Convención razonable (música loop / sonido one-shot); documentar | | INCONS-05 | `audio.hpp:102-105` | 4 formas de enable/disable sound (API redundante) + divergencia con `Ja::enableSound` | Importante | DONE (parcial) | 4 variants no-arg eliminades. La divergència amb `Ja::enableSound/enableMusic` es manté: Audio silencia per gain, Ja pararia els canals; la decisió es posposa a COUP-01 | diff --git a/source/core/audio/audio.cpp b/source/core/audio/audio.cpp index 445b801..c393dc6 100644 --- a/source/core/audio/audio.cpp +++ b/source/core/audio/audio.cpp @@ -1,9 +1,9 @@ #include "core/audio/audio.hpp" -#include // Para SDL_GetError, SDL_Init +#include // Per a SDL_GetError, SDL_Init -#include // Para clamp -#include // Para std::fprintf +#include // Per a clamp +#include // Per a std::fprintf // Implementació de stb_vorbis (ha d'anar ABANS d'incloure jail_audio.hpp). // clang-format off @@ -20,9 +20,9 @@ #undef PLAYBACK_RIGHT // clang-format on -#include "core/audio/audio_adapter.hpp" // Para AudioResource::getMusic/getSound -#include "core/audio/jail_audio.hpp" // Para Ja::* (engine jailgames) -#include "utils/defaults.hpp" // Para Defaults::Audio::FREQUENCY +#include "core/audio/audio_adapter.hpp" // Per a AudioResource::getMusic/getSound +#include "core/audio/jail_audio.hpp" // Per a Ja::* (motor jailgames) +#include "utils/defaults.hpp" // Per a Defaults::Audio::FREQUENCY // Invariant compile-time: tots els valors d'Audio::Group han de cabre als slots // de volum per grup que manté l'engine. Si s'afegeix una nova entrada a Group @@ -36,10 +36,10 @@ std::unique_ptr