From e75c8e158605bc18594c094e6ded555b3653f83f Mon Sep 17 00:00:00 2001 From: Alberto Balbo Date: Sun, 8 Nov 2026 14:05:24 +0100 Subject: [PATCH] F6: audio, correzioni della revisione MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I treni suonano solo se si sentono davvero e solo mentre il server li dà in marcia; il fischio all'arrivo, che non poteva mai suonare, è tolto. - Il client non riceve mai un moto Loading (all'arrivo il percorso si svuota e Projection.Motion non manda nulla): via fischio e tromba all'arrivo da AudioManager e documenti; tornerà con una modifica del protocollo decisa a parte. Synth.SteamWhistle e Synth.Horn restano pronti. - Un treno suona solo con un moto ricevuto da meno di 500 ms (GameSession.MotionReceivedMs): fermo in stazione o fuori dalla zona sottoscritta tace invece di restare sull'ultimo moto Moving. - I candidati oltre metà diagonale non prendono un canale: niente Play e Stop a ogni fotogramma. - Clic dei pulsanti collegato una volta sola (IsConnected con un Callable preparato): MarketPanel riattacca il TradeBox a ogni resoconto. - Volumi e muto si salvano all'uscita del pannello e di AudioManager se cambiati, anche chiudendo la finestra con il pannello aperto; lo sfondo chiude solo con il clic sinistro, non con rotella o tasto destro. - Sbuffi da 1,2 a 10 al secondo fino a 30 m/s, in modo lineare: seguono la velocità su tutto l'esercizio; ADR corretto (non è il passo della ruota). - Tabelle d'onda dei temi limitate alle armoniche sotto il 45 % della frequenza di campionamento per nota: niente ripiegamento oltre Nyquist. Refs #46. Co-Authored-By: Claude Opus 5.5 --- .../scripts/Audio/AudioManager.cs | 78 +++++++++---------- .../scripts/Audio/AudioMix.cs | 16 +++- .../scripts/Audio/AudioSettingsPanel.cs | 15 ++-- .../scripts/Audio/MusicComposer.cs | 52 +++++++++---- docs/ARCHITECTURE.md | 2 +- docs/STATE.md | 4 +- docs/adr/0022-audio.md | 36 ++++++--- 7 files changed, 126 insertions(+), 77 deletions(-) diff --git a/client/RailEnterprise.Client/scripts/Audio/AudioManager.cs b/client/RailEnterprise.Client/scripts/Audio/AudioManager.cs index 1158164..29814ba 100644 --- a/client/RailEnterprise.Client/scripts/Audio/AudioManager.cs +++ b/client/RailEnterprise.Client/scripts/Audio/AudioManager.cs @@ -12,9 +12,9 @@ namespace RailEnterprise.Client.Audio; /// /// Regia dell'audio, figlia di Main per tutta la vita del client: bus e volumi, effetti /// dell'interfaccia (clic di ogni pulsante, esito dei comandi), notifiche, cantieri completati, -/// treni vicini al centro della telecamera (rotolamento, motore, sbuffi, fischio all'arrivo), -/// ambiente dal terreno sotto la telecamera e musica per era. Non decide nulla del gioco: reagisce -/// a ciò che il client riceve (esiti, notifiche, DailyDigest, moti dei treni) e alla vista. +/// treni in moto vicini al centro della telecamera (rotolamento, motore, sbuffi), ambiente dal +/// terreno sotto la telecamera e musica per era. Non decide nulla del gioco: reagisce a ciò che il +/// client riceve (esiti, notifiche, DailyDigest, moti dei treni) e alla vista. /// I suoni si sintetizzano all'avvio su un altro thread (, ); /// nel ciclo per fotogramma non si alloca (elenchi preparati, nessuna LINQ). /// @@ -34,7 +34,8 @@ public partial class AudioManager : Node private bool _loaded; // suoni singoli - private AudioStreamWav? _click, _confirm, _error, _build, _whistle, _horn, _chuff; + private AudioStreamWav? _click, _confirm, _error, _build, _chuff; + private readonly Callable _clickCallable; private readonly AudioStreamWav?[] _notify = new AudioStreamWav?[3]; private AudioStreamWav[] _birds = []; private AudioStreamWav? _diesel, _hum; @@ -66,7 +67,13 @@ public partial class AudioManager : Node private readonly TrainChannel[] _channels = new TrainChannel[AudioMix.TrainChannels]; private readonly int[] _nearIds = new int[AudioMix.TrainChannels]; private readonly float[] _nearDistances = new float[AudioMix.TrainChannels]; - private readonly Dictionary _trainStates = []; + + /// + /// Età massima (ms) dell'ultimo moto di un treno perché suoni: il server manda i moti dei treni + /// in marcia ogni 100 ms; un moto più vecchio è di un treno fermo in stazione (durante la sosta + /// non arrivano moti) o uscito dalla zona sottoscritta, e non va più ascoltato. + /// + private const long StaleMotionMs = 500; // musica: due riproduttori per la dissolvenza incrociata private const float MusicLevel = 0.6f; @@ -87,7 +94,8 @@ public partial class AudioManager : Node private MapView? _map; private Dictionary _vehicles = []; private SynthRng _rng = new(0xA0D10); - private ulong _lastUiMs, _lastNotifyMs, _lastWhistleMs; + private ulong _lastUiMs, _lastNotifyMs; + private bool _settingsDirty; // pannello delle impostazioni private CanvasLayer? _overlay; @@ -98,6 +106,7 @@ public partial class AudioManager : Node { _enabled = enabled; Name = "AudioManager"; + _clickCallable = Callable.From(PlayClick); } public AudioManager() : this(true) @@ -119,6 +128,8 @@ public partial class AudioManager : Node { if (Instance == this) Instance = null; Unbind(); + // chiusura della finestra con un volume appena cambiato: si salva comunque + SaveSettings(); } /// Ere di eras.json (id e anno d'inizio, crescenti): scelgono il tema musicale. @@ -147,6 +158,7 @@ public partial class AudioManager : Node public void SetVolume(int bus, float value) { Settings.Volumes[bus] = Math.Clamp(value, 0, 1); + _settingsDirty = true; ApplySettings(); SettingsChanged?.Invoke(); } @@ -154,6 +166,7 @@ public partial class AudioManager : Node public void SetMuted(bool muted) { Settings.Muted = muted; + _settingsDirty = true; ApplySettings(); SettingsChanged?.Invoke(); } @@ -161,10 +174,16 @@ public partial class AudioManager : Node public void ToggleMute() { SetMuted(!Settings.Muted); - Settings.Save(); + SaveSettings(); } - public void SaveSettings() => Settings.Save(); + /// Scrive volumi e muto in user://settings.cfg se sono cambiati dall'ultimo salvataggio. + public void SaveSettings() + { + if (!_settingsDirty) return; + _settingsDirty = false; + Settings.Save(); + } /// Apre il pannello «Audio» sopra a tutto (menu o partita). public void ShowSettings() @@ -212,7 +231,6 @@ public partial class AudioManager : Node if (_session is not null) _session.MessageApplied -= OnMessage; _session = null; _map = null; - _trainStates.Clear(); } private void OnMessage(IMessage message) @@ -220,11 +238,6 @@ public partial class AudioManager : Node if (!_loaded) return; switch (message) { - case TrainMotion m: - byte previous = _trainStates.TryGetValue(m.TrainId, out byte p) ? p : (byte)255; - _trainStates[m.TrainId] = m.State; - if (previous == (byte)TrainState.Moving && m.State == (byte)TrainState.Loading) Whistle(m.TrainId); - break; case CommandResultMessage r: PlayUi(r.Ok ? _confirm : _error, r.Ok ? 0.7f : 0.85f); break; @@ -243,9 +256,6 @@ public partial class AudioManager : Node } } break; - case Welcome: - _trainStates.Clear(); - break; } } @@ -266,7 +276,9 @@ public partial class AudioManager : Node private void OnNodeAdded(Node node) { - if (node is BaseButton button) button.Pressed += PlayClick; + // un pulsante staccato e riattaccato (MarketPanel lo fa a ogni resoconto) è già collegato + if (node is BaseButton button && !button.IsConnected(BaseButton.SignalName.Pressed, _clickCallable)) + button.Connect(BaseButton.SignalName.Pressed, _clickCallable); } private void PlayClick() => PlayUi(_click, 0.6f); @@ -290,13 +302,13 @@ public partial class AudioManager : Node /// Campioni di tutti gli effetti e degli anelli, sintetizzati fuori dal thread principale. private sealed class SoundBank { - public required float[] Click, Confirm, Error, Construction, Whistle, Horn, Chuff, Rumble, Diesel, Hum, Wind, River, Sea, City; + public required float[] Click, Confirm, Error, Construction, Chuff, Rumble, Diesel, Hum, Wind, River, Sea, City; public required float[][] Notify, Birds; public static SoundBank Create() => new() { Click = Synth.Click(), Confirm = Synth.Confirm(), Error = Synth.Error(), Construction = Synth.BuildComplete(), - Whistle = Synth.SteamWhistle(), Horn = Synth.Horn(), Chuff = Synth.Chuff(), Rumble = Synth.RailRumbleLoop(), + Chuff = Synth.Chuff(), Rumble = Synth.RailRumbleLoop(), Diesel = Synth.DieselDroneLoop(), Hum = Synth.ElectricHumLoop(), Wind = Synth.WindLoop(), River = Synth.RiverLoop(), Sea = Synth.SeaLoop(), City = Synth.CityLoop(), Notify = [Synth.Notify(0), Synth.Notify(1), Synth.Notify(2)], @@ -342,8 +354,6 @@ public partial class AudioManager : Node _confirm = Wav(bank.Confirm); _error = Wav(bank.Error); _build = Wav(bank.Construction); - _whistle = Wav(bank.Whistle); - _horn = Wav(bank.Horn); _chuff = Wav(bank.Chuff); for (int i = 0; i < _notify.Length; i++) _notify[i] = Wav(bank.Notify[i]); _birds = bank.Birds.Select(b => Wav(b)).ToArray(); @@ -517,15 +527,20 @@ public partial class AudioManager : Node int count = 0; Vector2 center = default; float zoom = 1, radius = 1; - if (w is not null && map is not null && w.Speed > 0) + if (w is not null && map is not null && _session is { } session && w.Speed > 0) { center = map.Camera.GetScreenCenterPosition(); zoom = map.Zoom; radius = map.GetViewportRect().Size.Length() / 2; + long now = (long)Time.GetTicksMsec(); foreach (var (id, head) in map.Trains.Heads) { if (!w.Motions.TryGetValue(id, out var m) || m.State != (byte)TrainState.Moving || m.Speed < 0.5f) continue; - count = AudioMix.InsertNearest(_nearIds, _nearDistances, count, id, head.DistanceTo(center) * zoom); + if (!session.MotionReceivedMs.TryGetValue(id, out long at) || now - at > StaleMotionMs) continue; + // oltre il raggio non si sentirebbe: niente canale (eviterebbe Play e Stop a ogni fotogramma) + float distance = head.DistanceTo(center) * zoom; + if (distance >= radius) continue; + count = AudioMix.InsertNearest(_nearIds, _nearDistances, count, id, distance); } } // i canali restano ai loro treni finché sono tra i più vicini; gli altri sfumano @@ -625,19 +640,4 @@ public partial class AudioManager : Node } return Traction.Steam; } - - /// Fischio (vapore) o tromba all'arrivo in stazione di un treno visibile vicino al centro. - private void Whistle(int train) - { - var w = _session?.World; - if (w is null || _map is null || !_map.Trains.Heads.TryGetValue(train, out var head)) return; - ulong now = Time.GetTicksMsec(); - if (now - _lastWhistleMs < 700) return; - float zoom = _map.Zoom; - float d = head.DistanceTo(_map.Camera.GetScreenCenterPosition()) * zoom; - float gain = AudioMix.TrainGain(d, _map.GetViewportRect().Size.Length() * 0.6f, AudioMix.FullSpeedMs, zoom); - if (gain < 0.03f) return; - _lastWhistleMs = now; - Play(_sfx, TractionOf(train, w) == Traction.Steam ? _whistle : _horn, gain * 0.9f, _rng.Range(0.97f, 1.03f), _busSfx); - } } diff --git a/client/RailEnterprise.Client/scripts/Audio/AudioMix.cs b/client/RailEnterprise.Client/scripts/Audio/AudioMix.cs index 4ababaa..6273967 100644 --- a/client/RailEnterprise.Client/scripts/Audio/AudioMix.cs +++ b/client/RailEnterprise.Client/scripts/Audio/AudioMix.cs @@ -30,8 +30,10 @@ public static class AudioMix public const int TrainChannels = 3; /// Velocità (m/s) a cui il rotolamento è al massimo. public const float FullSpeedMs = 25f; - /// Metri percorsi tra due sbuffi: ruota motrice di circa 1,6 m, quattro sbuffi a giro. - public const float ChuffSpacingM = 1.26f; + /// Sbuffi al secondo da fermo (al passo) e alla velocità . + public const float ChuffMinRate = 1.2f, ChuffMaxRate = 10f; + /// Velocità (m/s, circa 110 km/h) a cui gli sbuffi sono più fitti. + public const float ChuffFullSpeedMs = 30f; public static float Clamp01(float x) => x < 0 ? 0 : x > 1 ? 1 : x; @@ -83,8 +85,14 @@ public static class AudioMix /// Intonazione del motore (diesel o elettrico) con la velocità. public static float EnginePitch(float speedMs) => 0.8f + 0.5f * Clamp01(speedMs / FullSpeedMs); - /// Secondi tra due sbuffi della vaporiera alla velocità data. - public static float ChuffInterval(float speedMs) => Math.Clamp(ChuffSpacingM / MathF.Max(speedMs, 0.5f), 0.09f, 1.2f); + /// + /// Secondi tra due sbuffi della vaporiera alla velocità data: la frequenza cresce in modo lineare + /// da a fino a , + /// così segue la velocità su tutto l'esercizio normale. È una resa sonora, non il passo reale della + /// ruota: sullo schermo il tempo dei treni corre decine di volte più veloce e gli sbuffi reali + /// sarebbero un ronzio continuo. + /// + public static float ChuffInterval(float speedMs) => 1f / (ChuffMinRate + (ChuffMaxRate - ChuffMinRate) * Clamp01(speedMs / ChuffFullSpeedMs)); /// /// Inserisce un candidato nell'elenco ordinato dei più vicini (al più ids.Length): nessuna diff --git a/client/RailEnterprise.Client/scripts/Audio/AudioSettingsPanel.cs b/client/RailEnterprise.Client/scripts/Audio/AudioSettingsPanel.cs index ef94c42..4e9abe3 100644 --- a/client/RailEnterprise.Client/scripts/Audio/AudioSettingsPanel.cs +++ b/client/RailEnterprise.Client/scripts/Audio/AudioSettingsPanel.cs @@ -6,8 +6,9 @@ namespace RailEnterprise.Client.Audio; /// /// Pannello «Audio» sopra a tutto: un cursore per bus (generale, musica, ambiente, effetti, -/// interfaccia) e il muto generale. I cambi si sentono subito; alla chiusura si salvano in -/// user://settings.cfg. Esc o un clic fuori chiudono. +/// interfaccia) e il muto generale. I cambi si sentono subito; quando il pannello esce dall'albero +/// (anche chiudendo la finestra del gioco) si salvano in user://settings.cfg. Esc o un clic +/// sinistro fuori chiudono. /// public partial class AudioSettingsPanel : Control { @@ -27,7 +28,8 @@ public partial class AudioSettingsPanel : Control shade.SetAnchorsPreset(LayoutPreset.FullRect); shade.GuiInput += e => { - if (e is InputEventMouseButton { Pressed: true }) Close(); + // solo il clic sinistro: la rotella e il tasto destro arrivano anch'essi come pressioni + if (e is InputEventMouseButton { Pressed: true, ButtonIndex: MouseButton.Left }) Close(); }; AddChild(shade); var center = new CenterContainer { MouseFilter = MouseFilterEnum.Ignore }; @@ -75,7 +77,11 @@ public partial class AudioSettingsPanel : Control Refresh(); } - public override void _ExitTree() => _audio.SettingsChanged -= Refresh; + public override void _ExitTree() + { + _audio.SettingsChanged -= Refresh; + _audio.SaveSettings(); + } private void Refresh() { @@ -99,7 +105,6 @@ public partial class AudioSettingsPanel : Control private void Close() { if (IsQueuedForDeletion()) return; - _audio.SaveSettings(); QueueFree(); } } diff --git a/client/RailEnterprise.Client/scripts/Audio/MusicComposer.cs b/client/RailEnterprise.Client/scripts/Audio/MusicComposer.cs index fd2431a..985a4c7 100644 --- a/client/RailEnterprise.Client/scripts/Audio/MusicComposer.cs +++ b/client/RailEnterprise.Client/scripts/Audio/MusicComposer.cs @@ -50,7 +50,8 @@ public static class MusicComposer private sealed class Voice { - public required float[] Table { get; init; } + /// Ampiezza della n-esima armonica in Harmonics[n−1]. + public required float[] Harmonics { get; init; } public float Attack { get; init; } = 0.005f; /// Decadimento verso il sostegno (s). public float Decay { get; init; } = 0.3f; @@ -61,19 +62,41 @@ public static class MusicComposer public float TremoloHz { get; init; } public float TremoloDepth { get; init; } public float VibratoDepth { get; init; } + + // tabelle per numero di armoniche tenute (una per registro, costruite al primo uso) + private readonly Dictionary _tables = []; + + /// + /// Forma d'onda per una nota alla frequenza data, con le sole armoniche sotto + /// della frequenza di campionamento: quelle oltre Nyquist + /// tornerebbero indietro come toni stonati. + /// + public float[] TableFor(float frequency) + { + int n = Math.Clamp((int)(MaxHarmonicShare * Synth.Rate / frequency), 1, Harmonics.Length); + if (!_tables.TryGetValue(n, out var table)) + { + table = Table(Harmonics, n); + _tables[n] = table; + } + return table; + } } + /// Frazione della frequenza di campionamento sotto cui stanno le armoniche (margine per vibrato e coro). + private const float MaxHarmonicShare = 0.45f; + private const int TableSize = 2048; - /// Forma d'onda di un periodo dalla somma di armoniche (ampiezza della n-esima in harmonics[n−1]). - private static float[] Table(params float[] harmonics) + /// Forma d'onda di un periodo dalla somma delle prime «count» armoniche (ampiezza della n-esima in harmonics[n−1]). + private static float[] Table(float[] harmonics, int count) { var t = new float[TableSize]; for (int i = 0; i < TableSize; i++) { float x = MathF.PI * 2 * i / TableSize; float v = 0; - for (int h = 0; h < harmonics.Length; h++) v += harmonics[h] * MathF.Sin(x * (h + 1)); + for (int h = 0; h < count; h++) v += harmonics[h] * MathF.Sin(x * (h + 1)); t[i] = v; } Synth.Normalize(t, 1); @@ -96,15 +119,15 @@ public static class MusicComposer private static Voice VoiceFor(Timbre timbre) => timbre switch { - Timbre.MusicBox => new Voice { Table = Table(1, 0.1f, 0.35f, 0, 0.12f), Attack = 0.002f, Decay = 0.7f, Sustain = 0, Release = 0.6f }, - Timbre.Accordion => new Voice { Table = Table(1, 0.5f, 0.6f, 0.3f, 0.25f, 0.15f), Attack = 0.03f, Decay = 0.2f, Sustain = 0.8f, Release = 0.08f, Detune = [0, 0.004f], TremoloHz = 5, TremoloDepth = 0.12f }, - Timbre.Organ => new Voice { Table = Table(1, 0.8f, 0.6f, 0.4f, 0, 0.3f, 0, 0.2f), Attack = 0.01f, Decay = 0.1f, Sustain = 0.9f, Release = 0.06f, TremoloHz = 6, TremoloDepth = 0.1f }, - Timbre.Vibraphone => new Voice { Table = Table(1, 0, 0, 0.25f), Attack = 0.003f, Decay = 1.1f, Sustain = 0, Release = 0.8f, TremoloHz = 5, TremoloDepth = 0.3f }, - Timbre.Strings => new Voice { Table = Table(SawHarmonics(8)), Attack = 0.3f, Decay = 0.5f, Sustain = 0.85f, Release = 0.35f, Detune = [-0.003f, 0, 0.003f], VibratoDepth = 0.003f }, - Timbre.Pulse => new Voice { Table = Table(PulseHarmonics(9, 0.25f)), Attack = 0.004f, Decay = 0.22f, Sustain = 0, Release = 0.15f }, - Timbre.Saw => new Voice { Table = Table(SawHarmonics(10)), Attack = 0.08f, Decay = 0.4f, Sustain = 0.7f, Release = 0.25f, Detune = [-0.005f, 0.005f], VibratoDepth = 0.002f }, - Timbre.PluckBass => new Voice { Table = Table(1, 0.5f, 0.25f, 0.1f), Attack = 0.005f, Decay = 0.35f, Sustain = 0.15f, Release = 0.08f }, - _ => new Voice { Table = Table(1, 0.3f, 0.1f), Attack = 0.01f, Decay = 0.4f, Sustain = 0.6f, Release = 0.1f }, + Timbre.MusicBox => new Voice { Harmonics = [1, 0.1f, 0.35f, 0, 0.12f], Attack = 0.002f, Decay = 0.7f, Sustain = 0, Release = 0.6f }, + Timbre.Accordion => new Voice { Harmonics = [1, 0.5f, 0.6f, 0.3f, 0.25f, 0.15f], Attack = 0.03f, Decay = 0.2f, Sustain = 0.8f, Release = 0.08f, Detune = [0, 0.004f], TremoloHz = 5, TremoloDepth = 0.12f }, + Timbre.Organ => new Voice { Harmonics = [1, 0.8f, 0.6f, 0.4f, 0, 0.3f, 0, 0.2f], Attack = 0.01f, Decay = 0.1f, Sustain = 0.9f, Release = 0.06f, TremoloHz = 6, TremoloDepth = 0.1f }, + Timbre.Vibraphone => new Voice { Harmonics = [1, 0, 0, 0.25f], Attack = 0.003f, Decay = 1.1f, Sustain = 0, Release = 0.8f, TremoloHz = 5, TremoloDepth = 0.3f }, + Timbre.Strings => new Voice { Harmonics = SawHarmonics(8), Attack = 0.3f, Decay = 0.5f, Sustain = 0.85f, Release = 0.35f, Detune = [-0.003f, 0, 0.003f], VibratoDepth = 0.003f }, + Timbre.Pulse => new Voice { Harmonics = PulseHarmonics(9, 0.25f), Attack = 0.004f, Decay = 0.22f, Sustain = 0, Release = 0.15f }, + Timbre.Saw => new Voice { Harmonics = SawHarmonics(10), Attack = 0.08f, Decay = 0.4f, Sustain = 0.7f, Release = 0.25f, Detune = [-0.005f, 0.005f], VibratoDepth = 0.002f }, + Timbre.PluckBass => new Voice { Harmonics = [1, 0.5f, 0.25f, 0.1f], Attack = 0.005f, Decay = 0.35f, Sustain = 0.15f, Release = 0.08f }, + _ => new Voice { Harmonics = [1, 0.3f, 0.1f], Attack = 0.01f, Decay = 0.4f, Sustain = 0.6f, Release = 0.1f }, }; private static float Frequency(float midi) => 440f * MathF.Pow(2, (midi - 69) / 12f); @@ -114,6 +137,7 @@ public static class MusicComposer { int rate = Synth.Rate; float f = Frequency(midi); + var table = v.TableFor(f); int start = (int)(startS * rate); float total = durS + v.Release; int samples = Math.Min(loop.Length, (int)(total * rate)); @@ -138,7 +162,7 @@ public static class MusicComposer if (phase >= TableSize) phase -= TableSize; int i0 = (int)phase; float frac = phase - i0; - float s = v.Table[i0] + (v.Table[(i0 + 1) & (TableSize - 1)] - v.Table[i0]) * frac; + float s = table[i0] + (table[(i0 + 1) & (TableSize - 1)] - table[i0]) * frac; loop[(start + i) % loop.Length] += s * env * g; } } diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index ec79f31..95bc346 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -128,7 +128,7 @@ Requisito: stesso seme + stessi comandi agli stessi tick ⇒ stesso hash di stat - `GameSession` applica i messaggi a `ClientWorld` (Protocol) sul thread principale; i comandi sono l'unico modo di cambiare il mondo; le anteprime del tracciato usano `TrackPreview` di Core. - `MapView` (Node2D + Camera2D): `TerrainLayer` (texture per chunk con fasce, ombreggiatura, sponde e curve di livello; shader per le rive), `EntityLayer` (case, industrie, stazioni, depositi, alberi in MultiMesh), `TrackLayer` (massicciata, traversine, rotaie, opere, cantieri, segnali), `TrainLayer` (veicoli interpolati, fumo, avvisi), `ToolOverlay`; `LabelLayer` disegna le etichette in coordinate schermo. - HUD: `TopBar` (con l'altoparlante dell'audio), `Toolbar`, pannello destro (pannelli degli strumenti e schede) con `Minimap`, `Ticker`. Pannelli: binari con profilo, stazione, deposito, treni, linee, officine (politica della flotta, avvisi, flotta per condizione, cartella di manutenzione, Registro officina, scorta di ricambi, mappa di calore), impieghi (Registro degli impieghi e convenzioni), mercato, finanze; a tutto schermo «Compagnie e borsa», «Mercato globale» (`MarketPanel`, immagine 06) e «La tua scalata» (`ClimbPanel`, immagine 08: binario dei livelli, storico del patrimonio con `SeriesChart` e i livelli segnati, requisiti, stato patrimoniale, conto economico, prestiti), che si apre anche dal livello nella `TopBar`; scheda dell'entità (con manutenzione del treno, lavoratori dell'industria, dove lavorano gli abitanti, avvisi degli eventi in corso). Sopra la minimappa il riquadro «Eventi in corso» (`WorldEventsBox`, testi in `WorldEventText`) elenca gli eventi del mondo del `DailyDigest`; il Mercato globale mostra quelli sulla domanda di un bene. -- Audio (`scripts/Audio/`, ADR 0022): `AudioManager`, figlio di `Main` con `AudioManager.Instance`, crea i bus `Music`, `Ambience`, `Sfx`, `Ui` (`AudioBuses.Ensure`, idempotente), applica i volumi di `AudioSettings` (`user://settings.cfg`, sezione `audio`) e reagisce a ciò che il client riceve: clic dei pulsanti (segnale `node_added`), esiti dei comandi, `Notification`, cantieri completati nel `DailyDigest`, arrivi dei treni (`TrainMotion` da `Moving` a `Loading`), treni visibili vicini al centro (`TrainLayer.Heads`, al più 3 canali), terreno e zoom della vista per l'ambiente, anno corrente per il tema dell'era. I suoni si sintetizzano su un altro thread con classi senza Godot: `Synth` (effetti e anelli senza scatti), `MusicComposer` (temi per era da un seme fisso), `AudioMix` (miscelazione, scelta dei treni senza allocazioni, PCM). Pannello `AudioSettingsPanel` (dal menu e da `SpeakerButton` nella `TopBar`), tasto M per il muto; nel pilota automatico l'audio è spento. +- Audio (`scripts/Audio/`, ADR 0022): `AudioManager`, figlio di `Main` con `AudioManager.Instance`, crea i bus `Music`, `Ambience`, `Sfx`, `Ui` (`AudioBuses.Ensure`, idempotente), applica i volumi di `AudioSettings` (`user://settings.cfg`, sezione `audio`) e reagisce a ciò che il client riceve: clic dei pulsanti (segnale `node_added`), esiti dei comandi, `Notification`, cantieri completati nel `DailyDigest`, treni visibili in moto vicini al centro (`TrainLayer.Heads`, al più 3 canali, solo con un moto recente in `GameSession.MotionReceivedMs`), terreno e zoom della vista per l'ambiente, anno corrente per il tema dell'era. I suoni si sintetizzano su un altro thread con classi senza Godot: `Synth` (effetti e anelli senza scatti), `MusicComposer` (temi per era da un seme fisso), `AudioMix` (miscelazione, scelta dei treni senza allocazioni, PCM). Pannello `AudioSettingsPanel` (dal menu e da `SpeakerButton` nella `TopBar`), tasto M per il muto; nel pilota automatico l'audio è spento. - Collaudo: pilota automatico (`-- --autopilot cartella`, `scripts/client-autopilot.sh`) con schermate. ## 10. Prestazioni diff --git a/docs/STATE.md b/docs/STATE.md index 2d44f88..60abe8c 100644 --- a/docs/STATE.md +++ b/docs/STATE.md @@ -144,7 +144,7 @@ Aggiornato alla fine di ogni fase (guida, sezione 18). - **Audio (issue #46, ADR 0022)**: - solo client, nessun file audio: effetti, anelli e temi sintetizzati in memoria all'avvio su un altro thread da classi senza dipendenze da Godot (`Synth`, `MusicComposer`, `AudioMix` in `scripts/Audio/`), semi fissi, PCM a 16 bit in `AudioStreamWav`; - bus `Master`, `Music`, `Ambience`, `Sfx`, `Ui` creati da codice in modo idempotente, limitatore sul Master; volumi per bus e muto generale nella sezione `audio` di `user://settings.cfg`; pannello «Audio» dal menu e dall'altoparlante nella barra superiore, tasto M per il muto; - - `AudioManager` (figlio di `Main`): clic di ogni pulsante, conferma ed errore dagli esiti dei comandi, campanelle per opportunità, avvisi e notizie critiche, «cantiere completato» dal `DailyDigest`; fino a 3 treni in moto vicini al centro dello schermo con rotolamento, motore diesel o ronzio elettrico e sbuffi del vapore modulati dalla velocità, fischio o tromba all'arrivo in stazione (`Moving` → `Loading`); ambiente (vento e uccelli in campagna, fiume e lago, mare, città) dalla griglia del terreno visibile e dallo zoom; tema per era dall'anno corrente con dissolvenza incrociata di 3 s; + - `AudioManager` (figlio di `Main`): clic di ogni pulsante, conferma ed errore dagli esiti dei comandi, campanelle per opportunità, avvisi e notizie critiche, «cantiere completato» dal `DailyDigest`; fino a 3 treni in moto vicini al centro dello schermo con rotolamento, motore diesel o ronzio elettrico e sbuffi del vapore modulati dalla velocità (solo con un moto ricevuto da meno di 500 ms ed entro metà della diagonale dello schermo); ambiente (vento e uccelli in campagna, fiume e lago, mare, città) dalla griglia del terreno visibile e dallo zoom; tema per era dall'anno corrente con dissolvenza incrociata di 3 s; - nel pilota automatico e senza schermo niente sintesi e Master muto; testi in `strings.csv`; - nessun test nel harness (il client non è referenziato): le funzioni pure sono state provate a parte (nessun NaN, picchi entro i limiti, anelli senza salti, temi identici a ogni composizione; circa 0,1 s per gli effetti, 0,1–0,4 s per tema). Non ascoltato: qui manca l'editor. 194 test (175 senza i lenti), invariati. - Restano della F6: ere e obsolescenza, pannello 07, tooltip «perché», tutorial, bilanciamento con i bot. @@ -161,7 +161,7 @@ Aggiornato alla fine di ogni fase (guida, sezione 18). - Nella vista d'insieme i fiumi larghi una cella mostrano ancora gradini. Le immagini di riferimento 06–09 sono arrivate (novembre 2026): il Mercato globale è allineato alla 06 e «La tua scalata» alla 08 (F6, non ancora provati in Godot: qui manca l'editor); Industria e la schermata di connessione vanno allineati in F6. - Compravendita in proprio (ADR 0016): la quotazione nel pannello non considera la cassa delle industrie compratrici; una spedizione tiene occupato lo spazio di destinazione per tutto il viaggio; se una linea sparisce durante il viaggio la merce si ferma nel magazzino della stazione dove si trova anche oltre la capacità; un treno che lascia la linea in viaggio lascia la merce propria alla prossima fermata senza percorrere il tratto; la merce in attesa in stazione scade come le altre merci (la scadenza riparte a ogni trasbordo); il riquadro non è ancora stato provato in Godot (qui manca l'editor). - Eventi del mondo (ADR 0017): le medie mobili (coperture a 30 giorni, margini) si riprendono gradualmente dopo un evento; il maltempo prende un arco per intero secondo il suo punto medio; la notizia di fine arriva la sera dell'ultimo giorno; il riquadro mostra al massimo quattro eventi; le IA non reagiscono; client non ancora provato in Godot (qui manca l'editor). -- Audio (ADR 0022): suoni mono senza panoramica; timbri semplici di sintesi, da tarare all'ascolto (non ancora provati in Godot: qui manca l'editor); il fischio all'arrivo suona solo per i treni visibili di cui il client riceve il moto. +- Audio (ADR 0022): suoni mono senza panoramica; timbri semplici di sintesi, da tarare all'ascolto (non ancora provati in Godot: qui manca l'editor); niente fischio all'arrivo in stazione: il client non riceve moti `Loading` (all'arrivo il server non manda moti), serve una modifica del protocollo con una decisione a parte. - Mercato globale (ADR 0015): la previsione segue solo la componente mondiale (ciclo e shock), non domanda e offerta della mappa; «Dove conviene vendere» dà il prezzo alla destinazione, senza il costo del trasporto. - Scalata (ADR 0018): il livello non scende; lo storico del patrimonio ha un punto all'anno (più la fondazione e oggi); il capitale iniziale mostrato è quello della difficoltà; il valore contabile si aggiorna a inizio mese, mentre cassa, partecipazioni e debiti sono del giorno; i salvataggi delle versioni 1–5 ripartiscono il totale degli attivi in proporzione alle voci del giorno di caricamento fino al ricalcolo del mese; il pannello non è ancora stato provato in Godot (qui manca l'editor). - In F3 tutte le sessioni guidano la compagnia del giocatore (ADR 0009). diff --git a/docs/adr/0022-audio.md b/docs/adr/0022-audio.md index b13ce9f..de0aaa7 100644 --- a/docs/adr/0022-audio.md +++ b/docs/adr/0022-audio.md @@ -21,28 +21,36 @@ non si possono ascoltare qui: il codice deve essere verificabile almeno nella pa `default_bus_layout.tres`, così il progetto resta senza risorse da importare con l'editor. 3. **Impostazioni**: volume per bus (0–1, guadagno = valore², cioè circa il volume percepito) e muto generale nella sezione `audio` di `user://settings.cfg`, lo stesso file di lingua e server. Pannello - «Audio» sopra a tutto (dal menu e dall'altoparlante nella barra superiore); il tasto **M** attiva e - toglie il muto (solo se nessun campo di testo ha il fuoco: è un input non gestito). + «Audio» sopra a tutto (dal menu e dall'altoparlante nella barra superiore; si chiude con Esc, «Chiudi» + o un clic sinistro fuori); il tasto **M** attiva e toglie il muto (solo se nessun campo di testo ha il + fuoco: è un input non gestito). I cambi si salvano quando il pannello esce dall'albero e all'uscita + di `AudioManager`, anche chiudendo la finestra con il pannello aperto (solo se qualcosa è cambiato). 4. **`AudioManager`** è un figlio di `Main` (non un autoload: nessuna modifica a `project.godot`), con `AudioManager.Instance`. Reagisce solo a ciò che il client riceve già: - - clic di ogni `BaseButton` (agganciato dal segnale `node_added` dell'albero: i pannelli non cambiano); + - clic di ogni `BaseButton` (agganciato dal segnale `node_added` dell'albero: i pannelli non cambiano; + un pulsante staccato e riattaccato non si ricollega, si controlla `IsConnected`); - `CommandResultMessage`: conferma o errore; - `Notification`: campanella per opportunità, avviso, critica (una sola ogni 0,6 s, le critiche sempre); - `DailyDigest`: «cantiere completato» se c'è un evento `Construction` della compagnia del giocatore (gli eventi informativi arrivano solo dal resoconto, non come `Notification`); - - `TrainMotion`: il passaggio da `Moving` a `Loading` di un treno visibile vicino al centro della - telecamera fa fischiare la vaporiera o suonare la tromba (diesel ed elettrici); - vista: fino a 3 treni in moto tra quelli disegnati (`TrainLayer.Heads`), i più vicini al centro - dello schermo, hanno un canale con rotolamento (intonazione dalla velocità), motore diesel o ronzio - elettrico, e sbuffi per il vapore ogni 1,26 m percorsi (ruota motrice di circa 1,6 m, quattro sbuffi - a giro, tra 0,09 e 1,2 s); il volume scende con la distanza in pixel e allontanando lo zoom; in pausa - tacciono; + dello schermo ed entro metà della diagonale (oltre non si sentirebbero), hanno un canale con + rotolamento (intonazione dalla velocità), motore diesel o ronzio elettrico, e sbuffi per il vapore + da 1,2 al secondo al passo a 10 al secondo a 30 m/s (circa 110 km/h), in modo lineare: è una resa + sonora, non il passo della ruota, perché sullo schermo il tempo dei treni corre decine di volte più + veloce e non dipende dalla velocità di gioco; il volume scende con la distanza in pixel e + allontanando lo zoom; in pausa tacciono. Un treno suona solo se il suo ultimo moto ha meno di + 500 ms (il server li manda ogni 100 ms ai treni in marcia): durante la sosta in stazione il server + non manda moti e l'ultimo ricevuto, ancora `Moving` con la velocità di frenata, resterebbe + nel mondo del client; lo stesso per un treno uscito dalla zona sottoscritta; - ambiente: ogni 0,25 s una griglia 8×8 sulla vista (allargata di un quarto) conta fiume, lago, mare, città e industrie, bosco, campagna; `AudioMix.Ambience` ne ricava i guadagni di vento, acqua, mare e città con lo zoom (da lontano quasi solo vento) e la probabilità degli uccelli da vicino in campagna; - musica: l'era viene dall'anno corrente (`ClientWorld.Year`) e da `eras.json`; al cambio d'era il tema nuovo entra con una dissolvenza incrociata di 3 s su due riproduttori; nel menu suona il tema della - prima era. + prima era. Le tabelle d'onda dei temi tengono per ogni nota solo le armoniche sotto il 45 % della + frequenza di campionamento (una tabella per numero di armoniche), così le note acute non + ripiegano oltre Nyquist. 5. **Prestazioni**: la sintesi gira su un altro thread (`Task.Run`: circa 0,1 s per gli effetti, 0,1–0,4 s per tema, solo quando serve); nel ciclo per fotogramma niente LINQ né allocazioni (elenchi dei treni preparati, `StringName` dei bus già pronti, un riproduttore polifonico per bus per i suoni brevi). @@ -56,8 +64,12 @@ non si possono ascoltare qui: il codice deve essere verificabile almeno nella pa - I suoni sono mono, senza panoramica destra–sinistra: i treni si distinguono per volume, non per lato. - Le costanti di resa sonora (livelli, zoom di riferimento, numero di canali) stanno in `AudioMix` e in `AudioManager`: sono del client, non della simulazione, e non vanno in `data/*.json`. -- Il fischio richiede che il client riceva il moto del treno nel momento dell'arrivo: con treni fuori - dalla zona sottoscritta non suona (comunque non sarebbero vicini alla telecamera). +- **Niente fischio né tromba all'arrivo in stazione.** All'arrivo il server svuota il percorso del + treno e `Projection.Motion` non produce moti per un treno senza percorso: il client non riceve mai + un moto `Loading`, quindi il passaggio `Moving` → `Loading` non è osservabile. Dedurre l'arrivo nel + client (moti che smettono di arrivare) sarebbe logica di gioco. Il fischio tornerà quando il protocollo + manderà lo stato del treno fermo (decisione e issue a parte, perché tocca il server); + `Synth.SteamWhistle` e `Synth.Horn` restano pronti per allora, ma non si sintetizzano all'avvio. - Nessun test nel harness: le classi pure sono nel progetto Godot, che il harness non referenzia; sono state provate a parte (nessun NaN, picchi entro i limiti, anelli senza salti, temi identici a ogni composizione). Nessun ascolto possibile qui.