DirectX12CubemapTexture.hpp

Go to the documentation of this file.

#ifndef DIRECTX12CUBEMAPTEXTURE_HPP_
#define DIRECTX12CUBEMAPTEXTURE_HPP_
 
#include <Core/OSDef.hpp>
 
#ifdef PLATFORM_WIN
 
#include <Runtime/Texture.hpp>
#include <d3d12.h>
#include <wrl/client.h>
#include <array>
#include <string>
#include <vector>
 
namespace Sleak {
namespace RenderEngine {
class DirectX12UploadContext;
 
/// D3D12 cubemap texture, loadable from six face images or a single equirectangular panorama.
class ENGINE_API DirectX12CubemapTexture : public ::Sleak::Texture {
public:
 /// Uploads go through the shared uploader when given, else they block.
 DirectX12CubemapTexture(ID3D12Device* device, ID3D12CommandQueue* commandQueue,
                         DirectX12UploadContext* uploader = nullptr);
 ~DirectX12CubemapTexture() override;
 
 /// Loads and uploads 6 face images: +X, -X, +Y, -Y, +Z, -Z.
 bool LoadCubemap(const std::array<std::string, 6>& facePaths);
 /// Loads a single equirectangular panorama and resamples it into 6 cube faces.
 bool LoadEquirectangular(const std::string& path, uint32_t faceSize = 512);
 
 // Texture interface
 /// Unused for cubemaps; load via LoadCubemap/LoadEquirectangular instead.
 bool LoadFromMemory(const void* data, uint32_t width, uint32_t height,
                     TextureFormat format) override;
 /// Unused for cubemaps; load via LoadCubemap/LoadEquirectangular instead.
 bool LoadFromFile(const std::string& filePath) override;
 
 void Bind(uint32_t slot = 0) const override;
 void Unbind() const override;
 
 void SetFilter(TextureFilter filter) override;
 void SetWrapMode(TextureWrapMode wrapMode) override;
 
 uint32_t GetWidth() const override { return m_width; }
 uint32_t GetHeight() const override { return m_height; }
 TextureFormat GetFormat() const override { return TextureFormat::RGBA8; }
 TextureType GetType() const override { return TextureType::TextureCube; }
 
 ID3D12Resource* GetResource() const { return m_texture.Get(); }
 
 /// Binds this cubemap's SRV table at the given root parameter for a draw.
 void BindToCommandList(ID3D12GraphicsCommandList* cmdList,
                        UINT rootParameterIndex) const;
 
 // Set shared SRV heap slot (called by renderer during creation)
 void SetSharedSrvGPUHandle(D3D12_GPU_DESCRIPTOR_HANDLE handle) {
     m_srvGpuHandle = handle;
     m_usesSharedHeap = true;
 }
    // Create SRV directly into an externally-provided CPU handle (cube SRV)
    void CreateSRVIntoHandle(D3D12_CPU_DESCRIPTOR_HANDLE cpuHandle);
 
private:
    /// Builds the cubemap texture array and shader resource view from decoded face pixels.
 bool CreateCubemapFromFaces(const std::vector<unsigned char*>& faceData,
                             uint32_t faceSize);
 
 ID3D12Device* m_device = nullptr;
 ID3D12CommandQueue* m_commandQueue = nullptr;
 DirectX12UploadContext* m_uploader = nullptr;
 
 Microsoft::WRL::ComPtr<ID3D12Resource> m_texture;
 Microsoft::WRL::ComPtr<ID3D12DescriptorHeap> m_srvHeap;  // fallback
 D3D12_GPU_DESCRIPTOR_HANDLE m_srvGpuHandle = {};
 bool m_usesSharedHeap = false;
 
 uint32_t m_width = 0;
 uint32_t m_height = 0;
};
 
}  // namespace RenderEngine
}  // namespace Sleak
 
#endif  // PLATFORM_WIN
 
#endif  // DIRECTX12CUBEMAPTEXTURE_HPP_