Skip to content

littledivy/deno_sdl2

Repository files navigation

Deno SDL2

deno_sdl2 provides bindings to sdl2, sdl2_ttf and sdl2_image.

Screen.Recording.2022-03-28.at.5.37.35.PM.mov

Minimum supported Deno version: 2.3.0

get started

import { EventType, WindowBuilder } from "jsr:@divy/sdl2@0.15"; const window = new WindowBuilder("Hello, Deno!", 640, 480).build(); const canvas = window.canvas(); for await (const event of window.events()) { if (event.type == EventType.Quit) { break; } else if (event.type == EventType.Draw) { // Rainbow effect const r = Math.sin(Date.now() / 1000) * 127 + 128; const g = Math.sin(Date.now() / 1000 + 2) * 127 + 128; const b = Math.sin(Date.now() / 1000 + 4) * 127 + 128; canvas.setDrawColor(Math.floor(r), Math.floor(g), Math.floor(b), 255); canvas.clear(); canvas.present(); } }
deno run --allow-env --allow-ffi https://jsr.io/@divy/sdl2/0.15.0/examples/hello.ts

installing sdl2

Follow https://wiki.libsdl.org/SDL2/Installation to install the dynamic library.

TL;DR

MacOS (arm64/x64):

brew install sdl2 sdl2_image sdl2_ttf

Make sure the libraries is in your system's library search paths, if not already:

sudo ln -s /opt/homebrew/lib/libSDL2.dylib /usr/local/lib/ sudo ln -s /opt/homebrew/lib/libSDL2_image.dylib /usr/local/lib/ sudo ln -s /opt/homebrew/lib/libSDL2_ttf.dylib /usr/local/lib/

Additionally, you can set DENO_SDL2_PATH to point to the directory where these three libraries are located.

Windows (x64):

Grab prebuilt libraries from:

Take SDL2.dll, SDL2_image.dll and SDL2_ttf.dll from each respectively and put them into cwd or C:\Windows\System32\.

Linux (x64):

sudo apt install libsdl2-dev libsdl2-image-dev libsdl2-ttf-dev

security

you need --allow-ffi to use SDL2. deno_sdl2 needs access to system's SDL2 library. Deno's permission model does not work well with FFI libraries, use at your own risk.

projects using deno_sdl2

license

MIT