From b8873b24d2546053ec4c57c2cd81a48d05b58ce4 Mon Sep 17 00:00:00 2001
From: vdwtanner <vdwtanner@gmail.com>
Date: Thu, 27 May 2021 16:25:08 -0700
Subject: [PATCH] Support pulling D3D12TranslationLayer with FetchContent (#15)

Thanks to FetchContent, it's now easier than ever to contribute to
D3D11On12! Even if you only clone the 11on12 project it will
automatically download the dependencies for you and add them to the
solution.
---
 CMakeLists.txt     |  2 +-
 README.md          | 17 +++++++++++------
 src/CMakeLists.txt | 11 ++++++++++-
 3 files changed, 22 insertions(+), 8 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 701a2bc..6c77d4d 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 # Licensed under the MIT License.
-cmake_minimum_required(VERSION 3.13)
+cmake_minimum_required(VERSION 3.14)
 project(d3d11on12)
 
 set(CMAKE_CXX_STANDARD 17)
diff --git a/README.md b/README.md
index b811647..a74c3c8 100644
--- a/README.md
+++ b/README.md
@@ -19,18 +19,23 @@ The device object internally uses an instance of the D3D12TranslationLayer immed
 
 ## Building
 
-This project is expected to be included in a CMake build environment where the D3D12TranslationLayer project is also included. Additionally, the [WDK](https://docs.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk) (Windows Driver Kit) must be installed, in order to provide `d3d10umddi.h` to D3D11On12, and in order to generate the D3D12TranslationLayer_WDK project, which hosts some code required to parse DXBC shaders and containers.
+In order to build D3D11On12, the [WDK](https://docs.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk) (Windows Driver Kit) must be installed, in order to provide `d3d10umddi.h` to D3D11On12, and in order to generate the D3D12TranslationLayer_WDK project, which hosts some code required to parse DXBC shaders and containers. The D3D12TranslationLayer and its subprojects, D3D12TranslationLayer_WDK and DXBCParser, will be fetched from GitHub when building with CMake if D3D12TranslationLayer_WDK isn't already included, such as by a parent CMakeLists.txt that has already entered that project. Assuming there was a top level `CMakeLists.txt` in a directory that included both D3D11On12 and D3D12TranslationLayer, you could achieve that like this:
 
-At the time of publishing, the D3D11On12 and D3D12TranslationLayer require **insider** versions of the SDK and WDK. Those can be found [here](https://www.microsoft.com/en-us/software-download/windowsinsiderpreviewWDK).
+```CMake
+cmake_minimum_required(VERSION 3.14)
+include(FetchContent)
 
-An example CMakeLists.txt for building D3D11On12 would be:
+FetchContent_Declare(
+    d3d12translationlayer
+    SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/D3D12TranslationLayer
+)
+FetchContent_MakeAvailable(d3d12translationlayer)
 
-```
-cmake_minimum_required(VERSION 3.13)
-add_subdirectory(D3D12TranslationLayer)
 add_subdirectory(D3D11On12)
 ```
 
+At the time of publishing, the D3D11On12 and D3D12TranslationLayer require **insider** versions of the SDK and WDK. Those can be found [here](https://www.microsoft.com/en-us/software-download/windowsinsiderpreviewWDK).
+
 D3D11On12 requires C++17, and only supports building with MSVC at the moment.
 
 ## Why open source?
diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 705e6f8..c4afb97 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -1,6 +1,7 @@
 # Copyright (c) Microsoft Corporation.
 # Licensed under the MIT License.
-cmake_minimum_required(VERSION 3.13)
+cmake_minimum_required(VERSION 3.14)
+include(FetchContent)
 
 file(GLOB SRC CONFIGURE_DEPENDS *.cpp)
 file(GLOB INC ../include/*.h ../include/*.hpp ../interface/*.h *.h *.hpp)
@@ -9,6 +10,14 @@ file(GLOB INL ../include/*.inl *.inl)
 file(GLOB_RECURSE EXTERNAL_INC ../external/*.h ../external/*.hpp)
 
 add_library(d3d11on12 SHARED ${SRC} ${INC} ${INL} ${EXTERNAL_INC} d3d11on12.rc d3d11on12.def)
+
+FetchContent_Declare(
+    d3d12translationlayer
+    GIT_REPOSITORY https://github.com/microsoft/D3D12TranslationLayer.git
+    GIT_TAG        6ba530c050d781d82289d26f04db1119861bb521
+)
+FetchContent_MakeAvailable(d3d12translationlayer)
+
 target_link_libraries(d3d11on12 d3d12translationlayer_wdk)
 target_include_directories(d3d11on12
     PRIVATE ../include