sdl2_nim 2.0.14.2

ATTENTION!

Due to a name conflict with the nim-lang/sdl2 wrapper, sdl2_nim will transition from sdl2 to sdl2_nim directory. See issue #35 and Nim issue #18476.

To update your projects you'll just need to replace import sdl2/... statements with import sdl2_nim/....

To use legacy import sdl2/... statements, install legacy branch (nimble install sdl2_nim@#legacy).

sdl2_nim is a wrapper of the SDL 2 library for the Nim language.

• sdl2_nim docs online: https://vladar4.github.io/sdl2_nim/
• SDL homepage: http://www.libsdl.org/
• Nim homepage: http://nim-lang.org/
• Other useful links

You need to have SDL 2 dynamic libraries installed on your system.

Includes:

• SDL 2.0.14
• SDL_gfx 1.0.1 (fully 1.0.4 compatible)
• SDL_gpu 0.12.0
• SDL_image 2.0.5
• SDL_mixer 2.0.4
• SDL_net 2.0.1
• SDL_ttf 2.0.15
• SMPEG 2.0.0

What is not implemented here:

• OpenGL headers (use opengl lib instead)

Versioning scheme:

a.b.c.d

a.b.c - underlying SDL2 version
d     - sdl2_nim revision

FAQ:

Q: Why does this exist if there's an official nim-lang/sdl2 repository?

A: This wrapper actually was created before the official (Aug. 2013 vs. Mar. 2014). Maybe I wouldn't have made it if there already was a wrapper at the time.

Q: How is it different from the official wrapper?

A: Obviously, it can't be much different, as they both are wrappers for the same library, but what comes to mind:

• This one is fully documented, nim-style, with the generated documentation as a bonus;
• I personally created a series of highly commented examples for almost every aspect of the library and its "satelites" (gfx, ttf, etc.);
• Design decisions that I thought made more sense than official one's (like Event type through {.union.} vs. evConv template with casting; naming sceme closer to the original sdl2, etc.);
• Source files' structure is closely following the original library.

Q: Why should I use this one vs. the official?

A: No reason. It's a question of preference.

Q: Where could I find smpeg2.dll?

A: It is distributed within SDL2_mixer 2.0.1 and older builds.

CHANGELOG:

v2.0.14.3

• sdl_gpu update. (kudos to Avahe Kellenberger)

v2.0.14.2

• sdl2nim is renamed to sdl2_nim. See Nim issue #18476.

v2.0.14.1

• transition version from sdl2 to sdl2nim. See issue #35.

v2.0.14.0

• updated to SDL-2.0.14 (see changelog)
• updated documentation

v2.0.12.1

• fixed rect templates
• fixed nimble warnings

v2.0.12.0

• updated to SDL-2.0.12 (see changelog)
• updated documentation

v2.0.10.0

• updated to SDL-2.0.10 (see changelog)
• updated documentation

v2.0.9.2

• updated x11 includes (sdl_syswm)
• updated pragmas to a new style

v2.0.9.1

• updated to SDL_ttf-2.0.15

v2.0.9.0

• updated to SDL-2.0.9 (see changelog)
• updated examples to Nim v0.19.0
• minor bugfixes
• updated documentation

v2.0.8.0

• updated to SDL-2.0.8 (see changelog)
• updated documentation

v2.0.7.1

• added SMPEG 2.0.0
• updated examples, added smpeg example
• added some convenience templates
• bugfixes and documentation updates

v2.0.7.0

• updated to SDL-2.0.7, SDL_image-2.0.2, and SDL_mixer-2.0.2 (see changelog)
• updated documentation

v2.0.6.1

• events iterator and memory allocation procedures (by krux02)
• tupleToColor converters
• various bugfixes and documentation updates

v2.0.6.0

• updated to SDL2-2.0.6 (introduced no breaking changes for 2.0.5, see changelog)
• added SDL_GPU 0.11.0 (kudos to Serenitor)
• minor bugfixes and documentation updates

v2.0.5.0

• changed versioning system to reflect the underlying SDL2 version
• fixed uint8 emum bug
• fixed pixels.nim templates
• fixed windows threads
• various minor improvements
• documentation enhancement

v0.96 beta

• added sdl_syswm.nim
• updated SDL2_ttf to v2.0.14
• added more SDL2 examples
• Nim 0.14.0 adaptation
• updated to SDL2-2.0.5

v0.95 beta

• Nim 0.12.0 adaptation
• updated to SDL2-2.0.4
• added SDL2-gfx
• type-related fixes
• different fixes
• documentation fixes and formatting
• added html documentation
• added SDL2 examples

v0.9 alpha

• added SDL2-mixer
• different fixes

v0.8 alpha

• added haptic.nim
• added SDL2-image
• different fixes

v0.7 alpha

• added SDL2-net
• added event convertion templates
• different fixes