🛠️🐜 Antkeeper superbuild with dependencies included https://antkeeper.com
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

58 lines
2.5 KiB

  1. # Windows
  2. ## LLVM and Intel C++ compiler support
  3. SDL will build with the Visual Studio project files with LLVM-based compilers, such as the Intel oneAPI C++
  4. compiler, but you'll have to manually add the "-msse3" command line option
  5. to at least the SDL_audiocvt.c source file, and possibly others. This may
  6. not be necessary if you build SDL with CMake instead of the included Visual
  7. Studio solution.
  8. Details are here: https://github.com/libsdl-org/SDL/issues/5186
  9. ## OpenGL ES 2.x support
  10. SDL has support for OpenGL ES 2.x under Windows via two alternative
  11. implementations.
  12. The most straightforward method consists in running your app in a system with
  13. a graphic card paired with a relatively recent (as of November of 2013) driver
  14. which supports the WGL_EXT_create_context_es2_profile extension. Vendors known
  15. to ship said extension on Windows currently include nVidia and Intel.
  16. The other method involves using the
  17. [ANGLE library](https://code.google.com/p/angleproject/). If an OpenGL ES 2.x
  18. context is requested and no WGL_EXT_create_context_es2_profile extension is
  19. found, SDL will try to load the libEGL.dll library provided by ANGLE.
  20. To obtain the ANGLE binaries, you can either compile from source from
  21. https://chromium.googlesource.com/angle/angle or copy the relevant binaries
  22. from a recent Chrome/Chromium install for Windows. The files you need are:
  23. - libEGL.dll
  24. - libGLESv2.dll
  25. - d3dcompiler_46.dll (supports Windows Vista or later, better shader
  26. compiler) *or* d3dcompiler_43.dll (supports Windows XP or later)
  27. If you compile ANGLE from source, you can configure it so it does not need the
  28. d3dcompiler_* DLL at all (for details on this, see their documentation).
  29. However, by default SDL will try to preload the d3dcompiler_46.dll to
  30. comply with ANGLE's requirements. If you wish SDL to preload
  31. d3dcompiler_43.dll (to support Windows XP) or to skip this step at all, you
  32. can use the SDL_HINT_VIDEO_WIN_D3DCOMPILER hint (see SDL_hints.h for more
  33. details).
  34. Known Bugs:
  35. - SDL_GL_SetSwapInterval is currently a no op when using ANGLE. It appears
  36. that there's a bug in the library which prevents the window contents from
  37. refreshing if this is set to anything other than the default value.
  38. ## Vulkan Surface Support
  39. Support for creating Vulkan surfaces is configured on by default. To disable
  40. it change the value of `SDL_VIDEO_VULKAN` to 0 in `SDL_config_windows.h`. You
  41. must install the [Vulkan SDK](https://www.lunarg.com/vulkan-sdk/) in order to
  42. use Vulkan graphics in your application.