DirectXTK12下載 - DirectXTK12原始碼下載

DirectXTK12

其他源碼

October 2024

下載

適用於 DirectX 12 的 DirectX 工具套件

http://go.microsoft.com/fwlink/?LinkID=615561

2024 年 10 月 28 日

此軟體包包含“DirectX 工具包”，這是一組幫助程式類，用於為Windows 11 和Windows 10 的通用Windows 平台(UWP) 應用程式、Xbox Series X|S 和Xbox One 的遊戲以及Win32 編寫Direct3D 12 C++ 程式碼。

此程式碼旨在使用 Visual Studio 2019 (16.11)、Visual Studio 2022、適用於 Windows v12 或更高版本的 clang 或 MinGW 12.2 進行建置。 Visual Studio 需要使用 Windows 10 May 2020 Update SDK (19041) 或更高版本。

這些元件設計為無需舊版 DirectX SDK 中的任何內容即可運作。有關詳細信息，請參閱 DirectX SDK 在哪裡？

目錄佈局

Inc
- 公共頭檔（在 DirectX C++ 命名空間中）：
  - Audio.h - 使用 XAudio2 的低階音訊 API（用於音訊公共標頭的 DirectXTK）
  - BufferHelpers.h - 用於從 CPU 資料建立 D3D 資源的 C++ 幫助程序
  - CommonStates.h - 常見的 D3D 狀態組合
  - DDSTextureLoader.h - 輕量級 DDS 檔案紋理載入器
  - DescriptorHeap.h - 管理 DX12 描述子堆的幫助程序
  - DirectXHelpers.h - 用於 D3D 程式設計的雜項 C++ 幫助程序
  - EffectPipelineStateDescription.h - 建立 PSO 的幫助程序
  - Effects.h - 用於常見渲染任務的內建著色器集
  - GamePad.h - 使用 Windows.Gaming.Input 或 GameInput 的遊戲手把控制器助手
  - GeometricPrimitive.h - 繪製基本形狀，例如立方體和球體
  - GraphicsMemory.h - 管理動態圖形記憶體分配的幫助程序
  - Keyboard.h - 鍵盤狀態追蹤助手
  - Model.h - 繪製從 .CMO、.SDKMESH 或 .VBO 檔案載入的網格
  - Mouse.h - 滑鼠助手
  - PostProcess.h - 用於常見後處理操作的一組內建著色器
  - PrimitiveBatch.h - 繪製使用者基元的簡單有效的方法
  - RenderTargetState.h - 建立 PSO 時傳達渲染目標要求的幫助程序
  - ResourceUploadBatch.h - 用於管理上傳到 GPU 的紋理資源的幫助程序
  - ScreenGrab.h - 輕量級螢幕截圖保護程式
  - SimpleMath.h - DirectXMath 的簡化 C++ 包裝器
  - SpriteBatch.h - 簡單又有效率的 2D 精靈渲染
  - SpriteFont.h - 基於位圖的文字渲染
  - VertexTypes.h - 常用頂點資料格式的結構
  - WICTextureLoader.h - 基於 WIC 的圖片檔案紋理載入器
  - XboxDDSTextureLoader.h - DDSTextureLoader 的 Xbox 專屬應用程式變體
Src
- DirectXTK 原始檔與內部實作頭文件
Audio
- 用於音訊來源檔案和內部實作標頭的 DirectXTK
build
- 包含用於建置管道的 YAML 檔案以及一些雜項建置檔案和腳本。

MakeSpriteFont 和 XWBTool 可以在 DirectX 11 的 DirectX 工具組中找到

文件

文件可在 GitHub wiki 上找到。

通知

該軟體包的所有內容和原始程式碼均受 MIT 授權條款的約束。

有關 DirectXTK12 的最新版本、錯誤報告等，請造訪 GitHub 上的專案網站。

與 DirectX 11 版本的比較

不支援 Visual Studio 定向圖形著色器語言 (DGSL) 效果著色器（即DGSLEffect ）。 CMO 檔案使用 BasicEffect 或 SkinnedEffect 材質載入。
VertexTypes 不包括用於 DGSL 管道的 VertexPositionNormalTangentColorTexture 或 VertexPositionNormalTangentColorTextureSkinning。
DirectX 11 的 DirectX 工具套件支援功能等級 9.x，而 DirectX 12 需要 Direct3D 功能等級 11.0。對於任何較低功能等級的設備，沒有預期的 DirectX 12 驅動程式。
這個函式庫假設它是為 Windows 10（又稱_WIN32_WINNT=0x0A00 ）建構的，因此它使用 XAudio 2.9 和 WIC2 以及 DirectX 12。
用於音訊、GamePad、鍵盤、滑鼠和 SimpleMath 的 DirectX 工具套件與 DirectX 11 版本相同。

發行說明

有關安全建議，請參閱 GitHub。

有關完整的變更歷史記錄，請參閱 CHANGELOG.md。

在 2024 年 6 月版本中，刪除了BufferHelpers中CreateUploadBuffer函數的預設參數initialState 。根據 DirectX 12 驗證層，上傳緩衝區唯一有效的初始狀態是D3D12_RESOURCE_STATE_GENERIC_READ 。
從 2023 年 2 月版本開始，相對滑鼠移動的 Mouse 類別實作已更新，以累積GetState呼叫之間的變更。預設情況下，每次呼叫GetState時，增量都會重置，這適用於使用相對移動但每個幀僅呼叫該方法一次的場景。如果每個幀調用它多次，則添加對EndOfInputFrame的明確呼叫以改用明確重置模型。
截至 2022 年 9 月版本，該程式庫對 DirectX 11 和 DirectX 12 版本的DirectX 工具包中具有相同名稱的不同類型使用 C++11 內聯命名空間。這提供了一個連結唯一名稱，例如DirectX::DX12::SpriteBatch ，它將出現在連結器輸出訊息中。然而，在大多數用例中，無需在客戶端程式碼中新增明確DX12命名空間解析。
從 2021 年 6 月版本開始，該程式庫透過 DXC 使用 Shader Model 6 建立 HLSL 著色器。請參閱此維基頁面以獲取更多資訊。 Microsoft GDK 專案一直使用 Shader Model 6。
從 2020 年 6 月版本開始，該程式庫根據C++ 標準第17.5.2.1.3 位元遮罩類型的建議使用類型化枚舉位元遮罩標誌。這可能會對客戶端程式碼產生重大變更影響：
- 您不能將0文字作為標誌值傳遞。相反，您必須使用適當的預設枚舉值： AudioEngine_Default 、 SoundEffectInstance_Default 、 ModelLoader_Clockwise 、 DDS_LOADER_DEFAULT或WIC_LOADER_DEFAULT 。
- 如果使用位元遮罩操作在本機建置標誌值，請使用枚舉類型而不是DWORD 。例如， WIC_LOADER_FLAGS flags = WIC_LOADER_DEFAULT; if (...) flags |= WIC_LOADER_FORCE_SRGB;
UWP 專案和 Win10 經典桌面專案包含 ARM64 平台的配置。建置這些需要安裝 ARM64 工具集。
對於 ARM64/AArch64 開發，強烈建議使用 VS 2022 編譯器，而不是 VS 2019 工具集。 Windows SDK（26100 或更高版本）與用於 ARM64 上 Win32 開發的 VS 2019 不相容。請注意，ARM32/AArch32 平台已棄用。
在 ARM64/AArch64 平台使用 clang/LLVM 時，需要 Windows 11 SDK (22000) 或更高版本。
CompileShaders.cmd腳本必須具有 Windows 樣式 (CRLF) 行結尾。如果將其變更為 Linux 樣式 (LF) 行結尾，則可能無法建立所有必要的著色器。