153 lines
9.0 KiB
C#
153 lines
9.0 KiB
C#
// ─────────────────────────────────────────────────────────────────────────────
|
||
// WLPixelCameraSettings.cs — Critter 3D Pixel Camera 리그 값의 SOT (C45)
|
||
//
|
||
// PD 지시 #814(「도트 게임처럼」) · 발주서 WL-814b §1-3 (2026-09-10)
|
||
//
|
||
// 값의 SOT = Assets/WL/Combat/Settings/Resources/WL/WLPixelCameraSettings.asset
|
||
// → Resources.Load<WLPixelCameraSettings>("WL/WLPixelCameraSettings") 1회 로드 후 캐시(기존 WL 설정 SO 관례).
|
||
//
|
||
// 🔴 C8 — enabled = 0 (또는 RuntimeDisabled = true) 이면 리그가 아예 조립되지 않고,
|
||
// 이미 조립돼 있으면 다음 틱에 원본 카메라 값이 100 % 복원된다(원본 동작과 동일).
|
||
//
|
||
// 🔴 원본 스크립트 0 · 원본 프리팹/씬 디스크 수정 0. 이 SO 와 PixelCameraRig.cs 만이 WL 신규 파일이다.
|
||
// ─────────────────────────────────────────────────────────────────────────────
|
||
|
||
using UnityEngine;
|
||
|
||
namespace WL.PixelArt
|
||
{
|
||
/// <summary>Followed 프록시를 어떻게 원본 카메라에 붙일지.</summary>
|
||
public enum PixelProxyMode
|
||
{
|
||
/// <summary>원본 Main Camera 의 자식(localPos 0 · localRot identity). 지연 0 · 프레임당 비용 0 · GC 0. 권장.</summary>
|
||
ChildOfCamera = 0,
|
||
/// <summary>독립 오브젝트 + 미러 스크립트([DefaultExecutionOrder(-100)] LateUpdate). 1프레임 지연.</summary>
|
||
MirrorScript = 1,
|
||
}
|
||
|
||
/// <summary>Critter 픽셀 카메라 리그 값. 전부 여기서만 바꾼다(코드 상수 0).</summary>
|
||
[CreateAssetMenu(fileName = "WLPixelCameraSettings", menuName = "WL/Pixel Camera Settings", order = 814)]
|
||
public sealed class WLPixelCameraSettings : ScriptableObject
|
||
{
|
||
public const string ResourcesPath = "WL/WLPixelCameraSettings";
|
||
|
||
static WLPixelCameraSettings s_cached;
|
||
static bool s_lookupDone;
|
||
|
||
/// <summary>Resources 에서 1회 로드 후 캐시. 없으면 null(= 기능 off).</summary>
|
||
public static WLPixelCameraSettings Instance
|
||
{
|
||
get
|
||
{
|
||
if (!s_lookupDone)
|
||
{
|
||
s_lookupDone = true;
|
||
s_cached = Resources.Load<WLPixelCameraSettings>(ResourcesPath);
|
||
}
|
||
return s_cached;
|
||
}
|
||
}
|
||
|
||
/// <summary>진단·A/B 전용 런타임 스위치(WLHitFeel.RuntimeDisabled 선례). 에셋을 안 건드리고 이 기능만 끈다.</summary>
|
||
public static bool RuntimeDisabled;
|
||
|
||
/// <summary>이 기능이 살아 있는가(에셋 존재 + enabled + !RuntimeDisabled).</summary>
|
||
public static bool Enabled
|
||
{
|
||
get { var i = Instance; return i != null && i.enabled && !RuntimeDisabled; }
|
||
}
|
||
|
||
/// <summary>테스트용: 캐시를 비워 다음 접근 때 다시 Resources.Load 한다.</summary>
|
||
public static void ClearCache() { s_cached = null; s_lookupDone = false; }
|
||
|
||
// ───────────────────────────────────────── 마스터
|
||
[Header("마스터 (C8)")]
|
||
[Tooltip("0 이면 리그를 만들지 않고, 이미 만들었으면 원본 카메라를 100 % 복원한다.")]
|
||
public bool enabled = true;
|
||
|
||
[Tooltip("1 이면 조립/복원 로그를 1줄씩 남긴다. LogError 는 쓰지 않는다(813z).")]
|
||
public bool verboseLog = false;
|
||
|
||
// ───────────────────────────────────────── 조립 경계
|
||
[Header("조립 경계 (811q EffectWarmup / 811o CameraFramingOverride 와 같은 판정)")]
|
||
[Tooltip("맵 진입 경계(메인 PC 교체 또는 맵 ID 변경)에서 자동 조립한다. 0 이면 프로브만 조립할 수 있다.")]
|
||
public bool assembleOnMapEnter = true;
|
||
|
||
[Tooltip("로비에서도 조립할지. 기본 0 = 인게임 맵에서만.")]
|
||
public bool assembleInLobby = false;
|
||
|
||
[Tooltip("경계 폴링 주기(초).")]
|
||
public float pollSeconds = 0.25f;
|
||
|
||
// ───────────────────────────────────────── 리그 원본
|
||
[Header("Critter 리그")]
|
||
[Tooltip("Assets/3DPixelCamera/URP/PixelCameraSystem.prefab (URP.unitypackage 해제로 생긴 프리팹).")]
|
||
public GameObject pixelCameraSystemPrefab;
|
||
|
||
[Tooltip("리그 전용 레이어 인덱스. 게임 카메라는 이 레이어를 빼고, 뷰 카메라는 이 레이어만 그린다. 프로젝트 미명명 레이어를 쓴다(TagManager 수정 0).")]
|
||
[Range(0, 31)] public int rigLayer = 31;
|
||
|
||
[Tooltip("프록시 방식. ChildOfCamera = 원본 카메라의 자식(지연 0 · 권장).")]
|
||
public PixelProxyMode proxyMode = PixelProxyMode.ChildOfCamera;
|
||
|
||
// ───────────────────────────────────────── 투영·해상도
|
||
[Header("직교 투영 · 픽셀 해상도")]
|
||
[Tooltip("원본 Main Camera 에 적용할 orthographicSize(= 화면 세로 절반의 월드 단위). "
|
||
+ "기본 3.8 = 원근 fov 60 · 카메라 거리 6.58 m 의 반높이(tan30° × 6.58).")]
|
||
[Range(1f, 12f)] public float orthoSize = 3.8f;
|
||
|
||
[Tooltip("저해상도 RT 의 세로 픽셀 수(SetHeight). 가로는 화면 비율로 자동(9:16 · 480 → 270×480).")]
|
||
[Range(60, 1080)] public int pixelHeight = 480;
|
||
|
||
[Tooltip("Critter 뷰 카메라가 캔버스 가장자리를 넘지 않으려고 (1 − 2/pixelHeight) 만큼 줌아웃하는 것을 보정한다. "
|
||
+ "1 이면 GameCameraZoom = orthoSize / (1 − 2/pixelHeight) 로 올려 화면 매핑을 orthoSize 와 정확히 맞춘다.")]
|
||
public bool compensateViewZoom = true;
|
||
|
||
// ───────────────────────────────────────── Critter 값
|
||
[Header("Critter PixelCameraManager 값")]
|
||
[Tooltip("픽셀 격자(voxel grid) 스냅. 정지 물체의 픽셀이 떨리지 않게 한다.")]
|
||
public bool voxelGridMovement = true;
|
||
|
||
[Tooltip("서브픽셀 보정. 격자 스냅의 뚝뚝 끊김을 뷰 카메라 오프셋으로 되돌린다.")]
|
||
public bool subpixelAdjustments = true;
|
||
|
||
[Tooltip("followed 트랜스폼의 회전도 따라간다.")]
|
||
public bool followRotation = true;
|
||
|
||
[Tooltip("Critter 가 게임 카메라의 orthographicSize 를 직접 제어한다.")]
|
||
public bool controlGameZoom = true;
|
||
|
||
[Tooltip("뷰 카메라 줌(−1~1). 1 = 캔버스를 화면에 꽉 채운다.")]
|
||
[Range(-1f, 1f)] public float viewCameraZoom = 1f;
|
||
|
||
[Tooltip("뷰 카메라를 원본 Main Camera 의 URP 카메라 스택에 Overlay 로 끼운다(권장). "
|
||
+ "0 이면 Base 로 두고 depth 를 원본보다 1 높인다.")]
|
||
public bool viewCameraInMainStack = true;
|
||
|
||
// ───────────────────────────────────────── 회전 중 스냅 해제
|
||
[Header("회전 중 스냅 해제 (Critter 문서 권고)")]
|
||
[Tooltip("카메라가 빠르게 돌 때 격자 스냅·서브픽셀 보정을 잠시 끈다(811o 구도 전환 · 보스 연출).")]
|
||
public bool disableSnapWhileRotating = true;
|
||
|
||
[Tooltip("이 각속도(도/초)를 넘으면 회전 중으로 본다.")]
|
||
public float rotationSnapOffDegPerSec = 30f;
|
||
|
||
[Tooltip("회전이 멎고 이 시간(초)이 지나면 스냅을 다시 켠다.")]
|
||
public float rotationSnapResumeSeconds = 0.25f;
|
||
|
||
// ───────────────────────────────────────── 원본 카메라 처리
|
||
[Header("원본 Main Camera 처리 (MainCamera 태그·RealCamera·AudioListener 전부 유지)")]
|
||
[Tooltip("원본 카메라가 그릴 레이어. 기본 0 = 월드를 그리지 않는다(인게임 UI 캔버스는 UICamera Overlay 가 그린다).")]
|
||
public int mainCameraCullingMask = 0;
|
||
|
||
[Tooltip("원본 카메라의 포스트프로세싱을 끈다(픽셀 결과를 다시 후처리하지 않게). 게임 카메라 쪽에서 처리한다.")]
|
||
public bool mainCameraPostProcessingOff = true;
|
||
|
||
[Tooltip("원본 카메라의 포스트프로세싱 설정을 저해상도 게임 카메라로 복사한다(블룸 등이 픽셀 해상도로 들어간다).")]
|
||
public bool copyPostProcessingToGameCamera = true;
|
||
|
||
[Tooltip("원본 카메라의 배경을 단색 검정으로 바꾼다(스카이박스 클리어 비용 제거). 복원 시 원값으로 되돌린다.")]
|
||
public bool mainCameraSolidBlack = true;
|
||
}
|
||
}
|