mirror of
https://github.com/microsoft/DirectXTex
synced 2024-11-25 13:50:06 +00:00
173 lines
6.6 KiB
C
173 lines
6.6 KiB
C
|
//--------------------------------------------------------------------------------------
|
||
|
|
// File: DirectXTexXbox.h
|
||
|
|
//
|
||
|
|
// DirectXTex Auxillary functions for Xbox texture processing
|
||
|
|
//
|
||
|
|
// Copyright (c) Microsoft Corporation.
|
||
|
|
// Licensed under the MIT License.
|
||
|
|
//--------------------------------------------------------------------------------------
|
||
|
|
|
||
|
|
#pragma once
|
||
|
|
|
||
|
|
#ifndef _M_X64
|
||
|
|
#error This tool is only supported for x64 native
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#include "DirectXTex.h"
|
||
|
|
|
||
|
|
#ifdef __clang__
|
||
|
|
#pragma clang diagnostic push
|
||
|
|
#pragma clang diagnostic ignored "-Wnonportable-system-include-path"
|
||
|
|
#pragma clang diagnostic ignored "-Wold-style-cast"
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if defined(_GAMING_XBOX_SCARLETT) || defined(_USE_SCARLETT)
|
||
|
|
#include <xg_xs.h>
|
||
|
|
#else
|
||
|
|
#include <xg.h>
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifdef __clang__
|
||
|
|
#pragma clang diagnostic pop
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifdef _GAMING_XBOX_SCARLETT
|
||
|
|
#include <d3d12_xs.h>
|
||
|
|
#elif defined(_GAMING_XBOX)
|
||
|
|
#include <d3d12_x.h>
|
||
|
|
#elif defined(_XBOX_ONE) && defined(_TITLE)
|
||
|
|
#include <d3d11_x.h>
|
||
|
|
#else
|
||
|
|
#include <d3d11_1.h>
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#define DIRECTX_TEX_XBOX_VERSION 150
|
||
|
|
|
||
|
|
namespace Xbox
|
||
|
|
{
|
||
|
|
#if defined(_GAMING_XBOX_SCARLETT) || defined(_USE_SCARLETT)
|
||
|
|
using XboxTileMode = XG_SWIZZLE_MODE;
|
||
|
|
constexpr XboxTileMode c_XboxTileModeInvalid = XG_SWIZZLE_MODE_INVALID;
|
||
|
|
constexpr XboxTileMode c_XboxTileModeLinear = XG_SWIZZLE_MODE_LINEAR;
|
||
|
|
#else
|
||
|
|
using XboxTileMode = XG_TILE_MODE;
|
||
|
|
constexpr XboxTileMode c_XboxTileModeInvalid = XG_TILE_MODE_INVALID;
|
||
|
|
constexpr XboxTileMode c_XboxTileModeLinear = XG_TILE_MODE_LINEAR;
|
||
|
|
#endif
|
||
|
|
|
||
|
|
class XboxImage
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
XboxImage() noexcept
|
||
|
|
: dataSize(0), baseAlignment(0), tilemode(c_XboxTileModeInvalid), metadata{}, memory(nullptr) {}
|
||
|
|
XboxImage(XboxImage&& moveFrom) noexcept
|
||
|
|
: dataSize(0), baseAlignment(0), tilemode(c_XboxTileModeInvalid), metadata{}, memory(nullptr) { *this = std::move(moveFrom); }
|
||
|
|
~XboxImage() { Release(); }
|
||
|
|
|
||
|
|
XboxImage& __cdecl operator= (XboxImage&& moveFrom) noexcept;
|
||
|
|
|
||
|
|
XboxImage(const XboxImage&) = delete;
|
||
|
|
XboxImage& operator=(const XboxImage&) = delete;
|
||
|
|
|
||
|
|
HRESULT Initialize(_In_ const XG_TEXTURE1D_DESC& desc, _In_ const XG_RESOURCE_LAYOUT& layout, _In_ uint32_t miscFlags2 = 0);
|
||
|
|
HRESULT Initialize(_In_ const XG_TEXTURE2D_DESC& desc, _In_ const XG_RESOURCE_LAYOUT& layout, _In_ uint32_t miscFlags2 = 0);
|
||
|
|
HRESULT Initialize(_In_ const XG_TEXTURE3D_DESC& desc, _In_ const XG_RESOURCE_LAYOUT& layout, _In_ uint32_t miscFlags2 = 0);
|
||
|
|
HRESULT Initialize(_In_ const DirectX::TexMetadata& mdata, _In_ XboxTileMode tm, _In_ uint32_t size, _In_ uint32_t alignment);
|
||
|
|
|
||
|
|
void Release();
|
||
|
|
|
||
|
|
const DirectX::TexMetadata& GetMetadata() const { return metadata; }
|
||
|
|
XboxTileMode GetTileMode() const { return tilemode; }
|
||
|
|
|
||
|
|
uint32_t GetSize() const { return dataSize; }
|
||
|
|
uint32_t GetAlignment() const { return baseAlignment; }
|
||
|
|
uint8_t* GetPointer() const { return memory; }
|
||
|
|
|
||
|
|
private:
|
||
|
|
uint32_t dataSize;
|
||
|
|
uint32_t baseAlignment;
|
||
|
|
XboxTileMode tilemode;
|
||
|
|
DirectX::TexMetadata metadata;
|
||
|
|
uint8_t* memory;
|
||
|
|
};
|
||
|
|
|
||
|
|
//---------------------------------------------------------------------------------
|
||
|
|
// Image I/O
|
||
|
|
|
||
|
|
HRESULT GetMetadataFromDDSMemory(
|
||
|
|
_In_reads_bytes_(size) const void* pSource, _In_ size_t size,
|
||
|
|
_Out_ DirectX::TexMetadata& metadata, _Out_ bool& isXbox);
|
||
|
|
HRESULT GetMetadataFromDDSFile(
|
||
|
|
_In_z_ const wchar_t* szFile, _Out_ DirectX::TexMetadata& metadata, _Out_ bool& isXbox);
|
||
|
|
|
||
|
|
HRESULT GetMetadataFromDDSMemoryEx(
|
||
|
|
_In_reads_bytes_(size) const void* pSource, _In_ size_t size,
|
||
|
|
_Out_ DirectX::TexMetadata& metadata, _Out_ bool& isXbox,
|
||
|
|
_Out_opt_ DirectX::DDSMetaData* ddPixelFormat);
|
||
|
|
HRESULT GetMetadataFromDDSFileEx(
|
||
|
|
_In_z_ const wchar_t* szFile, _Out_ DirectX::TexMetadata& metadata, _Out_ bool& isXbox,
|
||
|
|
_Out_opt_ DirectX::DDSMetaData* ddPixelFormat);
|
||
|
|
|
||
|
|
HRESULT LoadFromDDSMemory(
|
||
|
|
_In_reads_bytes_(size) const void* pSource, _In_ size_t size,
|
||
|
|
_Out_opt_ DirectX::TexMetadata* metadata, _Out_ XboxImage& image);
|
||
|
|
HRESULT LoadFromDDSFile(
|
||
|
|
_In_z_ const wchar_t* szFile,
|
||
|
|
_Out_opt_ DirectX::TexMetadata* metadata, _Out_ XboxImage& image);
|
||
|
|
|
||
|
|
HRESULT LoadFromDDSMemoryEx(
|
||
|
|
_In_reads_bytes_(size) const void* pSource, _In_ size_t size,
|
||
|
|
_Out_opt_ DirectX::TexMetadata* metadata,
|
||
|
|
_Out_opt_ DirectX::DDSMetaData* ddPixelFormat,
|
||
|
|
_Out_ XboxImage& image);
|
||
|
|
HRESULT LoadFromDDSFileEx(
|
||
|
|
_In_z_ const wchar_t* szFile,
|
||
|
|
_Out_opt_ DirectX::TexMetadata* metadata,
|
||
|
|
_Out_opt_ DirectX::DDSMetaData* ddPixelFormat,
|
||
|
|
_Out_ XboxImage& image);
|
||
|
|
|
||
|
|
HRESULT SaveToDDSMemory(_In_ const XboxImage& xbox, _Out_ DirectX::Blob& blob);
|
||
|
|
HRESULT SaveToDDSFile(_In_ const XboxImage& xbox, _In_z_ const wchar_t* szFile);
|
||
|
|
|
||
|
|
//---------------------------------------------------------------------------------
|
||
|
|
// Xbox Texture Tiling / Detiling (requires XG DLL to be present at runtime)
|
||
|
|
|
||
|
|
HRESULT Tile(_In_ const DirectX::Image& srcImage, _Out_ XboxImage& xbox, _In_ XboxTileMode mode = c_XboxTileModeInvalid);
|
||
|
|
HRESULT Tile(
|
||
|
|
_In_ const DirectX::Image* srcImages, _In_ size_t nimages, _In_ const DirectX::TexMetadata& metadata,
|
||
|
|
_Out_ XboxImage& xbox, _In_ XboxTileMode mode = c_XboxTileModeInvalid);
|
||
|
|
|
||
|
|
HRESULT Detile(_In_ const XboxImage& xbox, _Out_ DirectX::ScratchImage& image);
|
||
|
|
|
||
|
|
//---------------------------------------------------------------------------------
|
||
|
|
// Direct3D 11.X functions
|
||
|
|
|
||
|
|
#if defined(_XBOX_ONE) && defined(_TITLE) && defined(__d3d11_x_h__)
|
||
|
|
|
||
|
|
HRESULT CreateTexture(
|
||
|
|
_In_ ID3D11DeviceX* d3dDevice,
|
||
|
|
_In_ const XboxImage& xbox, _Outptr_opt_ ID3D11Resource** ppResource, _Outptr_ void** grfxMemory);
|
||
|
|
|
||
|
|
HRESULT CreateShaderResourceView(
|
||
|
|
_In_ ID3D11DeviceX* d3dDevice,
|
||
|
|
_In_ const XboxImage& xbox, _Outptr_opt_ ID3D11ShaderResourceView** ppSRV, _Outptr_ void** grfxMemory);
|
||
|
|
|
||
|
|
void FreeTextureMemory(_In_ ID3D11DeviceX* d3dDevice, _In_opt_ void* grfxMemory);
|
||
|
|
|
||
|
|
#endif
|
||
|
|
|
||
|
|
//---------------------------------------------------------------------------------
|
||
|
|
// Direct3D 12.X functions
|
||
|
|
|
||
|
|
#if ((defined(_XBOX_ONE) && defined(_TITLE)) || defined(_GAMING_XBOX)) && (defined(__d3d12_x_h__) || defined(__XBOX_D3D12_X__))
|
||
|
|
|
||
|
|
HRESULT CreateTexture(
|
||
|
|
_In_ ID3D12Device* d3dDevice,
|
||
|
|
_In_ const XboxImage& xbox, _Outptr_opt_ ID3D12Resource** ppResource, _Outptr_ void** grfxMemory);
|
||
|
|
|
||
|
|
void FreeTextureMemory(_In_ ID3D12Device* d3dDevice, _In_opt_ void* grfxMemory);
|
||
|
|
|
||
|
|
#endif
|
||
|
|
|
||
|
|
} // namespace
|