ThreeKingdomsSlingshot/Assets/Scripts/Runtime/Tutorial/TutorialGuideUI.cs

455 lines
18 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

using System.Collections.Generic;
using TKS.OutGame;
using UnityEngine;
using UnityEngine.UI;
namespace TKS
{
/// <summary>
/// 학습 판 안내 화면(개발 요청서 C5 · 2026-11-12) — 가운데 카드 · 아래 띠 · 주변 어둡게 + 대상 테두리 · 손가락 · 남은 턴 칩.
/// 캔버스 층(프로젝트 CLAUDE.md 「UI 캔버스·아틀라스 구조」): 루트(Static · 비어 있음) → Fx(Frame — 어둡게 덮개 · 테두리 · 손가락 = 전장 유닛을 따라 매 프레임 자리 갱신)
/// → Info(Event — 띠 · 카드 · 남은 턴 · 누름 막이 = 안내 단계가 바뀔 때만). 전투 HUD · 결과 · 아웃게임 화면보다 위(정렬 460).
/// 전장 조작은 SlingshotInput 이 화면 누름을 직접 읽으므로 그쪽 막기는 TutorialDirector 가 하고, 여기 「누름 막이」는 아래 UI 버튼(결과 · 편성)만 가린다.
/// </summary>
public class TutorialGuideUI : MonoBehaviour
{
const float BarW = 1000f, BarH = 136f, BarY = 318f;
/// <summary>위쪽 띠(대상·손가락이 화면 아래쪽일 때) — 메시지 칩 아래 · 미니맵 왼쪽.</summary>
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<Mark> marks = new List<Mark>();
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<TutorialGuideUI>();
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<Image>();
img.color = c;
img.raycastTarget = false;
var rt = img.rectTransform;
rt.anchorMin = rt.anchorMax = new Vector2(0.5f, 0.5f);
return img;
}
// ---------- 좌표 ----------
/// <summary>전장 좌표 → 이 캔버스(가운데 원점) 좌표.</summary>
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;
}
/// <summary>전장 사각(가운데 · 반 크기) → 캔버스 사각.</summary>
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];
/// <summary>다른 캔버스의 UI 요소 → 이 캔버스 사각.</summary>
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; }
}
/// <summary>손가락이 머물 수 있는 범위(아래 유닛 정보 판 · 위 턴 띠를 피함).</summary>
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;
}
/// <summary>주변 어둡게 — hole 이 있으면 그 사각만 밝게 남긴다.</summary>
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); // 오른쪽
}
/// <summary>대상 테두리(round = 유닛 고리 · 아니면 사각 틀) · pulse = 크기 떨림.</summary>
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;
}
/// <summary>손가락(끝이 pos) · press 0~1 = 누르는 정도(작아짐) · alpha.</summary>
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));
}
/// <summary>당김 선(유닛 → 손가락).</summary>
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));
}
/// <summary>조준선 끝 표시(쏠 곳).</summary>
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;
}
/// <summary>가운데 카드(자리 = PlaceCard · 기본 가운데).</summary>
public void SetCard(string text)
{
bool on = !string.IsNullOrEmpty(text);
Show(card.gameObject, on);
if (on) cardText.text = text;
else PlaceCard(0);
}
/// <summary>카드 자리 — 0 가운데 · −1 아래(전장의 대상이 위쪽) · +1 위(대상이 아래쪽) — 가리키는 대상을 카드가 덮지 않게.</summary>
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);
}
/// <summary>띠 자리 — top = 위쪽(대상·손가락이 화면 아래쪽일 때) · 아니면 아래.</summary>
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);
}
/// <summary>아래 띠가 차지하는 높이(캔버스 좌표 · 이 값보다 아래에 대상이 있으면 띠를 위로).</summary>
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);
}
/// <summary>남은 턴 칩(빈 문자열 = 숨김).</summary>
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; }
}
}
}