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; } } } }