March 24, 2025 (#599)

2025-07-08 19:20:14 +02:00 · 2025-03-24 17:26:08 -07:00 · 2025-03-24 17:26:08 -07:00 · 92682bfa8a
commit 92682bfa8a
parent 7cb96065a4
7 changed files with 30 additions and 12 deletions
--- a/.nuget/directxtex_desktop_2019.nuspec
+++ b/.nuget/directxtex_desktop_2019.nuspec
@ -10,7 +10,7 @@
        <description>This version is for Windows desktop applications using Visual Studio 2019 (16.11) or Visual Studio 2022 on Windows 8.1 or later.

 DirectXTex, a shared source library for reading and writing .DDS files, and performing various texture content processing operations including resizing, format conversion, mip-map generation, block compression for Direct3D runtime texture resources, and height-map to normal-map conversion. This library makes use of the Windows Image Component (WIC) APIs. It also includes simple .TGA and .HDR readers and writers since these image file format are commonly used for texture content processing pipelines, but are not currently supported by a built-in WIC codec.</description>
-        <releaseNotes>Matches the October 28, 2024 release on GitHub.</releaseNotes>
+        <releaseNotes>Matches the March 24, 2025 release on GitHub.</releaseNotes>
        <projectUrl>http://go.microsoft.com/fwlink/?LinkId=248926</projectUrl>
        <repository type="git" url="https://github.com/microsoft/DirectXTex.git" />
        <icon>images\icon.jpg</icon>
--- a/.nuget/directxtex_desktop_win10.nuspec
+++ b/.nuget/directxtex_desktop_win10.nuspec
@ -10,7 +10,7 @@
        <description>This version is for Windows desktop applications using Visual Studio 2022 on Windows 10 / Windows 11 including both DirectX 11 and DirectX 12.

 DirectXTex, a shared source library for reading and writing .DDS files, and performing various texture content processing operations including resizing, format conversion, mip-map generation, block compression for Direct3D runtime texture resources, and height-map to normal-map conversion. This library makes use of the Windows Image Component (WIC) APIs. It also includes simple .TGA and .HDR readers and writers since these image file format are commonly used for texture content processing pipelines, but are not currently supported by a built-in WIC codec.</description>
-        <releaseNotes>Matches the October 28, 2024 release on GitHub.</releaseNotes>
+        <releaseNotes>Matches the March 24, 2025 release on GitHub.</releaseNotes>
        <projectUrl>http://go.microsoft.com/fwlink/?LinkId=248926</projectUrl>
        <repository type="git" url="https://github.com/microsoft/DirectXTex.git" />
        <icon>images\icon.jpg</icon>
--- a/.nuget/directxtex_uwp.nuspec
+++ b/.nuget/directxtex_uwp.nuspec
@ -10,7 +10,7 @@
        <description>This version is for Universal Windows Platform apps on Windows 10 / Windows 11 using Visual Studio 2022.

 DirectXTex, a shared source library for reading and writing .DDS files, and performing various texture content processing operations including resizing, format conversion, mip-map generation, block compression for Direct3D runtime texture resources, and height-map to normal-map conversion. This library makes use of the Windows Image Component (WIC) APIs. It also includes simple .TGA and .HDR readers and writers since these image file format are commonly used for texture content processing pipelines, but are not currently supported by a built-in WIC codec.</description>
-        <releaseNotes>Matches the October 28, 2024 release on GitHub.</releaseNotes>
+        <releaseNotes>Matches the March 24, 2025 release on GitHub.</releaseNotes>
        <projectUrl>http://go.microsoft.com/fwlink/?LinkId=248926</projectUrl>
        <repository type="git" url="https://github.com/microsoft/DirectXTex.git" />
        <icon>images\icon.jpg</icon>
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -6,9 +6,24 @@ Release available for download on [GitHub](https://github.com/microsoft/DirectXT

 ## Release History

+### March 24, 2025
+* C++17 `std::byte` support for `FromMemory` functions
+* Added **ComputeTileShape** method to compute Direct3D Tiled Resource standard dimensions
+* Added *isd3d12* defaulted parameter to `IsPlaner` for change to depth/stencil formats
+* DDS reader `DDS_FLAGS_PERMISSIVE` supports a DX10 variant with 'incorrect' cubemap counts
+* Retired support for Windows 7 and Windows 8.0
+* CMake project updates including support for BUILD_SHARED_LIBS (i.e. DLL vs. static library)
+* texconv:
+  * Add `--ignore-srgb` switch which passes `TGA_FLAGS_IGNORE_SRGB` or `WIC_FLAGS_IGNORE_SRGB`
+  * Add `--wic-uncompressed` switch which applies to TIFF and HEIF
+  * Updates for `--wic-lossless` (JPEG-XR only) and `--wic-quality` (also applies to HEIF) switches
+  * The `--ignore-mips` switch now properly blocks use on array textures
+  * Remove 'heic' file extension for writing which is only supported for reading by *HEIF Image Extensions*
+  * Add support for 'phm' file extension to indicate Portable Half Map
+
 ### October 28, 2024
 * All enums now use ``uint32_t`` as the underlying type rather than ``unsigned long`` or ``int``.
-* Added ``BytesPerBlock`` utility helper
+* Added **BytesPerBlock** utility helper
 * Fixed bug in DirectX 12 `CaptureTexture` for MSAA resolve state handling
 * texassemble, texconv, texdiag:
  * Add "GNU-style" *--long-options* to the command-line tools (all existing switches are still supported)
@ -25,7 +40,7 @@ Release available for download on [GitHub](https://github.com/microsoft/DirectXT
 * texconv: Added `-ignoremips` option to handle some invalid/truncated DDS files
 * EXR auxiliary reader returns 6 images for files with 'envmap' metadata
 * PNG auxiliary reader/writer fixed for single channel images (`DXGI_FORMAT_R8_UNORM`)
-* Xbox auxiliary now has `EncodeDDSHeader` function
+* Xbox auxiliary now has **EncodeDDSHeader** function
 * ScreenGrab9 minor DDS header fix when writing A2W10V10U10 legacy mixed formats
 * CMake project updates including support for ARM64EC
 * Added GitHub Actions YAML files
@ -65,7 +80,7 @@ Release available for download on [GitHub](https://github.com/microsoft/DirectXT
 * texconv: ``-permissive`` switch added to opt-in use of new flag when reading DDS files

 ### September 1, 2023
-* ``CompressEx`` and ``ConvertEx`` functions added with status callback and options structs
+* **CompressEx** and **ConvertEx** functions added with status callback and options structs
 * Added optional ``DDSMetaData`` return for Ex versions of DDS loader functions
 * Added ``TEX_ALPHA_WEIGHT_DEFAULT`` constant (set to 1.0)
 * DDS reader updated to support variant used by *Unreal Tournament 2004*
@ -120,7 +135,7 @@ Release available for download on [GitHub](https://github.com/microsoft/DirectXT
 * Code review

 ### July 29, 2022
-* Added ``MakeLinear`` DXGI_FORMAT utility function.
+* Added **MakeLinear** DXGI_FORMAT utility function.
 * *breaking change* ``CreateTextureEx`` and ``CreateShaderResourceViewEx`` functions now use ``CREATETEX_FLAGS`` instead of a ``bool forceSRGB`` parameter.
 * Updates for MinGW ABI fixes for DirectX12 in the latest DirectX-Headers.
 * CMake and MSBuild project updates
@ -129,7 +144,7 @@ Release available for download on [GitHub](https://github.com/microsoft/DirectXT

 ### May 9, 2022
 * TGA reader updated to support 24-bit paletted uncompressed color-mapped images (used by a DCC application)
-* Added `IsBGR` utility method
+* Added **IsBGR** utility method
 * Workaround for driver issue on some systems using DirectX 11 `Capture` method
 * Fix for problem with resizing/mipmaps generation for HDR content using box/fant filter which should avoid going through WIC code paths
 * Minor updates for VS 2022 (17.2)
@ -150,6 +165,7 @@ Release available for download on [GitHub](https://github.com/microsoft/DirectXT
 * Optional C++17 usage in a few places

 ### February 28, 2022
+* Made **EncodeDDSHeader** a public function instead of being internal only
 * Updated D3DX12 internal copy with latest changes from GitHub
 * Code and project review including fixing clang v13 warnings
 * Added CMakePresets.json
@ -217,7 +233,7 @@ Release available for download on [GitHub](https://github.com/microsoft/DirectXT

 ### August 15, 2020
 * Added ``DDS_FLAGS_ALLOW_LARGE_FILES`` flag for DDS loader to allow textures with dimensions that are too big for Direct3D
-* Added ``FormatDataType`` function
+* Added **FormatDataType** function
 * Fixed bug with DX12 ``Capture`` with 'small alignment' textures
 * Code review and project updates
 * Added GDK projects
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@ -3,7 +3,7 @@

 cmake_minimum_required (VERSION 3.20)

-set(DIRECTXTEX_VERSION 2.0.6)
+set(DIRECTXTEX_VERSION 2.0.7)

 if(XBOX_CONSOLE_TARGET STREQUAL "durango")
  set(CMAKE_TRY_COMPILE_TARGET_TYPE "STATIC_LIBRARY")
--- a/DirectXTex/DirectXTex.h
+++ b/DirectXTex/DirectXTex.h
@ -47,7 +47,7 @@ struct IWICImagingFactory;
 struct IWICMetadataQueryReader;
 #endif

-#define DIRECTX_TEX_VERSION 206
+#define DIRECTX_TEX_VERSION 207

 #ifdef DIRECTX_TEX_EXPORT
 #define DIRECTX_TEX_API __declspec(dllexport)
--- a/README.md
+++ b/README.md
@ -6,7 +6,7 @@ http://go.microsoft.com/fwlink/?LinkId=248926

 Copyright (c) Microsoft Corporation.

-**October 28, 2024**
+**March 24, 2025**

 This package contains DirectXTex, a shared source library for reading and writing ``.DDS`` files, and performing various texture content processing operations including resizing, format conversion, mip-map generation, block compression for Direct3D runtime texture resources, and height-map to normal-map conversion. This library makes use of the Windows Image Component (WIC) APIs. It also includes ``.TGA`` and ``.HDR`` readers and writers since these image file formats are commonly used for texture content processing pipelines, but are not currently supported by a built-in WIC codec.

@ -84,6 +84,8 @@ FOR SECURITY ADVISORIES, see [GitHub](https://github.com/microsoft/DirectXTex/se

 For a full change history, see [CHANGELOG.md](https://github.com/microsoft/DirectXTex/blob/main/CHANGELOG.md).

+* Starting with the March 2025 release, Windows 7 and Windows 8.0 support has been retired.
+
 * Starting with the July 2022 release, the ``bool forceSRGB`` parameter for the CreateTextureEx and CreateShaderResourceViewEx functions is now a ``CREATETEX_FLAGS`` typed enum bitmask flag parameter. This may have a *breaking change* impact to client code. Replace ``true`` with ``CREATETEX_FORCE_SRGB`` and ``false`` with ``CREATETEX_DEFAULT``.

 * Starting with the June 2020 release, this library makes use of typed enum bitmask flags per the recommendation of the _C++ Standard_ section *17.5.2.1.3 Bitmask types*. This is consistent with Direct3D 12's use of the ``DEFINE_ENUM_FLAG_OPERATORS`` macro. This may have *breaking change* impacts to client code: