2026-11-17 07:27:22 +00:00
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>
2026-11-19 09:05:03 +00:00
const float BarTopW = 810f , BarTopX = 20f , BarTopY = - 490f ; // 위 띠 = 유닛 판(왼쪽 위 − 270 · 높이 204 · 2026-11-19 위로 옮김) 바로 아래 — 끌기 안내 띠가 유닛 판을 덮지 않게
2026-11-17 07:27:22 +00:00
const float CardW = 920f , CardH = 400f ;
const float CardLowY = - 440f , CardHighY = 430f , CardMidY = 60f ;
2026-11-19 09:05:03 +00:00
const float CardTopH = 250f , CardTopGap = 262f ; // 맨 위 카드(PlaceCard 2) = 높이 · 화면 위 끝에서 띄움(아군 턴 표시 · 안내 줄 아래 = 유닛 판 자리)
2026-11-17 07:27:22 +00:00
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>
2026-11-19 09:05:03 +00:00
void CardAt ( int where , out float y , out float h )
{
bool top = where > = 2 ;
h = top ? CardTopH : CardH ;
y = top ? info . rect . height * 0.5f - CardTopGap - h * 0.5f : where < 0 ? CardLowY : where > 0 ? CardHighY : CardMidY ; // 앵커 = 가운데
}
/// <summary>그 자리에 놓인 카드의 사각(캔버스 좌표 · WorldRect 와 같은 좌표) — 대상을 덮는지 고를 때(TutorialDirector).</summary>
public Rect CardRect ( int where )
{
float y , h ;
CardAt ( where , out y , out h ) ;
return new Rect ( - CardW * 0.5f , y - h * 0.5f , CardW , h ) ;
}
/// <summary>카드 자리 — − 1 아래 · 0 가운데 · 1 위 · 2 화면 맨 위(아군 턴 표시 · 안내 줄 바로 아래 · 낮은 카드 = 끌기 시범처럼 전장을 덮지 않아야 할 때 · 2026-11-19 PD).</summary>
2026-11-17 07:27:22 +00:00
public void PlaceCard ( int where )
{
2026-11-19 09:05:03 +00:00
bool top = where > = 2 ;
float h , y ;
CardAt ( where , out y , out h ) ;
if ( Mathf . Approximately ( y , cardY ) & & Mathf . Approximately ( card . sizeDelta . y , h ) ) return ;
2026-11-17 07:27:22 +00:00
cardY = y ;
card . anchoredPosition = new Vector2 ( 0f , y ) ;
2026-11-19 09:05:03 +00:00
card . sizeDelta = new Vector2 ( CardW , h ) ;
var tr = cardText . rectTransform ;
tr . sizeDelta = new Vector2 ( CardW - 90f , h - ( top ? 80f : 130f ) ) ;
tr . anchoredPosition = new Vector2 ( 0f , top ? 16f : 26f ) ;
2026-11-17 07:27:22 +00:00
}
/// <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 ; }
}
}
}