Add meson flag for compiling with SDL3

Author: ankith26

buildconfig/download_win_prebuilt.py

@@ -82,6 +82,10 @@ def get_urls(x86=True, x64=True):
         '9121a66a4bc45d657d0c15300cee6c7f37ade51d',
         ],
         [
+        'https://github.com/libsdl-org/SDL/releases/download/preview-3.1.3/SDL3-devel-3.1.3-VC.zip',
+        '8e4d7104193ba976406fe9968301de6f6b57f342'
+        ],
+        [
         'https://github.com/pygame-community/SDL_image/releases/download/2.8.2-pgce/SDL2_image-devel-2.8.2-VCpgce.zip',
         '983484dd816abf25cdd5bce88ac69dbca1ea713a'
         ],
@@ -242,6 +246,17 @@ def copy(src, dst):
                 'SDL2-2.30.7'
             )
         )
+        copy(
+            os.path.join(
+                temp_dir,
+                'SDL3-devel-3.1.3-VC/SDL3-3.1.3'
+            ),
+            os.path.join(
+                move_to_dir,
+                prebuilt_dir,
+                'SDL3-3.1.3'
+            )
+        )
 
 def update(x86=True, x64=True):
     move_to_dir = "."

meson.build

@@ -78,6 +78,12 @@ endif
 
 pg_dir = py.get_install_dir() / pg
 
+sdl_api = get_option('sdl_api')
+sdl = 'SDL@0@'.format(sdl_api)
+sdl_mixer = '@0@_mixer'.format(sdl)
+sdl_ttf = '@0@_ttf'.format(sdl)
+sdl_image = '@0@_image'.format(sdl)
+
 pg_inc_dirs = []
 pg_lib_dirs = []
 if plat == 'win' and host_machine.cpu_family().startswith('x86')
@@ -99,60 +105,68 @@ if plat == 'win' and host_machine.cpu_family().startswith('x86')
         )
     endif
 
-    sdl_ver = '2.30.7'
+    sdl_ver = (sdl_api == 3) ? '3.1.3' : '2.30.7'
     sdl_image_ver = '2.8.2'
     sdl_mixer_ver = '2.8.0'
     sdl_ttf_ver = '2.22.0'
 
     dlls = []
 
-    # SDL2
-    sdl_dir = prebuilt_dir / 'SDL2-@0@'.format(sdl_ver)
+    # SDL
+    sdl_dir = prebuilt_dir / '@0@-@1@'.format(sdl, sdl_ver)
     sdl_lib_dir = sdl_dir / 'lib' / arch_suffix
     pg_inc_dirs += fs.relative_to(sdl_dir / 'include', base_dir)
     pg_lib_dirs += sdl_lib_dir
-    dlls += sdl_lib_dir / 'SDL2.dll'
-
-    # SDL2_image
-    sdl_image_dir = prebuilt_dir / 'SDL2_image-@0@'.format(sdl_image_ver)
-    sdl_image_lib_dir = sdl_image_dir / 'lib' / arch_suffix
-    pg_inc_dirs += fs.relative_to(sdl_image_dir / 'include', base_dir)
-    pg_lib_dirs += sdl_image_lib_dir
-    dlls += [
-        sdl_image_lib_dir / 'SDL2_image.dll',
-        sdl_image_lib_dir / 'optional' / 'libjpeg-62.dll',
-        sdl_image_lib_dir / 'optional' / 'libpng16-16.dll',
-        sdl_image_lib_dir / 'optional' / 'libtiff-5.dll',
-        sdl_image_lib_dir / 'optional' / 'libwebp-7.dll',
-        sdl_image_lib_dir / 'optional' / 'libwebpdemux-2.dll',
-    ]
-
-    # SDL2_mixer
-    sdl_mixer_dir = prebuilt_dir / 'SDL2_mixer-@0@'.format(sdl_mixer_ver)
-    sdl_mixer_lib_dir = sdl_mixer_dir / 'lib' / arch_suffix
-    pg_inc_dirs += fs.relative_to(sdl_mixer_dir / 'include', base_dir)
-    pg_lib_dirs += sdl_mixer_lib_dir
-    dlls += [
-        sdl_mixer_lib_dir / 'SDL2_mixer.dll',
-        sdl_mixer_lib_dir / 'optional' / 'libogg-0.dll',
-        sdl_mixer_lib_dir / 'optional' / 'libopus-0.dll',
-        sdl_mixer_lib_dir / 'optional' / 'libopusfile-0.dll',
-        sdl_mixer_lib_dir / 'optional' / 'libwavpack-1.dll',
-        sdl_mixer_lib_dir / 'optional' / 'libxmp.dll',
-    ]
-
-    # SDL2_ttf
-    sdl_ttf_dir = prebuilt_dir / 'SDL2_ttf-@0@'.format(sdl_ttf_ver)
-    sdl_ttf_lib_dir = sdl_ttf_dir / 'lib' / arch_suffix
-    pg_inc_dirs += fs.relative_to(sdl_ttf_dir / 'include', base_dir)
-    pg_lib_dirs += sdl_ttf_lib_dir
-    dlls += sdl_ttf_lib_dir / 'SDL2_ttf.dll'
+    dlls += sdl_lib_dir / '@0@.dll'.format(sdl)
+
+    # SDL_image
+    if get_option('image').enabled()
+        sdl_image_dir = prebuilt_dir / '@0@-@1@'.format(sdl_image, sdl_image_ver)
+        sdl_image_lib_dir = sdl_image_dir / 'lib' / arch_suffix
+        pg_inc_dirs += fs.relative_to(sdl_image_dir / 'include', base_dir)
+        pg_lib_dirs += sdl_image_lib_dir
+        dlls += [
+            sdl_image_lib_dir / '@0@.dll'.format(sdl_image),
+            sdl_image_lib_dir / 'optional' / 'libjpeg-62.dll',
+            sdl_image_lib_dir / 'optional' / 'libpng16-16.dll',
+            sdl_image_lib_dir / 'optional' / 'libtiff-5.dll',
+            sdl_image_lib_dir / 'optional' / 'libwebp-7.dll',
+            sdl_image_lib_dir / 'optional' / 'libwebpdemux-2.dll',
+        ]
+    endif
+
+    # SDL_mixer
+    if get_option('mixer').enabled()
+        sdl_mixer_dir = prebuilt_dir / '@0@-@1@'.format(sdl_mixer, sdl_mixer_ver)
+        sdl_mixer_lib_dir = sdl_mixer_dir / 'lib' / arch_suffix
+        pg_inc_dirs += fs.relative_to(sdl_mixer_dir / 'include', base_dir)
+        pg_lib_dirs += sdl_mixer_lib_dir
+        dlls += [
+            sdl_mixer_lib_dir / '@0@.dll'.format(sdl_mixer),
+            sdl_mixer_lib_dir / 'optional' / 'libogg-0.dll',
+            sdl_mixer_lib_dir / 'optional' / 'libopus-0.dll',
+            sdl_mixer_lib_dir / 'optional' / 'libopusfile-0.dll',
+            sdl_mixer_lib_dir / 'optional' / 'libwavpack-1.dll',
+            sdl_mixer_lib_dir / 'optional' / 'libxmp.dll',
+        ]
+    endif
+
+    # SDL_ttf
+    if get_option('font').enabled()
+        sdl_ttf_dir = prebuilt_dir / '@0@-@1@'.format(sdl_ttf, sdl_ttf_ver)
+        sdl_ttf_lib_dir = sdl_ttf_dir / 'lib' / arch_suffix
+        pg_inc_dirs += fs.relative_to(sdl_ttf_dir / 'include', base_dir)
+        pg_lib_dirs += sdl_ttf_lib_dir
+        dlls += sdl_ttf_lib_dir / '@0@.dll'.format(sdl_ttf)
+    endif
 
     # freetype, portmidi and porttime
-    common_lib_dir = prebuilt_dir / 'lib'
-    pg_inc_dirs += fs.relative_to(prebuilt_dir / 'include', base_dir)
-    pg_lib_dirs += common_lib_dir
-    dlls += [common_lib_dir / 'freetype.dll', common_lib_dir / 'portmidi.dll']
+    if get_option('freetype').enabled() and get_option('midi').enabled()
+        common_lib_dir = prebuilt_dir / 'lib'
+        pg_inc_dirs += fs.relative_to(prebuilt_dir / 'include', base_dir)
+        pg_lib_dirs += common_lib_dir
+        dlls += [common_lib_dir / 'freetype.dll', common_lib_dir / 'portmidi.dll']
+    endif
 
     # clean unneeded file that causes build issues
     unneeded_file = common_lib_dir / 'libportmidi.dll.a'
@@ -183,7 +197,7 @@ else
     foreach inc_dir : bases
         foreach sub_inc : [
             '',
-            '/SDL2',
+            '/@0@'.format(sdl),
             '/freetype2',
         ]
             full_inc = inc_dir / 'include' + sub_inc
@@ -204,45 +218,45 @@ else
 endif
 
 # TODO: add version constraints?
-sdl_dep = dependency('sdl2', required: false)
+sdl_dep = dependency(sdl, required: false)
 if not sdl_dep.found()
     sdl_dep = declare_dependency(
         include_directories: pg_inc_dirs,
-        dependencies: cc.find_library('SDL2', dirs: pg_lib_dirs),
+        dependencies: cc.find_library(sdl, dirs: pg_lib_dirs),
     )
 endif
 
 # optional
-sdl_image_dep = dependency('SDL2_image', required: false)
+sdl_image_dep = dependency(sdl_image, required: false)
 if not sdl_image_dep.found()
     sdl_image_dep = declare_dependency(
         include_directories: pg_inc_dirs,
         dependencies: cc.find_library(
-            'SDL2_image',
+            sdl_image,
             dirs: pg_lib_dirs,
             required: get_option('image'),
         ),
     )
 endif
 
-sdl_mixer_dep = dependency('SDL2_mixer', required: false)
+sdl_mixer_dep = dependency(sdl_mixer, required: false)
 if not sdl_mixer_dep.found()
     sdl_mixer_dep = declare_dependency(
         include_directories: pg_inc_dirs,
         dependencies: cc.find_library(
-            'SDL2_mixer',
+            sdl_mixer,
             dirs: pg_lib_dirs,
             required: get_option('mixer'),
         ),
     )
 endif
 
-sdl_ttf_dep = dependency('SDL2_ttf', required: false)
+sdl_ttf_dep = dependency(sdl_ttf, required: false)
 if not sdl_ttf_dep.found()
     sdl_ttf_dep = declare_dependency(
         include_directories: pg_inc_dirs,
         dependencies: cc.find_library(
-            'SDL2_ttf',
+            sdl_ttf,
             dirs: pg_lib_dirs,
             required: get_option('font'),
         ),
@@ -296,10 +310,10 @@ pg_base_deps = [sdl_dep, py_dep]
 
 summary(
     {
-        'SDL2': sdl_dep.found(),
-        'SDL2_image': sdl_image_dep.found(),
-        'SDL2_mixer': sdl_mixer_dep.found(),
-        'SDL2_ttf': sdl_ttf_dep.found(),
+        sdl: sdl_dep.found(),
+        sdl_image: sdl_image_dep.found(),
+        sdl_mixer: sdl_mixer_dep.found(),
+        sdl_ttf: sdl_ttf_dep.found(),
         'freetype2': freetype_dep.found(),
         'portmidi': portmidi_dep.found(),
         'porttime': portmidi_dep.found() ? porttime_dep.found() : false,

meson_options.txt

@@ -37,3 +37,6 @@ option('error_docs_missing', type: 'boolean', value: 'false')
 # Controls whether to do a coverage build.
 # This argument must be used together with the editable install.
 option('coverage', type: 'boolean', value: false)
+
+# Controls whether to use SDL3 instead of SDL2. The default is to use SDL2
+option('sdl_api', type: 'integer', min: 2, max: 3, value: 2)