Texture.h

#pragma once
#include "TypeDefinition.h"
#include "ClassProperty.h"
#include "EngineResourceCensus.h"
#include "MetaPolymorphic.h"
#include "Delegate.h"
// m_assetId의 HashedGuid·make_guid()가 여기서 온다 — 전이 include에 기대지 않는다.
#include "TypeTrait.h"
// DirectXTex.h는 이 저장소에서 늘 __d3d11_h__가 켜진 채로 읽혀야 한다.
// DirectXHelper.h가 쓰는 CreateShaderResourceView·CreateTextureEx가 그 가드
// 안에 있는데, #pragma once 때문에 먼저 들어온 쪽의 순서가 그대로 굳는다.
// Core.Definition.h는 d3d11.h를 먼저 넣어 그 규약을 지키지만 이 헤더만
// 어긋나 있었고, 유니티 빌드에서는 앞선 파일이 순서를 맞춰 가려 왔다.
// (근본 처방은 DirectXHelper.h의 DX11 TGA 로더를 걷는 것이다 — DX11 은퇴 몫)
#include <d3d11.h>
#include <DirectXTex.h>
#include <mathematics/vector2.hpp>
#include <memory>
#include <string_view>
#include <functional>
#include <type_traits>

//-----------------------------------------------------------------------------
// Texture: 자산의 CPU 자료
//
// ★ DX11 표면을 통째로 걷어냈다 (T6, 2026-08-08).
//
//   여기 있던 것: ID3D11Texture2D·SRV·RTV·DSV·UAV 멤버와 그 뷰 생성 함수 여덟,
//   DX11 리소스를 직접 만드는 Create* 계열 열둘(2D·큐브·배열·화면 추종),
//   화면 크기 추종 정책(FollowScreenSize·ApplyScreenSize·Resize* 다섯), 그리고
//   그것들을 감싸던 TextureHelper.
//
//   ★ 마지막에는 전부 자기참조였다. 뷰 생성 호출 21건이 전부 이 헤더 안의
//     인라인 Create* 구현에서 났고, 헤더 밖에서 부르는 곳은 0이었다. 즉
//     '아무도 안 쓰는 것들이 서로를 부르는' 덩어리가 남아 있었다.
//
//   지금 이 타입이 하는 일은 하나다 — 파일에서 읽은 픽셀을 CPU에 들고,
//   DX12TextureCache가 그것을 신원(m_assetId)으로 캐싱해 GPU에 올린다.
//-----------------------------------------------------------------------------

enum class TextureType
{
	Unknown,
	Texture2D,
	TextureCube,
	TextureArray,
	ImageTexture,
};

class Texture : public meta::polymorphic,
	private Diagnostics::CountedResource<Diagnostics::EngineResource::Texture>
{
public:
	Texture() = default;
	Texture(const Texture&) = delete;
	Texture(Texture&& texture) noexcept;
	~Texture();

	/// CPU 픽셀에서 바로 만든다. 자가 검증이 작은 더미 텍스처를 세울 때 쓴다.
	static Texture* CreateFromPixels(
		_In_ uint32 width,
		_In_ uint32 height,
		_In_ std::string_view name,
		_In_ DXGI_FORMAT textureFormat,
		_In_reads_bytes_(rowPitch* height) const void* pixels,
		_In_opt_ size_t rowPitch = 0
	);

	static Texture* LoadFormPath(_In_ const file::path& path, bool isCompress = false);

	static std::shared_ptr<Texture> LoadSharedFromPath(
		const file::path& path, bool isCompress = false);

	static std::unique_ptr<Texture> LoadManagedFromPath(
		const file::path& path, bool isCompress = false);

	// ── DX12 직결 업로드용 CPU 픽셀 (PHASE 3-1 재정의, T1) ──
	//
	// 파일에서 읽어 압축까지 끝낸 최종 이미지다. 예전에는 이것으로 DX11 SRV를
	// 만든 뒤 그냥 버렸고, DX12가 쓸 때는 그 DX11 텍스처에서 되읽었다
	// (DX11 스테이징 복사 → Map → 업로드 링). 파일을 읽는 시점에 이미 손에
	// 있던 픽셀을 GPU까지 갔다가 도로 가져오던 셈이다.
	//
	// ★ 정정(2026-08-08, 자산 상주 관리 ③): 예전에는 DX12가 가져가면서
	//   놓았다(TakeCpuPixels). 그 전제는 "한 번 올리면 캐시가 영원히 들고
	//   있다"였는데, ③(미사용 기반 은퇴)이 그 전제를 깼다.
	//
	//   실측으로 드러났다 — 은퇴한 텍스처를 다시 요청하니 CPU 픽셀이 이미
	//   비어 있어 재업로드가 실패했다(씬 왕복 후 실패 3102건, 화면에 흰색).
	//   T4에서 DX11 폴백까지 걷어낸 뒤라 되읽을 곳도 없었다.
	//
	//   그래서 놓지 않는다. 비용은 실측이 정당화한다: 재질 텍스처 전체가
	//   3.8MB이고, 그 정도면 재업로드 실패보다 훨씬 싸다.
	//
	// ★ 큰 것 하나는 예외다. 4K HDR equirect(128MB)는 IBL 생성 뒤로는
	//   진짜 안 쓰이므로 CPU 사본을 계속 드는 것이 아깝다. 지금은 그대로
	//   두고 관측만 한다 — 은퇴 시점에 함께 놓는 것은 별도 판단이다.
	//
	// shared_ptr인 이유: Texture가 이동되는 경로가 있어 소유권을 하나로
	// 묶어야 하고, unique_ptr이면 그 경로들이 깨진다.
	std::shared_ptr<DirectX::ScratchImage> m_cpuPixels;

	/// DX12 업로드용. 소유권을 넘기지 않는다 — 은퇴 후 재업로드가 같은
	/// 픽셀을 다시 읽어야 한다.
	const DirectX::ScratchImage* GetCpuPixels() const { return m_cpuPixels.get(); }

	// ── 자산 신원 (PHASE 3-1 재정의, 자산 상주 관리 ①) ──
	//
	// GPU 캐시(DX12TextureCache)가 이 값을 키로 쓴다. 예전에는 Texture*
	// 원시 포인터가 키였는데, 자산 수명이 shared_ptr 공동 소유라(2-2~2-5)
	// 언제 어느 스레드에서 죽는지 정해져 있지 않고, 죽은 뒤 같은 주소에
	// 새 자산이 올라오면 캐시가 이전 것의 GPU 데이터를 돌려줬다.
	//
	// ★ 그 오염은 조용하다 — 검증 레이어가 잡지 않고 화면에 '가끔 다른
	//   텍스처'로만 나타난다. 신원으로 키를 잡으면 성립 자체가 불가능하다.
	//
	// Mesh::m_hashingMesh와 같은 규약이다(그쪽은 이미 이렇게 되어 있었다).
	HashedGuid m_assetId{ make_guid() };

	TextureType m_textureType = TextureType::Unknown;

	std::string m_name;
	std::string m_extension;

	math::vector2 GetImageSize() const;
	math::vector2 GetSize() const { return m_size; }

	bool IsTextureAlpha() const { return m_isTextureAlpha; }
	void SetTextureAlpha(bool isAlpha) { m_isTextureAlpha = isAlpha; }

	/// 보여 줄 그림이 있는가.
	///
	/// ★ 이 술어가 없어서 에디터 쪽 가드가 `if (texture->m_pSRV)`를 직접 봤다(T2).
	///   질문이 "DX11 뷰가 있나"였는데 알고 싶은 것은 "그림이 있나"였고, 그래서
	///   DX11이 사라지는 순간 그림이 조용히 없어질 자리였다. 지금은 그 DX11 뷰
	///   자체가 없으므로 이쪽이 유일한 답이다.
	bool HasImage() const
	{
		return (0.f < m_size.x && 0.f < m_size.y);
	}

private:
	friend class DataSystem;

	math::vector2 m_size{};
	static_assert(std::is_same_v<decltype(m_size), math::vector2>);
	bool   m_isTextureAlpha{ false };
};

class TextureManager : public Singleton<TextureManager>
{
private:
	friend class Singleton;
	TextureManager() = default;
	~TextureManager() = default;

public:
	Core::Delegate<void> OnTextureReleaseEvent{};
	Core::Delegate<void, uint32, uint32> OnTextureResizeEvent{};
};

static auto& OnResizeReleaseEvent = TextureManager::GetInstance()->OnTextureReleaseEvent;
static auto& OnResizeEvent = TextureManager::GetInstance()->OnTextureResizeEvent;