docs/README-windows.md
changeset 10486 5bf595c48fd4
parent 9025 d09d4b578e77
child 11365 a9bd2625fa01
     1.1 --- a/docs/README-windows.md	Fri Oct 07 17:30:21 2016 -0700
     1.2 +++ b/docs/README-windows.md	Fri Oct 07 17:46:58 2016 -0700
     1.3 @@ -1,41 +1,41 @@
     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 +