using System.Collections.Generic;
using TKS.OutGame;
using UnityEngine;
using UnityEngine.UI;
namespace TKS
{
///
/// 학습 판 안내 화면(개발 요청서 C5 · 2026-11-12) — 가운데 카드 · 아래 띠 · 주변 어둡게 + 대상 테두리 · 손가락 · 남은 턴 칩.
/// 캔버스 층(프로젝트 CLAUDE.md 「UI 캔버스·아틀라스 구조」): 루트(Static · 비어 있음) → Fx(Frame — 어둡게 덮개 · 테두리 · 손가락 = 전장 유닛을 따라 매 프레임 자리 갱신)
/// → Info(Event — 띠 · 카드 · 남은 턴 · 누름 막이 = 안내 단계가 바뀔 때만). 전투 HUD · 결과 · 아웃게임 화면보다 위(정렬 460).
/// 전장 조작은 SlingshotInput 이 화면 누름을 직접 읽으므로 그쪽 막기는 TutorialDirector 가 하고, 여기 「누름 막이」는 아래 UI 버튼(결과 · 편성)만 가린다.
///
public class TutorialGuideUI : MonoBehaviour
{
const float BarW = 1000f, BarH = 136f, BarY = 318f;
/// 위쪽 띠(대상·손가락이 화면 아래쪽일 때) — 메시지 칩 아래 · 미니맵 왼쪽.
const float BarTopW = 810f, BarTopX = 20f, BarTopY = -262f;
const float CardW = 920f, CardH = 400f;
const float CardLowY = -440f, CardHighY = 430f, CardMidY = 60f;
const float FrameLine = 6f;
Camera cam;
RectTransform fx;
RectTransform info;
readonly Image[] dim = new Image[4];
readonly List marks = new List();
int markUsed;
Image finger;
Image line;
Image aimEnd;
bool fingerOn, lineOn, aimOn, dimOn;
RectTransform bar;
Text barText;
bool barTop;
float cardY = CardMidY;
RectTransform card;
Text cardText;
Image blocker;
RectTransform chip;
Text chipText;
class Mark
{
public RectTransform rt;
public Image ring;
public readonly Image[] sides = new Image[4];
}
public static TutorialGuideUI Create(Transform parent, Camera cam)
{
var go = new GameObject("TutorialCanvas");
go.transform.SetParent(parent, false);
var ui = go.AddComponent();
ui.Build(cam);
return ui;
}
void Build(Camera c)
{
cam = c;
UiLayer.Root(gameObject, cam, 460, 0.35f, UiLayer.Reference, UiRate.Static);
fx = UiLayer.Group("Fx", transform, UiRate.Frame, false);
info = UiLayer.Group("Info", transform, UiRate.Event, true);
Color gold = UISkin.Col("coin", new Color(0.95f, 0.76f, 0.25f));
for (int i = 0; i < dim.Length; i++)
{
dim[i] = Box("Dim" + i, fx, Color.black);
dim[i].gameObject.SetActive(false);
}
line = Box("Pull", fx, new Color(1f, 1f, 1f, 0.55f));
line.rectTransform.pivot = new Vector2(0f, 0.5f);
line.gameObject.SetActive(false);
aimEnd = Box("AimEnd", fx, gold);
aimEnd.sprite = ProceduralSprites.Ring;
aimEnd.gameObject.SetActive(false);
finger = Box("Finger", fx, Color.white);
var hand = UISkin.Icon("tut_hand");
if (hand != null)
{
finger.sprite = hand;
finger.rectTransform.pivot = new Vector2(0.12f, 0.85f); // 손가락 끝
finger.rectTransform.sizeDelta = new Vector2(150f, 150f);
}
else
{
finger.sprite = ProceduralSprites.Circle;
finger.rectTransform.sizeDelta = new Vector2(70f, 70f);
}
finger.gameObject.SetActive(false);
// 누름 막이(투명 · 카드·잠금 안내가 떠 있는 동안 아래 UI 버튼을 가린다)
blocker = Box("Blocker", info, new Color(0f, 0f, 0f, 0f));
var brt = blocker.rectTransform;
brt.anchorMin = Vector2.zero;
brt.anchorMax = Vector2.one;
brt.offsetMin = brt.offsetMax = Vector2.zero;
blocker.raycastTarget = true;
blocker.gameObject.SetActive(false);
Color panel = UISkin.Col("hud_panel", new Color(0.12f, 0.15f, 0.21f, 0.92f));
panel.a = Mathf.Max(panel.a, 0.92f);
bar = UiKit.Rect("Bar", info, new Vector2(0.5f, 0f), new Vector2(0.5f, 0f), new Vector2(0f, BarY), new Vector2(BarW, BarH));
UiKit.Border(UiKit.Paint(bar, panel), gold, 3f);
barText = UiKit.FillLabel(bar, "", 34, Color.white, TextAnchor.MiddleCenter, false, 26f);
barText.horizontalOverflow = HorizontalWrapMode.Wrap;
barText.resizeTextForBestFit = true;
barText.resizeTextMinSize = 24;
barText.resizeTextMaxSize = 34;
bar.gameObject.SetActive(false);
card = UiKit.Rect("Card", info, new Vector2(0.5f, 0.5f), new Vector2(0.5f, 0.5f), new Vector2(0f, 60f), new Vector2(CardW, CardH));
UiKit.Border(UiKit.Paint(card, panel), gold, 4f);
cardText = UiKit.Label(card, "", 40, Color.white, TextAnchor.MiddleCenter, new Vector2(0.5f, 0.5f), new Vector2(0.5f, 0.5f), new Vector2(0f, 26f), new Vector2(CardW - 90f, CardH - 130f), false);
cardText.horizontalOverflow = HorizontalWrapMode.Wrap;
cardText.resizeTextForBestFit = true;
cardText.resizeTextMinSize = 26;
cardText.resizeTextMaxSize = 40;
var foot = UiKit.Label(card, "화면을 누르면 계속", 26, UISkin.Col("text_soft", new Color(0.8f, 0.8f, 0.8f)), TextAnchor.MiddleCenter, new Vector2(0.5f, 0f), new Vector2(0.5f, 0f), new Vector2(0f, 22f), new Vector2(CardW - 90f, 40f), false);
foot.color = new Color(1f, 1f, 1f, 0.6f);
card.gameObject.SetActive(false);
chip = UiKit.Rect("TurnLeft", info, new Vector2(1f, 1f), new Vector2(1f, 1f), new Vector2(-14f, -108f), new Vector2(290f, 74f)); // 턴 띠 오른쪽 · 미니맵 위
UiKit.Border(UiKit.Paint(chip, panel), gold, 3f);
chipText = UiKit.Title(UiKit.FillLabel(chip, "", 36, new Color(1f, 0.9f, 0.45f)), true);
chip.gameObject.SetActive(false);
}
static Image Box(string name, Transform parent, Color c)
{
var go = new GameObject(name, typeof(RectTransform));
go.transform.SetParent(parent, false);
var img = go.AddComponent();
img.color = c;
img.raycastTarget = false;
var rt = img.rectTransform;
rt.anchorMin = rt.anchorMax = new Vector2(0.5f, 0.5f);
return img;
}
// ---------- 좌표 ----------
/// 전장 좌표 → 이 캔버스(가운데 원점) 좌표.
public Vector2 ToCanvas(Vector2 world)
{
return ScreenToCanvas(cam.WorldToScreenPoint(new Vector3(world.x, world.y, 0f)));
}
public Vector2 ScreenToCanvas(Vector2 screen)
{
Vector2 lp;
RectTransformUtility.ScreenPointToLocalPointInRectangle(fx, screen, cam, out lp);
return lp;
}
/// 전장 사각(가운데 · 반 크기) → 캔버스 사각.
public Rect WorldRect(Vector2 center, Vector2 half)
{
Vector2 a = ToCanvas(center - half), b = ToCanvas(center + half);
return Rect.MinMaxRect(Mathf.Min(a.x, b.x), Mathf.Min(a.y, b.y), Mathf.Max(a.x, b.x), Mathf.Max(a.y, b.y));
}
static readonly Vector3[] corners = new Vector3[4];
/// 다른 캔버스의 UI 요소 → 이 캔버스 사각.
public Rect UiRect(RectTransform rt)
{
rt.GetWorldCorners(corners);
float x0 = float.MaxValue, y0 = float.MaxValue, x1 = float.MinValue, y1 = float.MinValue;
for (int i = 0; i < 4; i++)
{
Vector2 p = ScreenToCanvas(RectTransformUtility.WorldToScreenPoint(cam, corners[i]));
x0 = Mathf.Min(x0, p.x);
y0 = Mathf.Min(y0, p.y);
x1 = Mathf.Max(x1, p.x);
y1 = Mathf.Max(y1, p.y);
}
return Rect.MinMaxRect(x0, y0, x1, y1);
}
public Rect Bounds
{
get { return fx.rect; }
}
/// 손가락이 머물 수 있는 범위(아래 유닛 정보 판 · 위 턴 띠를 피함).
public Rect SafeRect
{
get
{
var r = fx.rect;
return Rect.MinMaxRect(r.xMin + 40f, r.yMin + 60f, r.xMax - 40f, r.yMax - 240f);
}
}
// ---------- 매 프레임(Fx) ----------
public void BeginFrame()
{
markUsed = 0;
fingerOn = lineOn = aimOn = dimOn = false;
}
/// 주변 어둡게 — hole 이 있으면 그 사각만 밝게 남긴다.
public void Dim(float alpha, Rect? hole)
{
dimOn = true;
var r = fx.rect;
var col = new Color(0f, 0f, 0f, Mathf.Clamp01(alpha));
if (!hole.HasValue)
{
Place(dim[0], r, col);
for (int i = 1; i < 4; i++) Show(dim[i], false);
return;
}
var h = hole.Value;
float x0 = Mathf.Clamp(h.xMin, r.xMin, r.xMax), x1 = Mathf.Clamp(h.xMax, r.xMin, r.xMax);
float y0 = Mathf.Clamp(h.yMin, r.yMin, r.yMax), y1 = Mathf.Clamp(h.yMax, r.yMin, r.yMax);
Place(dim[0], Rect.MinMaxRect(r.xMin, y1, r.xMax, r.yMax), col); // 위
Place(dim[1], Rect.MinMaxRect(r.xMin, r.yMin, r.xMax, y0), col); // 아래
Place(dim[2], Rect.MinMaxRect(r.xMin, y0, x0, y1), col); // 왼쪽
Place(dim[3], Rect.MinMaxRect(x1, y0, r.xMax, y1), col); // 오른쪽
}
/// 대상 테두리(round = 유닛 고리 · 아니면 사각 틀) · pulse = 크기 떨림.
public void Frame(Rect rect, bool round, float pulse)
{
Mark m;
if (markUsed < marks.Count) m = marks[markUsed];
else
{
m = NewMark();
marks.Add(m);
}
markUsed++;
Show(m.rt.gameObject, true);
Vector2 size = rect.size * pulse;
if (round)
{
float d = Mathf.Max(size.x, size.y);
size = new Vector2(d, d);
}
SetRect(m.rt, rect.center, size);
Show(m.ring.gameObject, round);
for (int i = 0; i < 4; i++) Show(m.sides[i].gameObject, !round);
if (!round)
{
SetRect(m.sides[0].rectTransform, new Vector2(0f, size.y * 0.5f), new Vector2(size.x + FrameLine, FrameLine));
SetRect(m.sides[1].rectTransform, new Vector2(0f, -size.y * 0.5f), new Vector2(size.x + FrameLine, FrameLine));
SetRect(m.sides[2].rectTransform, new Vector2(-size.x * 0.5f, 0f), new Vector2(FrameLine, size.y + FrameLine));
SetRect(m.sides[3].rectTransform, new Vector2(size.x * 0.5f, 0f), new Vector2(FrameLine, size.y + FrameLine));
}
}
Mark NewMark()
{
Color gold = UISkin.Col("coin", new Color(0.95f, 0.76f, 0.25f));
var m = new Mark();
var go = new GameObject("Mark", typeof(RectTransform));
go.transform.SetParent(fx, false);
go.transform.SetSiblingIndex(dim.Length); // 어둡게 덮개 위 · 손가락 아래
m.rt = (RectTransform)go.transform;
m.rt.anchorMin = m.rt.anchorMax = new Vector2(0.5f, 0.5f);
m.ring = Box("Ring", m.rt, gold);
m.ring.sprite = ProceduralSprites.Ring;
m.ring.rectTransform.anchorMin = Vector2.zero;
m.ring.rectTransform.anchorMax = Vector2.one;
m.ring.rectTransform.offsetMin = m.ring.rectTransform.offsetMax = Vector2.zero;
for (int i = 0; i < 4; i++) m.sides[i] = Box("Side" + i, m.rt, gold);
return m;
}
/// 손가락(끝이 pos) · press 0~1 = 누르는 정도(작아짐) · alpha.
public void Finger(Vector2 pos, float press, float alpha)
{
fingerOn = true;
Show(finger.gameObject, true);
var rt = finger.rectTransform;
if (rt.anchoredPosition != pos) rt.anchoredPosition = pos;
float k = 1f - 0.14f * Mathf.Clamp01(press);
var sc = new Vector3(k, k, 1f);
if (rt.localScale != sc) rt.localScale = sc;
finger.color = new Color(1f, 1f, 1f, Mathf.Clamp01(alpha));
}
/// 당김 선(유닛 → 손가락).
public void Line(Vector2 a, Vector2 b, float alpha)
{
lineOn = true;
Show(line.gameObject, true);
var rt = line.rectTransform;
Vector2 d = b - a;
if (rt.anchoredPosition != a) rt.anchoredPosition = a;
var size = new Vector2(d.magnitude, 8f);
if (rt.sizeDelta != size) rt.sizeDelta = size;
rt.localRotation = Quaternion.Euler(0f, 0f, Mathf.Atan2(d.y, d.x) * Mathf.Rad2Deg);
line.color = new Color(1f, 1f, 1f, 0.55f * Mathf.Clamp01(alpha));
}
/// 조준선 끝 표시(쏠 곳).
public void AimEnd(Vector2 pos, float size)
{
aimOn = true;
Show(aimEnd.gameObject, true);
SetRect(aimEnd.rectTransform, pos, new Vector2(size, size));
}
public void EndFrame()
{
for (int i = markUsed; i < marks.Count; i++) Show(marks[i].rt.gameObject, false);
if (!fingerOn) Show(finger.gameObject, false);
if (!lineOn) Show(line.gameObject, false);
if (!aimOn) Show(aimEnd.gameObject, false);
if (!dimOn)
for (int i = 0; i < 4; i++) Show(dim[i], false);
}
static void Place(Image img, Rect r, Color c)
{
bool on = r.width > 0.5f && r.height > 0.5f;
Show(img, on);
if (!on) return;
SetRect(img.rectTransform, r.center, r.size);
img.color = c;
}
static void SetRect(RectTransform rt, Vector2 pos, Vector2 size)
{
if (rt.anchoredPosition != pos) rt.anchoredPosition = pos;
if (rt.sizeDelta != size) rt.sizeDelta = size;
}
static void Show(Image img, bool on)
{
Show(img.gameObject, on);
}
static void Show(GameObject go, bool on)
{
if (go.activeSelf != on) go.SetActive(on);
}
// ---------- 단계가 바뀔 때(Info) ----------
public void SetBar(string text)
{
bool on = !string.IsNullOrEmpty(text);
Show(bar.gameObject, on);
if (on) barText.text = text;
}
/// 가운데 카드(자리 = PlaceCard · 기본 가운데).
public void SetCard(string text)
{
bool on = !string.IsNullOrEmpty(text);
Show(card.gameObject, on);
if (on) cardText.text = text;
else PlaceCard(0);
}
/// 카드 자리 — 0 가운데 · −1 아래(전장의 대상이 위쪽) · +1 위(대상이 아래쪽) — 가리키는 대상을 카드가 덮지 않게.
public void PlaceCard(int where)
{
float y = where < 0 ? CardLowY : where > 0 ? CardHighY : CardMidY;
if (Mathf.Approximately(y, cardY)) return;
cardY = y;
card.anchoredPosition = new Vector2(0f, y);
}
/// 띠 자리 — top = 위쪽(대상·손가락이 화면 아래쪽일 때) · 아니면 아래.
public void PlaceBar(bool top)
{
if (top == barTop) return;
barTop = top;
bar.anchorMin = bar.anchorMax = top ? new Vector2(0f, 1f) : new Vector2(0.5f, 0f);
bar.pivot = top ? new Vector2(0f, 1f) : new Vector2(0.5f, 0f);
bar.anchoredPosition = top ? new Vector2(BarTopX, BarTopY) : new Vector2(0f, BarY);
bar.sizeDelta = new Vector2(top ? BarTopW : BarW, BarH);
}
/// 아래 띠가 차지하는 높이(캔버스 좌표 · 이 값보다 아래에 대상이 있으면 띠를 위로).
public float BarZoneTop
{
get { return fx.rect.yMin + BarY + BarH + 30f; }
}
public bool BarAtTop
{
get { return barTop; }
}
public bool CardVisible
{
get { return card != null && card.gameObject.activeSelf; }
}
public bool BarVisible
{
get { return bar != null && bar.gameObject.activeSelf; }
}
public string BarText
{
get { return barText != null ? barText.text : ""; }
}
public string CardText
{
get { return cardText != null ? cardText.text : ""; }
}
public bool FingerVisible
{
get { return finger != null && finger.gameObject.activeSelf; }
}
public int MarkCount
{
get { return markUsed; }
}
public void SetBlocker(bool on)
{
Show(blocker.gameObject, on);
}
/// 남은 턴 칩(빈 문자열 = 숨김).
public void SetTurnsLeft(string text)
{
bool on = !string.IsNullOrEmpty(text);
Show(chip.gameObject, on);
if (on) chipText.text = text;
}
public bool TurnChipVisible
{
get { return chip != null && chip.gameObject.activeSelf; }
}
public string TurnChipText
{
get { return chipText != null ? chipText.text : ""; }
}
public RectTransform TurnChip
{
get { return chip; }
}
}
}