Shader Playground depends on a significant number of compilers, and building these requires a number of different toolchains installed. These toolchains can be manually installed, or you can use a Docker image and container.
The following must be installed:
-
First, ensure that Docker is running with
Windows containers
. -
Fetch the Shader Playground source:
# cd to your preferred location
git clone https://github.com/tgjones/shader-playground.git
cd shader-playground
- Build Docker image, container, and project:
.\build-docker.ps1
Be aware that this will take a long time, the first time, exceptionally so.
The build artifacts will copied into the project sub-directories.
The following must be installed:
- Visual Studio 2017
- And these extra packages:
Microsoft.VisualStudio.Workload.VCTools
Microsoft.VisualStudio.Workload.NativeDesktop
Microsoft.VisualStudio.Component.VC.ATLMFC
Microsoft.Component.MSBuild
- Visual Studio 2019
- And these extra packages:
Microsoft.VisualStudio.Component.VC.ATLMFC
Microsoft.VisualStudio.Workload.NativeDesktop
Microsoft.VisualStudio.Workload.VCTools
Microsoft.VisualStudio.Workload.ManagedDesktopBuildTools
Microsoft.VisualStudio.Workload.NetCoreBuildTools
Microsoft.VisualStudio.Workload.WebBuildTools
Microsoft.VisualStudio.Component.VC.ATLMFC
- Windows SDK 19041
- Windows SDK 17134
- CMake
- 7-Zip
7zip.exe
also be added toPATH
- python2
PYTHON2
enviroment variable must point topython.exe
.python.exe
must not be onPATH
- python3
PYTHON3
must be onPATH
- depot_tools
- This directory must be on
PATH
- This directory must be on
- Fetch the Shader Playground source:
# cd to your preferred location
git clone https://github.com/tgjones/shader-playground.git
cd shader-playground
- Build Docker image, container, and project:
.\build.ps1