From ecc6560c14fbba13149c72ddcafacb14cb84e599 Mon Sep 17 00:00:00 2001
From: Chuck Walbourn <chuckw@windows.microsoft.com>
Date: Tue, 18 Jan 2022 00:19:52 -0800
Subject: [PATCH] January 2022

---
 .nuget/directxmath.nuspec |  4 ++--
 CMakeLists.txt            |  2 +-
 HISTORY.md                | 10 ++++++++++
 Inc/DirectXMath.h         |  2 +-
 README.md                 |  6 +++---
 5 files changed, 17 insertions(+), 7 deletions(-)

diff --git a/.nuget/directxmath.nuspec b/.nuget/directxmath.nuspec
index 1478d16..88ea49a 100644
--- a/.nuget/directxmath.nuspec
+++ b/.nuget/directxmath.nuspec
@@ -8,14 +8,14 @@
         <owners>microsoft,directxtk</owners>
         <summary>DirectXMath is an all inline SIMD C++ linear algebra library for use in games and graphics apps.</summary>
         <description>The DirectXMath API provides SIMD-friendly C++ types and functions for common linear algebra and graphics math operations common to DirectX applications. The library provides optimized versions for Windows 32-bit (x86), Windows 64-bit (x64), and Windows on ARM through SSE2 and ARM-NEON intrinsics support in the Visual Studio compiler.</description>
-        <releaseNotes>Matches the December 2020 release.</releaseNotes>
+        <releaseNotes>Matches the January 2022 release.</releaseNotes>
         <projectUrl>http://go.microsoft.com/fwlink/?LinkID=615560</projectUrl>
         <repository type="git" url="https://github.com/microsoft/DirectXMath" />
         <icon>images\icon.jpg</icon>
         <readme>docs\README.md</readme>
         <license type="expression">MIT</license>
         <requireLicenseAcceptance>false</requireLicenseAcceptance>
-        <copyright>© Microsoft Corporation.</copyright>
+        <copyright>&#169; Microsoft Corporation. All rights reserved.</copyright>
         <tags>C++  native  DirectX  math nativepackage</tags>
     </metadata>
 
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 4ab2428..c8e9d25 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -3,7 +3,7 @@
 
 cmake_minimum_required (VERSION 3.11)
 
-set(DIRECTXMATH_VERSION 3.1.6)
+set(DIRECTXMATH_VERSION 3.1.7)
 
 project(DirectXMath
   VERSION ${DIRECTXMATH_VERSION}
diff --git a/HISTORY.md b/HISTORY.md
index ec8ea7a..f03d3b4 100644
--- a/HISTORY.md
+++ b/HISTORY.md
@@ -6,6 +6,16 @@ Release available for download on [GitHub](https://github.com/microsoft/DirectXM
 
 ## Release History
 
+### January 2022 (3.17)
+* Added ColorsLinear namespace to DirectXColors.h with linear versions of .NET colors
+* Optimized the ``XMMatrixRotationRollPitchYaw(FromVector)`` functions
+* Fixed overread problem for 16bpp GPU types Load functions:
+  * ``XMUNIBBLE4``, ``XMU555``, ``XMU565``, ``XMBYTEN2``, ``XMBYTE2``, ``XMUBYTEN2``, ``XMUBYTE2``
+* ``XM_CACHE_LINE_SIZE`` updated for ARM/ARM64 targets to 128 bytes
+* A few comments added to improve IntelliSense experience
+* Conformance improvements for GNU compiler
+* Minor code cleanup
+
 ### January 2021 (3.16b)
 * Hot-fixes to resolve build breaks for clang/LLVM and GCC on ARM64
 * ``XM_ALIGNED_DATA`` and ``XM_ALIGNED_STRUCT`` macros updated to use C++17 ``alignas`` when available
diff --git a/Inc/DirectXMath.h b/Inc/DirectXMath.h
index 0e79d93..10be70e 100644
--- a/Inc/DirectXMath.h
+++ b/Inc/DirectXMath.h
@@ -13,7 +13,7 @@
 #error DirectX Math requires C++
 #endif
 
-#define DIRECTX_MATH_VERSION 316
+#define DIRECTX_MATH_VERSION 317
 
 #if defined(_MSC_VER) && (_MSC_VER < 1910)
 #error DirectX Math requires Visual C++ 2017 or later.
diff --git a/README.md b/README.md
index 5acbb59..a02e376 100644
--- a/README.md
+++ b/README.md
@@ -6,11 +6,11 @@ https://github.com/Microsoft/DirectXMath
 
 Copyright (c) Microsoft Corporation.
 
-**January 2021**
+**January 2022**
 
 This package contains the DirectXMath library, an all inline SIMD C++ linear algebra library for use in games and graphics apps.
 
-This code is designed to build with Visual Studio 2017, Visual Studio 2019, or clang/LLVM for Windows. It is recommended that you make use of the latest updates (VS 2017 15.9, or VS 2019 16.4 or later).
+This code is designed to build with Visual Studio 2017, Visual Studio 2019, Visual Studio 2022, or clang/LLVM for Windows. It is recommended that you make use of the latest updates (VS 2017 15.9; VS 2019 16.7 or later).
 
 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).
 
@@ -22,7 +22,7 @@ These components are designed to work without requiring any content from the leg
 
     * DirectXMath.h - Core library
     * DirectXPackedVector.h - Load/Store functions and types for working with various compressed GPU formats
-    * DirectXColors.h - .NET-style Color defines in sRGB color space
+    * DirectXColors.h - .NET-style Color defines in sRGB and linear color space
     * DirectXCollision.h - Bounding volume collision library
 
 * ``Extentions\``