Skip to content

Commit

Permalink
April 26, 2019
Browse files Browse the repository at this point in the history
  • Loading branch information
walbourn committed Apr 26, 2019
1 parent 45ea8ff commit f86da52
Show file tree
Hide file tree
Showing 4 changed files with 54 additions and 39 deletions.
6 changes: 3 additions & 3 deletions .nuget/directxtex_desktop_2015.nuspec
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
<metadata minClientVersion="2.8.6">
<id>directxtex_desktop_2015</id>
<version>0.0.0-SpecifyVersionOnCommandline</version>
<title>DirectXTex Library (VS 2015/VS 2017 Win32)</title>
<title>DirectXTex Library (VS 2015/2017/2019 Win32)</title>
<authors>Microsoft</authors>
<owners>microsoft,directxtk</owners>
<summary>DirectXTex texture processing library</summary>
<description>This version is for Windows desktop applications using Visual Studio 2015 Update 3 or Visual Studio 2017 and supports Windows 7 / DirectX 11.
<description>This version is for Windows desktop applications using Visual Studio 2015 Update 3, Visual Studio 2017, or Visual Studio 2019 and supports Windows 7 / DirectX 11.

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 February 7, 2019 release on GitHub.</releaseNotes>
<releaseNotes>Matches the April 26, 2019 release on GitHub.</releaseNotes>
<projectUrl>http://go.microsoft.com/fwlink/?LinkId=248926</projectUrl>
<iconUrl>https://github.com/Microsoft/DirectXTex/wiki/X_jpg.jpg</iconUrl>
<licenseUrl>http://opensource.org/licenses/MIT</licenseUrl>
Expand Down
4 changes: 2 additions & 2 deletions .nuget/directxtex_desktop_win10.nuspec
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,10 @@
<authors>Microsoft</authors>
<owners>microsoft,directxtk</owners>
<summary>DirectXTex texture processing library</summary>
<description>This version is for Windows desktop applications using Visual Studio 2015 Update 3 or Visual Studio 2017 and supports Windows 10 including both DirectX 11 and DirectX 12.
<description>This version is for Windows desktop applications using Visual Studio 2015 Update 3, Visual Studio 2017, or Visual Studio 2019 and supports Windows 10 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 February 7, 2019 release on GitHub.</releaseNotes>
<releaseNotes>Matches the April 26, 2019 release on GitHub.</releaseNotes>
<projectUrl>http://go.microsoft.com/fwlink/?LinkId=248926</projectUrl>
<iconUrl>https://github.com/Microsoft/DirectXTex/wiki/X_jpg.jpg</iconUrl>
<licenseUrl>http://opensource.org/licenses/MIT</licenseUrl>
Expand Down
4 changes: 2 additions & 2 deletions .nuget/directxtex_uwp.nuspec
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,10 @@
<authors>Microsoft</authors>
<owners>microsoft,directxtk</owners>
<summary>DirectXTex texture processing library</summary>
<description>This version is for Universal Windows Platform apps on Windows 10 using Visual Studio 2015 Update 3 or Visual Studio 2017.
<description>This version is for Universal Windows Platform apps on Windows 10 using Visual Studio 2017 or Visual Studio 2019.

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 February 7, 2019 release on GitHub.</releaseNotes>
<releaseNotes>Matches the April 26, 2019 release on GitHub.</releaseNotes>
<projectUrl>http://go.microsoft.com/fwlink/?LinkId=248926</projectUrl>
<iconUrl>https://github.com/Microsoft/DirectXTex/wiki/X_jpg.jpg</iconUrl>
<licenseUrl>http://opensource.org/licenses/MIT</licenseUrl>
Expand Down
79 changes: 47 additions & 32 deletions ReadMe.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ DIRECTX TEXTURE LIBRARY (DirectXTex)

Copyright (c) Microsoft Corporation. All rights reserved.

February 7, 2019
April 26, 2019

This package contains DirectXTex, a shared source library for reading and writing DDS
files, and performing various texture content processing operations including
Expand All @@ -13,10 +13,14 @@ use of the Windows Image Component (WIC) APIs. It also includes simple .TGA and
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.

This code is designed to build with Visual Studio 2015 Update 3 or Visual Studio 2017.
It is recommended that you make use of VS 2015 Update 3, Windows Tools 1.4.1, and the
Windows 10 Anniversary Update SDK (14393) -or- VS 2017 (15.9 update) with the
Windows 10 October 2018 Update SDK (17763).
This code is designed to build with Visual Studio 2015 Update 3, Visual Studio 2017,
or Visual Studio 2019. It is recommended that you make use of VS 2015 Update 3,
Windows Tools 1.4.1, and the Windows 10 Anniversary Update SDK (14393) -or-
VS 2017 (15.9 update) / VS 2019 with the Windows 10 October 2018 Update SDK (17763).

These components are designed to work without requiring any content from the
legacy DirectX SDK. For details, see "Where is the DirectX SDK?"
<https://aka.ms/dxsdk>.

DirectXTex\
This contains the DirectXTex library. This includes a full-featured DDS reader and writer
Expand All @@ -36,7 +40,6 @@ Texconv\
SDK utility. The primary differences are the -10 and -11 arguments are not applicable and the
filter names (POINT, LINEAR, CUBIC, FANT or BOX, TRIANGLE, *_DITHER, *_DITHER_DIFFUSION).
This also includes support for the JPEG XR (HD Photo) bitmap format.
(see <http://blogs.msdn.com/b/chuckw/archive/2011/01/19/known-issue-texconvex.aspx>)

See <https://github.com/Microsoft/DirectXTex/wiki/Texconv> for details.

Expand Down Expand Up @@ -100,44 +103,56 @@ https://opensource.microsoft.com/codeofconduct/
------------------------------------
RELEASE NOTES

* The alpha mode specification for DDS files was updated between the March 2013 and April 2013 releases. Any
DDS files created using the DDS_FLAGS_FORCE_DX10_EXT_MISC2 flag or the texconv -dx10 switch using the
March 2013 release should be refreshed.
* The alpha mode specification for DDS files was updated between the March 2013
and April 2013 releases. Any DDS files created using the DDS_FLAGS_FORCE_DX10_EXT_MISC2
flag or the texconv -dx10 switch using the March 2013 release should be refreshed.

* Due to the underlying Windows BMP WIC codec, alpha channels are not supported for 16bpp or 32bpp BMP pixel format
files. The Windows 8.x and Windows 10 version of the Windows BMP WIC codec does support 32bpp pixel formats with
alpha when using the BITMAPV5HEADER file header. Note the updated WIC is available on Windows 7 SP1 with KB 2670838
installed.
* Due to the underlying Windows BMP WIC codec, alpha channels are not supported for 16bpp
or 32bpp BMP pixel format files. The Windows 8.x and Windows 10 version of the Windows
BMP WIC codec does support 32bpp pixel formats with alpha when using the BITMAPV5HEADER
file header. Note the updated WIC is available on Windows 7 SP1 with KB 2670838 installed.

* While DXGI 1.0 and DXGI 1.1 include 5:6:5 (DXGI_FORMAT_B5G6R5_UNORM) and 5:5:5:1 (DXGI_FORMAT_B5G5R5A1_UNORM)
pixel format enumerations, the DirectX 10.x and 11.0 Runtimes do not support these formats for use with Direct3D.
The DirectX 11.1 runtime, DXGI 1.2, and the WDDM 1.2 driver model fully support 16bpp formats (5:6:5, 5:5:5:1, and
4:4:4:4).
* While DXGI 1.0 and DXGI 1.1 include 5:6:5 (DXGI_FORMAT_B5G6R5_UNORM) and
5:5:5:1 (DXGI_FORMAT_B5G5R5A1_UNORM) pixel format enumerations, the DirectX 10.x and
11.0 Runtimes do not support these formats for use with Direct3D. The DirectX 11.1 runtime,
DXGI 1.2, and the WDDM 1.2 driver model fully support 16bpp formats (5:6:5, 5:5:5:1, and
4:4:4:4).

* WICTextureLoader cannot load .TGA or .HDR files unless the system has a 3rd party WIC codec installed. You
must use the DirectXTex library for TGA/HDR file format support without relying on an add-on WIC codec.
* WICTextureLoader cannot load .TGA or .HDR files unless the system has a 3rd party WIC
codec installed. You must use the DirectXTex library for TGA/HDR file format support
without relying on an add-on WIC codec.

* Loading of 96bpp floating-point TIFF files results in a corrupted image prior to Windows 8. This fix is available
on Windows 7 SP1 with KB 2670838 installed.
* Loading of 96bpp floating-point TIFF files results in a corrupted image prior to Windows 8.
This fix is available on Windows 7 SP1 with KB 2670838 installed.

* The VS 2017 projects make use of /permissive- for improved C++ standard conformance. Use of a Windows 10 SDK prior to
the Fall Creators Update (16299) or an Xbox One XDK prior to June 2017 QFE 4 may result in failures due to problems
with the system headers. You can work around these by disabling this switch in the project files which is found
in the <ConformanceMode> elements.
* The VS 2017/2019 projects make use of /permissive- for improved C++ standard
conformance. Use of a Windows 10 SDK prior to the Fall Creators Update (16299)
or an Xbox One XDK prior to June 2017 QFE 4 may result in failures due to
problems with the system headers. You can work around these by disabling this
switch in the project files which is found in the <ConformanceMode> elements.

* The VS 2017 projects require the 15.5 update or later. For UWP and Win32 classic desktop projects with the 15.5 -
15.7 updates, you need to install the standalone Windows 10 SDK (17763) which is otherwise included in the 15.8.6 or
later update. Older VS 2017 updates will fail to load the projects due to use of the <ConformanceMode> element.
If using the 15.5 or 15.6 updates, you will see "warning D9002: ignoring unknown option '/Zc:__cplusplus'" because
this switch isn't supported until 15.7. It is safe to ignore this warning, or you can edit the project files
<AdditionalOptions> elements.
* The VS 2017 projects require the 15.5 update or later. For UWP and Win32
classic desktop projects with the 15.5 - 15.7 updates, you need to install the
standalone Windows 10 SDK (17763) which is otherwise included in the 15.8.6 or
later update. Older VS 2017 updates will fail to load the projects due to use
of the <ConformanceMode> element. If using the 15.5 or 15.6 updates, you will
see "warning D9002: ignoring unknown option '/Zc:__cplusplus'" because this
switch isn't supported until 15.7. It is safe to ignore this warning, or you
can edit the project files <AdditionalOptions> elements.

* The UWP projects include configurations for the ARM64 platform. These require VS 2017 (15.9 update) to build.
* The UWP projects include configurations for the ARM64 platform. These require
VS 2017 (15.9 update) or VS 2019 to build.


------------------------------------
RELEASE HISTORY

April 26, 2019
Added VS 2019 desktop projects
Code cleanup for texture loaders
Officially dropped Windows Vista support
Minor code cleanup

February 7, 2019
Added ScaleMipMapsAlphaForCoverage function to the library
WIC Writer now has two new flags: WIC_FLAGS_FORCE_SRGB and WIC_FLAGS_FORCE_LINEAR
Expand Down

0 comments on commit f86da52

Please sign in to comment.