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 、 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-偏差