DirectXTex 下載 - DirectXTex 原始碼下載

直接XTex

其他源碼

October

下載

DirectXTex 紋理處理庫

http://go.microsoft.com/fwlink/?LinkId=248926

2024 年 10 月 28 日

該軟體包包含 DirectXTex，這是一個共享來源庫，用於讀取和寫入.DDS文件，並執行各種紋理內容處理操作，包括調整大小、格式轉換、mip-map 生成、Direct3D 運行時紋理資源的塊壓縮以及高度圖到法線。該庫使用 Windows Image Component (WIC) API。它還包括.TGA和.HDR讀取器和寫入器，因為這些圖像檔案格式通常用於紋理內容處理管道，但目前不受內建 WIC 編解碼器支援。

此程式碼旨在使用 Visual Studio 2019 (16.11)、Visual Studio 2022、適用於 Windows v12 或更高版本的 clang 或 MinGW 12.2 進行建置。 Visual Studio 需要使用 Windows 10 May 2020 Update SDK (19041) 或更高版本。它還可以使用 GCC 11 或更高版本為 Linux 的 Windows 子系統建置。

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

目錄佈局

DirectXTex
- 其中包含 DirectXTex 庫。其中包括功能齊全的DDS 讀取器和寫入器（包括傳統格式轉換）、TGA 讀取器和寫入器、HDR 讀取器和寫入器、基於WIC 的位圖讀取器和寫入器（BMP、JPEG、PNG、TIFF 和高清照片），以及各種紋理處理功能。這主要是為了工具的使用。

這裡的大多數頭檔僅用於庫的內部實作（ BC.h 、 BCDirectCompute.h 、 DDS.h 、 DirectXTexP.h等）。只有DirectXTex.h和DirectXTex.inl才是庫的「公共」頭檔。

Auxiliary
- 包含 DirectXTex 庫的可選來源文件，例如使用 OpenEXR 庫的適配器載入函數、Xbox 紋理平鋪擴充功能等。
Common
- 包含 DirectXTex 程式庫和工具使用的共用來源標頭。
Texconv
- 此 DirectXTex 範例是使用 DirectXTex 而不是 D3DX 的 DirectX SDK 中的 texconv 命令列紋理實用程式的實作。
  它支援與擴充紋理轉換工具( texconvex.exe ) 舊版 DirectX SDK 實用程式相同的參數。主要區別是-10和-11參數不適用以及過濾器名稱（ POINT 、 LINEAR 、 CUBIC 、 FANT或BOX 、 TRIANGLE 、 *_DITHER 、 *_DITHER_DIFFUSION ）。這也包括對 JPEG XR（高清照片）點陣圖格式的支援。
Texassemble
- 此 DirectXTex 範例是一個命令列實用程序，用於從一組單獨的輸入影像檔案建立立方體貼圖、體積貼圖或紋理數組。
Texdiag
- 此 DirectXTex 範例是用於分析圖像內容的命令列實用程序，主要用於調試目的。
DDSView
- 此 DirectXTex 範例是一個簡單的基於 Direct3D 11 的 DDS 檔案檢視器。對於陣列紋理或體積貼圖，「<」和「>」鍵盤鍵將顯示 DDS 中包含的不同影像。 “1”到“0”鍵也可用於跳到特定影像索引。
DDSTextureLoader
- 其中包含舊版 DirectX SDK 範例DDSWithoutD3DX11紋理載入程式碼的簡化版本，用於簡單的輕量級執行時間 DDS 載入程式。有適用於 Direct3D 9、Direct3D 11 和 Direct3D 12 的版本。這非常適合運行時使用，並支援完整的 Direct3D 紋理資源（1D、2D、體積貼圖、立方體貼圖、mipmap 等級、紋理陣列、BC 格式等）。
ScreenGrab
- 其中包含 Direct3D 9、Direct3D 11 和 Direct3D 12 的紋理寫入模組，主要用於建立螢幕截圖。影像被寫入為 DDS 或使用 WIC 的影像檔案格式。
WICTextureLoader
- 它包含一個 Direct3D 9、Direct3D 11 和 Direct3D 12 2D 紋理載入器，使用 WIC 載入點陣圖（BMP、JPEG、PNG、高清照片或其他 WIC 支援的檔案容器），根據目前功能等級（或透過明確參數），如果需要，將格式轉換為DXGI_FORMAT，然後建立2D 紋理。請注意，這不支援 1D 紋理、體積紋理、立方體貼圖或紋理陣列。建議使用 DDSTextureLoader 來完全「預煮」紋理，以獲得最佳性能和圖像質量，但此加載器對於在運行時從標準圖像檔案創建簡單的 2D 紋理非常有用。

DDSTextureLoader11、ScreenGrab11 和 WICTextureLoader11 是 DX11 DirectX 工具套件中提供的相同模組的「獨立」版本

DDSTextureLoader12、ScreenGrab12 和 WICTextureLoader12 是 DX12 DirectX 工具套件中提供的相同模組的「獨立」版本。

build
- 包含用於建置管道的 YAML 檔案以及一些雜項建置檔案和腳本。

文件

文件可在 GitHub wiki 上找到。

通知

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

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

發行說明

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

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

從 2022 年 7 月版本開始，CreateTextureEx 和 CreateShaderResourceViewEx 函數的bool forceSRGB參數現在是CREATETEX_FLAGS類型枚舉位元遮罩標誌參數。這可能會對客戶端程式碼產生重大變更影響。將true替換為CREATETEX_FORCE_SRGB ，將false替換為CREATETEX_DEFAULT 。
從 2020 年 6 月版本開始，該程式庫根據C++ 標準第17.5.2.1.3 位元遮罩類型的建議使用類型化枚舉位元遮罩標誌。這與 Direct3D 12 對DEFINE_ENUM_FLAG_OPERATORS宏的使用一致。這可能會對客戶端程式碼產生重大變更影響：
- 您不能將0文字作為標誌值傳遞。相反，您必須使用適當的預設枚舉值： CP_FLAGS_NONE 、 DDS_FLAGS_NONE 、 WIC_FLAGS_NONE 、 TEX_FR_ROTATE0 、 TEX_FILTER_DEFAULT 、 TEX_FILTER_DEFAULT 、 TEX_FILTER_DEFAULT 、 TEX_FILTER_DEFAULT 、 CNMAP_DEFAULT 、 CNMAP_DEFAULT
- 如果使用位元遮罩操作在本機建置標誌值，請使用枚舉類型而不是DWORD 。例如， DDS_FLAGS flags = DDS_FLAGS_NONE; if (...) flags |= DDS_FLAGS_EXPAND_LUMINANCE;
- 如果某些標誌重疊，您可以使用|組合相關類型： TEX_FILTER_FLAGS過濾器模式與WIC_FLAGS組合， TEX_FILTER_FLAGS sRGB 標誌與TEX_PMALPHA_FLAGS或TEX_COMPRESS_FLAGS組合。沒有定義其他位元運算子。例如， WIC_FLAGS wicFlags = WIC_FLAGS_NONE | TEX_FILTER_CUBIC;
除非系統安裝了第 3 方 WIC 編解碼器，否則 WICTextureLoader 無法載入.TGA或.HDR檔案。您必須使用 DirectXTex 程式庫來支援 TGA/HDR 檔案格式，而不依賴附加 WIC 編解碼器。
UWP 專案和 Win10 經典桌面專案包含 ARM64 平台的配置。建置這些需要安裝 ARM64 工具集。
對於 ARM64/AArch64 開發，強烈建議使用 VS 2022 編譯器，而不是 VS 2019 工具集。 Windows SDK（26100 或更高版本）與 VS 2019 for Win32 on ARM64 開發不相容。請注意，ARM32/AArch32 平台已棄用。
在 ARM64/AArch64 平台使用 clang/LLVM 時，需要 Windows 11 SDK (22000) 或更高版本。
CompileShaders.cmd腳本必須具有 Windows 樣式 (CRLF) 行結尾。如果將其變更為 Linux 樣式 (LF) 行結尾，則可能無法建立所有所需的著色器。
截至 2024 年 10 月版本，命令列工具也支援使用-- GNU 風格長選項。所有現有開關都繼續起作用，但根據此表，現在不建議使用某些-選項：

特克斯彙編		特克斯康夫		文字診斷
-色調映射	--色調圖	-壞尾巴	--壞尾巴	-壞尾巴	--壞尾巴
-背景顏色	--gif-背景顏色	-修復bc4x4	--修復-bc-4x4	-忽略mips	--忽略 mips
-調配	--調配	-忽略mips	--忽略 mips	- 寬容的	--寬容的
-stripmips	--strip-mips	-反轉	--反轉-y	-目標x	--目標-x
		-保持覆蓋範圍	--保持覆蓋範圍
		- 寬容的	--寬容的
		-重建z	--重建-z
		-旋轉顏色	--旋轉顏色
		-singleproc	--單一進程
		-調配	--調配
		-tgazeroalpha	--tga-零-阿爾法
		-定時	- 定時
		-色調映射	--色調圖
		- 無線無損	--wic-無損
		-wicmulti	--wic-多幀
		-x2偏差	--x2-偏差