vaiorabbit/sdl2-bindings

sdl2-bindings : Yet another SDL2 wrapper for Ruby

• Created : 2015-09-19
• Last modified : 2024-02-03

Features

• Generated semi-automatically
• Based on Ruby/FFI
  • No need to build C extension library

See the project below to learn how to use this library:

• Whac-a-Mole! : Ruby SDL2 bindings demo
  • https://github.com/vaiorabbit/sdl2-bindings-whacamole
  • 

Limitations

• Several original APIs originally defined with pre-processor macro are unavailable in this library (e.g. SDL_LoadBMP)

Target version

• [2024-02-03]
  • SDL : 2.30.0~
  • SDL_image : 2.8.2
  • SDL_mixer : 2.8.0
  • SDL_ttf : 2.22.0
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.2

Older versions

• [2015-09-19] SDL 2.0.3
• [2016-04-03] SDL 2.0.4
• [2019-08-31] SDL 2.0.10
• [2020-03-22] SDL 2.0.12
• [2020-12-27] SDL 2.0.14
• [2021-08-12] SDL 2.0.16
• [2021-12-02] SDL 2.0.18
• [2022-03-28]
  • SDL : 2.0.20
  • SDL_image : 2.0.5
  • SDL_mixer : 2.0.4
  • SDL_ttf : 2.0.18
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2022-04-29]
  • SDL : 2.0.22
  • SDL_image : 2.0.5
  • SDL_mixer : 2.0.4
  • SDL_ttf : 2.0.18
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2022-07-31]
  • SDL : 2.0.22
  • SDL_image : 2.6.0
  • SDL_mixer : 2.6.0
  • SDL_ttf : 2.20.0
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2022-08-20]
  • SDL : 2.24.0
  • SDL_image : 2.6.2
  • SDL_mixer : 2.6.2
  • SDL_ttf : 2.20.1
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2022-10-09]
  • SDL : 2.24.1
  • SDL_image : 2.6.2
  • SDL_mixer : 2.6.2
  • SDL_ttf : 2.20.1
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2022-11-03]
  • SDL : 2.24.2
  • SDL_image : 2.6.2
  • SDL_mixer : 2.6.2
  • SDL_ttf : 2.20.1
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2022-11-23]
  • SDL : 2.26.0 - 2.26.2
  • SDL_image : 2.6.2
  • SDL_mixer : 2.6.2
  • SDL_ttf : 2.20.1
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2023-04-16]
  • SDL : 2.26.x
  • SDL_image : 2.6.3
  • SDL_mixer : 2.6.3
  • SDL_ttf : 2.20.2
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2023-06-25]
  • SDL : 2.28.x
  • SDL_image : 2.6.3
  • SDL_mixer : 2.6.3
  • SDL_ttf : 2.20.2
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2023-08-10]
  • SDL : 2.28.2~
  • SDL_image : 2.6.3
  • SDL_mixer : 2.6.3
  • SDL_ttf : 2.20.2
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.1
• [2024-01-28]
  • SDL : 2.29.1~
  • SDL_image : 2.8.2
  • SDL_mixer : 2.8.0
  • SDL_ttf : 2.22.0
  • SDL2_gfx : 1.0.4
  • SDL_sound : 2.0.2

Supported Environments

• [2023-12-09] macOS Sonoma (14.2.1) ruby 3.3.0 (2023-12-25 revision 5124f9ac75) [arm64-darwin23]
• [2023-01-07] Windows 11 (22H2), ruby 3.2.0 (2022-12-25 revision a528908271) [x64-mingw-ucrt]
• [2022-10-09] Debian 11 (bullseye) on ASUS Chromebook Detachable CZ1, ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [aarch64-linux]
• [2023-02-05] Ubuntu Linux 22.04 LTS (jammy) on WSL/Windows 11, ruby 3.2.0 (2022-12-25 revision a528908271) [x86_64-linux]

Older Environments

• [2023-12-09] macOS Sonoma (14.0) ruby 3.2.1 (2023-02-08 revision 31819e82c8) [arm64-darwin22]
• [2023-01-07] macOS Ventura (13.2.1) ruby 3.2.1 (2023-02-08 revision 31819e82c8) [arm64-darwin22]
• [2022-04-29] Windows 10 (21H1), ruby 3.1.1p18 (2022-02-18 revision 53f5fc4236) [x64-mingw-ucrt]
• [2022-10-09] macOS Monterey (12.5.1), ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [arm64-darwin21]
• [2022-07-31] macOS Monterey (12.4), ruby 3.1.0p0 (2021-12-25 revision fb4df44d16) [arm64-darwin21]
• [2022-02-12] Windows 10 (21H1), ruby 3.1.0p0 (2021-12-25 revision fb4df44d16) [x64-mingw-ucrt]
• [2022-01-11] macOS Monterey (12.1), ruby 3.1.0p0 (2021-12-25 revision fb4df44d16) [arm64-darwin20]
• [2021-12-02] macOS Big Sur (11.6), ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [arm64-darwin20]
• [2021-08-12] macOS Big Sur (11.5), ruby 3.0.1p64 (2021-04-05 revision 0fb782ee38) [arm64-darwin20]
• [2020-12-27] macOS Big Sur (11.0.1), ruby 3.0.0p0 (2020-12-25 revision 95aff21468) [arm64-darwin20]
• [2016-04-03] Mac OS X 10.11.4, ruby 2.3.0p0 (2015-12-25 revision 53290) [x86_64-darwin15]
• [2015-09-19] Mac OS X 10.10.5, ruby 2.2.3p173 (2015-08-18 revision 51636) [x86_64-darwin14]

License

The zlib/libpng License ( http://opensource.org/licenses/Zlib ).

sdl2-bindings : Yet another SDL2 wrapper for Ruby
Copyright (c) 2015-2024 vaiorabbit <http://twitter.com/vaiorabbit>

This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

sdl2-bindings's Issues

How to use SDL.RenderGeometry()

Hi,

I tried many times to run the SDL.RenderGeometry() function but I can’t.

In the third argument (vertices), I cannot convert my array containing my SDL::Vertex to FFI::Pointer or FFI::MemoryPointer.

I’m sorry for the inconvenience, plus I think the problem comes from me x)

opengl-bindings

Hello.
The sdl opengl examples still uses opengl-bindings1, your bindings2 apparently don't include the OpenGL constant include anymore? Attached a patch making test work with opengl-bindings2 - renamed to .txt because github silly..
opengl-bindings2.txt