SDL3 Haskell Bindings λ

Work in progress bindings for the SDL3 library written in Haskell.

Please report any bugs or suggestions you have for the bindings!

Setup Instructions

Install SDL3 from source: SDL GitHub

Linux

To build SDL3 from source on Linux:

# Navigate to SDL3 source directory
cd path/to/SDL3/source

# Create and enter build directory
mkdir build
cd build

# Configure with cmake.
# CMAKE_BUILD_TYPE can be whatever you need it to be.
cmake -DCMAKE_BUILD_TYPE=Release -GNinja ..

# Build
cmake --build . --config Release --parallel

# Install (requires sudo)
sudo cmake --install . --config Release

This will install SDL3 to your system so that cabal can find and build the sdl3 package.

Find your way back to this project's directory and run cabal build to build the package with examples, or cabal build sdl3 to build just the package.

Windows

Recommendation: Use the Developer PowerShell or Developer Command Prompt that comes with Visual Studio for best results.

# Navigate to SDL3 source directory
cd path/to/SDL3/source

# Create and enter build directory
mkdir build
cd build

# Configure with cmake.
# CMAKE_BUILD_TYPE can be whatever you need it to be.
cmake -DCMAKE_BUILD_TYPE=Release -GNinja ..

# Build
cmake --build . --config Release --parallel

# Install (requires sudo)
cmake --install . --config Release

Make sure SDL3 compiles a .DLL file, and pkgconfig knows that SDL3 exists. (You might have to install pkgconfig using your pacman of choice.)

You can do this by setting:

set PKG_CONFIG_PATH="path\to\SDL3\lib\pkgconfig"
# or
$env:PKG_CONFIG_PATH="path\to\SDL3\lib\pkgconfig\"

Ensure the .DLL file is present in your PATH environment variable or within the root directory for this project.

You'll also want to add a cabal.project.local file to the root directory with:

package *
  extra-include-dirs: "path/to/SDL3/include/"
  extra-lib-dirs: "path/to/SDL3/lib/"

Once all of this is done, you can find your way into this directory and run cabal build sdl3. If you would like to install the examples, run cabal build instead.

SDL.h Header File Support Checklist

🟧 means that the related header file should be implemented for the most part. Some things might be missing or non-functioning, though I have tried to be careful.

Working Examples

Core Functionality

Initialization & System

• Init - Basic SDL initialization
• System - System information and capabilities
• Platform - Platform-specific functionality
• CPU Info - Processor information
• Power - Power state monitoring
• Hints - SDL configuration hints

Window & Rendering

Rendering

• Render - 2D rendering basics

Misc

• Rect - Rectangle basics (no rendering here)

GPU & Graphics

These examples are based off of the original SDL3 GPU Examples

• GPU Triangle - Raw triangle rendering
• GPU Clear - Basic screen clearing
• GPU Vertex Buffer - Vertex buffer usage (matches gpu-vbuf)
• GPU Textured Quad - Texture mapping
• GPU Custom Sampling - Implementing custom texture sampling logic
• GPU Animated Quad - Animation basics
• GPU Instanced - Instanced rendering
• GPU Stencil - Stencil buffer operations
• GPU Cull - Culling techniques
• GPU Multi-Window - Multiple window rendering
• GPU Draw Indirect - Leveraging indirect draw commands for GPU-driven rendering
• GPU Basic Compute - Basic compute shader usage
• GPU Clear 3D Slice - Clearing a slice of a 3D texture
• GPU Compute Uniforms - Using uniforms with compute shaders
• GPU Compute Sampler - Using samplers within compute shaders
• GPU Compute Tonemapping - Using compute pipelines for HDRI texture tonemapping.
• GPU Copy Consistency - Copy a texture to the GPU, alter it, and draw it to the framebuffer.
• GPU Copy & Readback - Write texture to GPU and read it back, verifying data integrity.
• (... More coming ...)

Input & Interaction

User Input

• Events - Event handling
• Gamepad - Controller input
• Touch Device - Touch input handling (Can't test properly but compiles.)
• Haptic - Force feedback (Can't test properly but compiles.)

User Interface

• Dialog - Dialog boxes
• Message Box - Simple message dialogs
• Clipboard - Clipboard manipulation
• Tray - System tray integration

Audio & Media

Audio

• Audio - Audio playback
• WAV - WAV file handling

Camera

• Camera - Camera device access (Can't test properly but compiles.)

System Integration

File & Data

• Filesystem - File system operations
• Storage - Persistent storage
• GUID - Globally unique identifier handling

Internationalization

• Locale - Localization support

Time & Process Management

Time

• Time - Time functions
• Timer - Timer functionality

Process

• Process - Process management

Sensors

Hardware

• Sensor - Hardware sensor access (Can't test properly but compiles.)