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);
_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 dal menu");
}
/// 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));
}
}
}