F6: audio, correzioni della revisione
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:
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;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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
@@ -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
@@ -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.
|
||||
Reference in new issue
Block a user