using Godot; using RailEnterprise.Client.App; using static RailEnterprise.Client.App.Localization; namespace RailEnterprise.Client.Tutorial; /// /// Interfaccia del tutorial: riquadro ancorato in basso a sinistra dell'area della mappa (non modale, non /// copre barra degli strumenti né pannello destro) e contorno ambra animato attorno all'elemento da /// guardare. Tutto ciò che non è il riquadro lascia passare il mouse. /// public partial class TutorialOverlay : Control { private const float BoxWidth = 400; private const float Margin = 16; private readonly PanelContainer _box = new(); private readonly Label _counter = UiTheme.Text("", 12, Palette.TextSecondary); private readonly Label _title = UiTheme.TitleLabel("", 26, Palette.AmberLight); private readonly Label _text = UiTheme.Text("", 14); private readonly Label _done = UiTheme.Text("", 13, Palette.Ok, bold: true); private readonly ProgressBar _progress = new() { ShowPercentage = false, CustomMinimumSize = new Vector2(0, 4) }; private readonly VBoxContainer _body = new(); private readonly Button _next = UiTheme.Primary(T("Avanti")); private readonly Button _skip = new() { Text = T("Salta passo") }; private readonly Button _close = new() { Text = T("Chiudi tutorial") }; private readonly Button _collapse = new() { Text = "–", Flat = true, CustomMinimumSize = new Vector2(28, 24) }; private readonly HighlightFrame _frame = new(); private double _doneTimer; private bool _collapsed; public event Action? NextPressed; public event Action? SkipPressed; public event Action? ClosePressed; public override void _Ready() { SetAnchorsAndOffsetsPreset(LayoutPreset.FullRect); MouseFilter = MouseFilterEnum.Ignore; UiTheme.Apply(this); AddChild(_frame); // i pulsanti non prendono il fuoco: Invio e spazio restano alla partita (Costruisci, pausa) e non // ripremono l'ultimo pulsante del tutorial foreach (var b in new[] { _next, _skip, _close, _collapse }) b.FocusMode = FocusModeEnum.None; _box.AddThemeStyleboxOverride("panel", UiTheme.Box(Palette.Panel, Palette.Amber, 10, 16)); _box.CustomMinimumSize = new Vector2(BoxWidth, 0); AddChild(_box); var col = new VBoxContainer(); col.AddThemeConstantOverride("separation", 8); _box.AddChild(col); var header = new HBoxContainer(); header.AddThemeConstantOverride("separation", 8); header.AddChild(UiTheme.Badge(T("Tutorial"))); _counter.SizeFlagsHorizontal = SizeFlags.ExpandFill; _counter.SizeFlagsVertical = SizeFlags.ShrinkCenter; header.AddChild(_counter); _collapse.TooltipText = T("Riduci o espandi il riquadro del tutorial"); _collapse.Pressed += () => SetCollapsed(!_collapsed); header.AddChild(_collapse); col.AddChild(header); _progress.AddThemeStyleboxOverride("fill", UiTheme.Box(Palette.Amber, Palette.Amber, 2, 0)); _progress.AddThemeStyleboxOverride("background", UiTheme.Box(Palette.Border, Palette.Border, 2, 0)); col.AddChild(_progress); _title.AutowrapMode = TextServer.AutowrapMode.WordSmart; col.AddChild(_title); _body.AddThemeConstantOverride("separation", 10); col.AddChild(_body); _text.AutowrapMode = TextServer.AutowrapMode.WordSmart; _body.AddChild(_text); _done.AutowrapMode = TextServer.AutowrapMode.WordSmart; _done.Visible = false; _body.AddChild(_done); var buttons = new HBoxContainer(); buttons.AddThemeConstantOverride("separation", 8); buttons.AddChild(_next); buttons.AddChild(_skip); buttons.AddChild(new Control { SizeFlagsHorizontal = SizeFlags.ExpandFill }); buttons.AddChild(_close); _body.AddChild(buttons); _next.Pressed += () => NextPressed?.Invoke(); _skip.Pressed += () => SkipPressed?.Invoke(); _close.Pressed += () => ClosePressed?.Invoke(); _close.TooltipText = T("Il tutorial si riapre con F1 o dalla schermata iniziale"); } /// Mostra un passo: numero, titolo e testo già tradotti; Avanti solo per i passi informativi. public void ShowStep(int number, int count, string title, string text, bool informative, bool last) { _counter.Text = string.Format(T("Passo {0} di {1}"), number, count); _progress.MaxValue = count; _progress.Value = number - 1; _title.Text = title; _text.Text = text; _next.Visible = informative; _next.Text = last ? T("Fine") : T("Avanti"); _skip.Visible = !informative; } /// Breve conferma del passo appena completato. public void Flash(string completedTitle) { _done.Text = $"✓ {T("Fatto")}: {completedTitle}"; _done.Visible = true; _doneTimer = 2.5; } /// Area libera in cui ancorare il riquadro (rettangolo globale della mappa o del pannello a tutto schermo). public Rect2 Area { get; set; } /// Elemento da evidenziare (rettangolo globale), null per nessuno. public Rect2? Target { get => _frame.Target; set => _frame.Target = value; } private void SetCollapsed(bool collapsed) { _collapsed = collapsed; _body.Visible = !collapsed; _collapse.Text = collapsed ? "+" : "–"; } public override void _Process(double delta) { if (_doneTimer > 0) { _doneTimer -= delta; if (_doneTimer <= 0) _done.Visible = false; } // in basso a sinistra dell'area libera; la larghezza si adatta alle finestre strette var area = Area.Size == Vector2.Zero ? GetViewportRect() : Area; float width = Math.Min(BoxWidth, Math.Max(240, area.Size.X - 2 * Margin)); _box.CustomMinimumSize = new Vector2(width, 0); _box.Size = new Vector2(width, 0); var size = _box.GetCombinedMinimumSize(); _box.Size = size; _box.Position = new Vector2(area.Position.X + Margin, area.End.Y - Margin - size.Y); } /// Contorno ambra che pulsa attorno all'elemento evidenziato; non intercetta il mouse. private sealed partial class HighlightFrame : Control { private double _time; public Rect2? Target { get; set; } public override void _Ready() { SetAnchorsAndOffsetsPreset(LayoutPreset.FullRect); MouseFilter = MouseFilterEnum.Ignore; } public override void _Process(double delta) { _time += delta; QueueRedraw(); } public override void _Draw() { if (Target is not { } t || t.Size.X <= 0 || t.Size.Y <= 0) return; float pulse = 0.5f + 0.5f * MathF.Sin((float)_time * 4f); float grow = 3 + 3 * pulse; var rect = t.Grow(grow); rect.Position -= GetGlobalRect().Position; var glow = new StyleBoxFlat { BgColor = Palette.WithAlpha(Palette.Amber, 0.06f + 0.06f * pulse), BorderColor = Palette.WithAlpha(Palette.AmberLight, 0.35f + 0.45f * pulse) }; glow.SetBorderWidthAll(3); glow.SetCornerRadiusAll(10); DrawStyleBox(glow, rect); var outer = new StyleBoxFlat { BgColor = new Color(0, 0, 0, 0), BorderColor = Palette.WithAlpha(Palette.Amber, 0.25f * (1 - pulse)) }; outer.SetBorderWidthAll(2); outer.SetCornerRadiusAll(14); DrawStyleBox(outer, rect.Grow(6 + 4 * pulse)); } } }