F6: audio, correzioni della revisione
CI / Build e test (pull_request) Successful in 1m32s
CI / Immagine Docker (pull_request) Successful in 31s

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 <noreply@anthropic.com>
This commit is contained in:
Alby96andClaude Opus 5.5 committed 2026-11-08 14:05:24 +01:00
1 parent b1ee6879a7
commit e75c8e1586
7 files changed
+126 -77

No files matched your search

@@ -12,9 +12,9 @@ namespace RailEnterprise.Client.Audio;
/// <summary>
/// Regia dell'audio, figlia di <c>Main</c> 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, <c>DailyDigest</c>, 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, <c>DailyDigest</c>, moti dei treni) e alla vista.
/// I suoni si sintetizzano all'avvio su un altro thread (<see cref="Synth"/>, <see cref="MusicComposer"/>);
/// nel ciclo per fotogramma non si alloca (elenchi preparati, nessuna LINQ).
/// </summary>
@@ -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<int, byte> _trainStates = [];
/// <summary>
/// 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.
/// </summary>
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<string, VehicleDef> _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();
}
/// <summary>Ere di eras.json (id e anno d'inizio, crescenti): scelgono il tema musicale.</summary>
@@ -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();
/// <summary>Scrive volumi e muto in <c>user://settings.cfg</c> se sono cambiati dall'ultimo salvataggio.</summary>
public void SaveSettings()
{
if (!_settingsDirty) return;
_settingsDirty = false;
Settings.Save();
}
/// <summary>Apre il pannello «Audio» sopra a tutto (menu o partita).</summary>
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
/// <summary>Campioni di tutti gli effetti e degli anelli, sintetizzati fuori dal thread principale.</summary>
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;
}
/// <summary>Fischio (vapore) o tromba all'arrivo in stazione di un treno visibile vicino al centro.</summary>
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);
}
}
@@ -30,8 +30,10 @@ public static class AudioMix
public const int TrainChannels = 3;
/// <summary>Velocità (m/s) a cui il rotolamento è al massimo.</summary>
public const float FullSpeedMs = 25f;
/// <summary>Metri percorsi tra due sbuffi: ruota motrice di circa 1,6 m, quattro sbuffi a giro.</summary>
public const float ChuffSpacingM = 1.26f;
/// <summary>Sbuffi al secondo da fermo (al passo) e alla velocità <see cref="ChuffFullSpeedMs"/>.</summary>
public const float ChuffMinRate = 1.2f, ChuffMaxRate = 10f;
/// <summary>Velocità (m/s, circa 110 km/h) a cui gli sbuffi sono più fitti.</summary>
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
/// <summary>Intonazione del motore (diesel o elettrico) con la velocità.</summary>
public static float EnginePitch(float speedMs) => 0.8f + 0.5f * Clamp01(speedMs / FullSpeedMs);
/// <summary>Secondi tra due sbuffi della vaporiera alla velocità data.</summary>
public static float ChuffInterval(float speedMs) => Math.Clamp(ChuffSpacingM / MathF.Max(speedMs, 0.5f), 0.09f, 1.2f);
/// <summary>
/// Secondi tra due sbuffi della vaporiera alla velocità data: la frequenza cresce in modo lineare
/// da <see cref="ChuffMinRate"/> a <see cref="ChuffMaxRate"/> fino a <see cref="ChuffFullSpeedMs"/>,
/// 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.
/// </summary>
public static float ChuffInterval(float speedMs) => 1f / (ChuffMinRate + (ChuffMaxRate - ChuffMinRate) * Clamp01(speedMs / ChuffFullSpeedMs));
/// <summary>
/// Inserisce un candidato nell'elenco ordinato dei più vicini (al più ids.Length): nessuna
@@ -6,8 +6,9 @@ namespace RailEnterprise.Client.Audio;
/// <summary>
/// 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
/// <c>user://settings.cfg</c>. 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 <c>user://settings.cfg</c>. Esc o un clic
/// sinistro fuori chiudono.
/// </summary>
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();
}
}
@@ -50,7 +50,8 @@ public static class MusicComposer
private sealed class Voice
{
public required float[] Table { get; init; }
/// <summary>Ampiezza della n-esima armonica in Harmonics[n−1].</summary>
public required float[] Harmonics { get; init; }
public float Attack { get; init; } = 0.005f;
/// <summary>Decadimento verso il sostegno (s).</summary>
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<int, float[]> _tables = [];
/// <summary>
/// Forma d'onda per una nota alla frequenza data, con le sole armoniche sotto
/// <see cref="MaxHarmonicShare"/> della frequenza di campionamento: quelle oltre Nyquist
/// tornerebbero indietro come toni stonati.
/// </summary>
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;
}
}
/// <summary>Frazione della frequenza di campionamento sotto cui stanno le armoniche (margine per vibrato e coro).</summary>
private const float MaxHarmonicShare = 0.45f;
private const int TableSize = 2048;
/// <summary>Forma d'onda di un periodo dalla somma di armoniche (ampiezza della n-esima in harmonics[n−1]).</summary>
private static float[] Table(params float[] harmonics)
/// <summary>Forma d'onda di un periodo dalla somma delle prime «count» armoniche (ampiezza della n-esima in harmonics[n−1]).</summary>
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;
}
}
+1 -1
View File
@@ -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
+2 -2
View File
@@ -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).
+24 -12
View File
@@ -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.