1.1 --- a/docs/README-windows.md Sun Aug 27 19:10:30 2017 -0700
1.2 +++ b/docs/README-windows.md Sun Aug 27 22:15:57 2017 -0400
1.3 @@ -1,41 +1,45 @@
1.4 -Windows
1.5 -================================================================================
1.6 -
1.7 -================================================================================
1.8 -OpenGL ES 2.x support
1.9 -================================================================================
1.10 -
1.11 -SDL has support for OpenGL ES 2.x under Windows via two alternative
1.12 -implementations.
1.13 -The most straightforward method consists in running your app in a system with
1.14 -a graphic card paired with a relatively recent (as of November of 2013) driver
1.15 -which supports the WGL_EXT_create_context_es2_profile extension. Vendors known
1.16 -to ship said extension on Windows currently include nVidia and Intel.
1.17 -
1.18 -The other method involves using the ANGLE library (https://code.google.com/p/angleproject/)
1.19 -If an OpenGL ES 2.x context is requested and no WGL_EXT_create_context_es2_profile
1.20 -extension is found, SDL will try to load the libEGL.dll library provided by
1.21 -ANGLE.
1.22 -To obtain the ANGLE binaries, you can either compile from source from
1.23 -https://chromium.googlesource.com/angle/angle or copy the relevant binaries from
1.24 -a recent Chrome/Chromium install for Windows. The files you need are:
1.25 -
1.26 - * libEGL.dll
1.27 - * libGLESv2.dll
1.28 - * d3dcompiler_46.dll (supports Windows Vista or later, better shader compiler)
1.29 - or...
1.30 - * d3dcompiler_43.dll (supports Windows XP or later)
1.31 -
1.32 -If you compile ANGLE from source, you can configure it so it does not need the
1.33 -d3dcompiler_* DLL at all (for details on this, see their documentation).
1.34 -However, by default SDL will try to preload the d3dcompiler_46.dll to
1.35 -comply with ANGLE's requirements. If you wish SDL to preload d3dcompiler_43.dll (to
1.36 -support Windows XP) or to skip this step at all, you can use the
1.37 -SDL_HINT_VIDEO_WIN_D3DCOMPILER hint (see SDL_hints.h for more details).
1.38 -
1.39 -Known Bugs:
1.40 -
1.41 - * SDL_GL_SetSwapInterval is currently a no op when using ANGLE. It appears
1.42 - that there's a bug in the library which prevents the window contents from
1.43 - refreshing if this is set to anything other than the default value.
1.44 -
1.45 +Windows
1.46 +================================================================================
1.47 +
1.48 +================================================================================
1.49 +OpenGL ES 2.x support
1.50 +================================================================================
1.51 +
1.52 +SDL has support for OpenGL ES 2.x under Windows via two alternative
1.53 +implementations.
1.54 +The most straightforward method consists in running your app in a system with
1.55 +a graphic card paired with a relatively recent (as of November of 2013) driver
1.56 +which supports the WGL_EXT_create_context_es2_profile extension. Vendors known
1.57 +to ship said extension on Windows currently include nVidia and Intel.
1.58 +
1.59 +The other method involves using the ANGLE library (https://code.google.com/p/angleproject/)
1.60 +If an OpenGL ES 2.x context is requested and no WGL_EXT_create_context_es2_profile
1.61 +extension is found, SDL will try to load the libEGL.dll library provided by
1.62 +ANGLE.
1.63 +To obtain the ANGLE binaries, you can either compile from source from
1.64 +https://chromium.googlesource.com/angle/angle or copy the relevant binaries from
1.65 +a recent Chrome/Chromium install for Windows. The files you need are:
1.66 +
1.67 + * libEGL.dll
1.68 + * libGLESv2.dll
1.69 + * d3dcompiler_46.dll (supports Windows Vista or later, better shader compiler)
1.70 + or...
1.71 + * d3dcompiler_43.dll (supports Windows XP or later)
1.72 +
1.73 +If you compile ANGLE from source, you can configure it so it does not need the
1.74 +d3dcompiler_* DLL at all (for details on this, see their documentation).
1.75 +However, by default SDL will try to preload the d3dcompiler_46.dll to
1.76 +comply with ANGLE's requirements. If you wish SDL to preload d3dcompiler_43.dll (to
1.77 +support Windows XP) or to skip this step at all, you can use the
1.78 +SDL_HINT_VIDEO_WIN_D3DCOMPILER hint (see SDL_hints.h for more details).
1.79 +
1.80 +Known Bugs:
1.81 +
1.82 + * SDL_GL_SetSwapInterval is currently a no op when using ANGLE. It appears
1.83 + that there's a bug in the library which prevents the window contents from
1.84 + refreshing if this is set to anything other than the default value.
1.85 +
1.86 +Vulkan Surface Support
1.87 +==============
1.88 +
1.89 +Support for creating Vulkan surfaces is configured on by default. To disable it change the value of `SDL_VIDEO_VULKAN_SURFACE` to 0 in `SDL_config_windows`. When it is on you must install a [Vulkan SDK](https://www.lunarg.com/vulkan-sdk/) in order to build libSDL.