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.