📔Utils - Orbit Camera

Camera Controlling & Orbiting Target

[세팅 방법]

• Main Camera에 이 스크립트를 컴포넌트로 추가합니다.
• Inspector의 Target에 조형물 오브젝트를 선택해서 할당합니다.

Hierarchy
 ├── SculptureObject          ← GenArtSculpture.cs 부착
 └── Main Camera              ← OrbitCamera.cs 부착
                                    └ target → SculptureObject 드래그 할당

[코드의 기능]

[인터랙션]

• 마우스 오른쪽 드래그: 조형물 주위를 공전
• 마우스 휠: 줌 인/아웃
• F 키: 카메라를 초기 위치로 리셋

📄Orbit_Camera.cs

using UnityEngine;
using UnityEngine.InputSystem; // New Input System 네임스페이스

public class OrbitCamera : MonoBehaviour
{
    [Header("타겟")]
    public Transform target;

    [Header("초기 위치")]
    public float initialDistance = 12f;
    public float initialPitch    = 20f;
    public float initialYaw      = 30f;

    [Header("공전 설정")]
    public float orbitSensitivity = 0.15f;
    public float orbitSmoothing   = 8.0f;

    [Header("줌 설정")]
    public float zoomSensitivity = 20.0f;
    public float zoomMin         = 3.0f;
    public float zoomMax         = 200.0f;
    public float zoomSmoothing   = 8.0f;

    [Header("자동 공전")]
    public bool  autoOrbit      = true;
    public float autoOrbitSpeed = 5.0f;

    // ============================================================
    // 내부 상태
    // ============================================================

    float _yaw;
    float _pitch;
    float _distance;

    float _targetYaw;
    float _targetPitch;
    float _targetDistance;

    bool _isDragging = false; // 오른쪽 버튼 드래그 중 여부

    // New Input System에서 마우스 참조를 캐싱합니다
    Mouse    _mouse;
    Keyboard _keyboard;

    // ============================================================
    // Unity 이벤트
    // ============================================================

    void Start()
    {
        // 현재 연결된 마우스와 키보드 장치를 가져옵니다
        // 장치가 없으면 null이 반환되므로 이후 null 체크가 필요합니다
        _mouse    = Mouse.current;
        _keyboard = Keyboard.current;

        _yaw      = _targetYaw      = initialYaw;
        _pitch    = _targetPitch    = initialPitch;
        _distance = _targetDistance = initialDistance;

        ApplyTransform(true);
    }

    void LateUpdate()
    {
        if (target == null) return;

        // 장치 연결이 끊겼다가 다시 연결될 수 있으므로 매 프레임 갱신합니다
        _mouse    = Mouse.current;
        _keyboard = Keyboard.current;

        HandleOrbitInput();
        HandleZoomInput();
        HandleResetInput();
        HandleAutoOrbit();

        // 스무딩: 현재 값을 목표 값 방향으로 보간합니다
        _yaw      = Mathf.LerpAngle(_yaw,      _targetYaw,      Time.deltaTime * orbitSmoothing);
        _pitch    = Mathf.Lerp     (_pitch,    _targetPitch,    Time.deltaTime * orbitSmoothing);
        _distance = Mathf.Lerp     (_distance, _targetDistance, Time.deltaTime * zoomSmoothing);

        ApplyTransform(false);
    }

    // ============================================================
    // 입력 처리
    // ============================================================

    void HandleOrbitInput()
    {
        if (_mouse == null) return;

        // New Input System: wasPressedThisFrame / wasReleasedThisFrame
        // 오른쪽 마우스 버튼 상태를 감지합니다
        if (_mouse.rightButton.wasPressedThisFrame)
            _isDragging = true;

        if (_mouse.rightButton.wasReleasedThisFrame)
            _isDragging = false;

        if (!_isDragging) return;

        // New Input System: delta.value로 이번 프레임의 마우스 이동량을 읽습니다
        // 구 Input System의 GetAxis("Mouse X/Y")에 해당합니다
        Vector2 delta = _mouse.delta.ReadValue();

        // 이동량에 Time.deltaTime을 곱해서 프레임레이트 독립적으로 만듭니다
        _targetYaw   += delta.x * orbitSensitivity;
        _targetPitch -= delta.y * orbitSensitivity;
        _targetPitch  = Mathf.Clamp(_targetPitch, -80f, 80f);
    }

    void HandleZoomInput()
    {
        if (_mouse == null) return;

        // New Input System의 scroll 값은 픽셀 단위로 들어옵니다.
        // 일반적인 휠 한 칸 = 약 120. 이걸 그대로 쓰면 너무 크므로
        // 120으로 나눠서 "한 칸 = 1.0" 단위로 정규화합니다.
        float scroll = _mouse.scroll.ReadValue().y / 120f;

        if (Mathf.Abs(scroll) < 0.001f) return;

        // 현재 거리에 비례해서 줌 속도를 조절합니다.
        // 멀리 있을수록 한 번에 더 많이 이동해서 자연스럽게 느껴집니다.
        _targetDistance -= scroll * zoomSensitivity * (_targetDistance * 0.2f);
        _targetDistance  = Mathf.Clamp(_targetDistance, zoomMin, zoomMax);
    }

    void HandleResetInput()
    {
        if (_keyboard == null) return;

        // New Input System: wasPressedThisFrame으로 이번 프레임 키 입력 감지
        // 구 Input System의 GetKeyDown()에 해당합니다
        if (!_keyboard.fKey.wasPressedThisFrame) return;

        _targetYaw      = initialYaw;
        _targetPitch    = initialPitch;
        _targetDistance = initialDistance;
    }

    void HandleAutoOrbit()
    {
        if (!autoOrbit || _isDragging) return;

        _targetYaw += autoOrbitSpeed * Time.deltaTime;
    }

    // ============================================================
    // 카메라 Transform 적용
    // ============================================================

    void ApplyTransform(bool instant)
    {
        Quaternion rotation = Quaternion.Euler(
            instant ? initialPitch : _pitch,
            instant ? initialYaw   : _yaw,
            0f
        );

        float    dist   = instant ? initialDistance : _distance;
        Vector3  offset = rotation * new Vector3(0f, 0f, -dist);

        transform.position = target.position + offset;
        transform.LookAt(target.position);
    }

    // ============================================================
    // 기즈모
    // ============================================================
#if UNITY_EDITOR
    void OnDrawGizmosSelected()
    {
        if (target == null) return;

        Gizmos.color = new Color(0.3f, 0.8f, 1f, 0.2f);
        Gizmos.DrawWireSphere(target.position, _distance > 0 ? _distance : initialDistance);

        Gizmos.color = new Color(1f, 1f, 0f, 0.5f);
        Gizmos.DrawLine(target.position, transform.position);
    }
#endif
}