README-windows.txt
changeset 8021 f96e12e0ade9
child 8219 49dbdbd657a9
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/README-windows.txt	Fri Nov 22 13:24:53 2013 -0300
     1.3 @@ -0,0 +1,42 @@
     1.4 +================================================================================
     1.5 +Simple DirectMedia Layer for Windows
     1.6 +================================================================================
     1.7 +
     1.8 +================================================================================
     1.9 +OpenGL ES 2.x support
    1.10 +================================================================================
    1.11 +
    1.12 +SDL has support for OpenGL ES 2.x under Windows via two alternative 
    1.13 +implementations. 
    1.14 +The most straightforward method consists in running your app in a system with 
    1.15 +a graphic card paired with a relatively recent (as of November of 2013) driver 
    1.16 +which supports the WGL_EXT_create_context_es2_profile extension. Vendors known 
    1.17 +to ship said extension on Windows currently include nVidia and Intel.
    1.18 +
    1.19 +The other method involves using the ANGLE library (https://code.google.com/p/angleproject/)
    1.20 +If an OpenGL ES 2.x context is requested and no WGL_EXT_create_context_es2_profile
    1.21 +extension is found, SDL will try to load the libEGL.dll library provided by
    1.22 +ANGLE.
    1.23 +To obtain the ANGLE binaries, you can either compile from source from
    1.24 +https://chromium.googlesource.com/angle/angle or copy the relevant binaries from
    1.25 +a recent Chrome/Chromium install for Windows. The files you need are:
    1.26 +    
    1.27 +    * libEGL.dll
    1.28 +    * libGLESv2.dll
    1.29 +    * d3dcompiler_46.dll (supports Windows Vista or later, better shader compiler)
    1.30 +    or...
    1.31 +    * d3dcompiler_43.dll (supports Windows XP or later)
    1.32 +    
    1.33 +If you compile ANGLE from source, you can configure it so it does not need the
    1.34 +d3dcompiler_* DLL at all (for details on this, see their documentation). 
    1.35 +However, by default SDL will try to preload the d3dcompiler_46.dll to
    1.36 +comply with ANGLE's requirements. If you wish SDL to preload d3dcompiler_43.dll (to
    1.37 +support Windows XP) or to skip this step at all, you can use the 
    1.38 +SDL_VIDEO_WIN_D3DCOMPILER hint (see SDL_hints.h for more details).
    1.39 +
    1.40 +Known Bugs:
    1.41 +    
    1.42 +    * SDL_GL_SetSwapInterval is currently a no op when using ANGLE. It appears
    1.43 +      that there's a bug in the library which prevents the window contents from
    1.44 +      refreshing if this is set to anything other than the default value.
    1.45 +