Lazy Foo's SDL2 Tutorials, in Rust

This repo contains ports of the Lazy Foo SDL2 tutorials to the Rust programming language, using the Rust wrappers kindly provided by the following awesome people:

SDL2: AngryLawyer's rust-sdl2

The examples assume 0.27.2 at a minimum.

NB: As of rust-sdl2 0.27.2 these two libraries have been rolled

into rust-sdl2, and are no longer needed.

SDL2_image: xsleonard's rust-sdl2_image
SDL2_ttf: andelf's rust-sdl2_ttf

Tutorial Index

I plan to port most of the provided tutorials, though for some I can't create a port I lack the resourced - for example, I don't have a gamepad or forcefeedback device, and at this point I can't create anything for mobile.

Lesson 01 - Hello SDL
Lesson 02 - Getting an Image on the Screen
Lesson 03 - Event Driven Programming
Lesson 04 - Key Presses
Lesson 05 - Optimized Surface Loading and Soft Stretching
Lesson 06 - Extension Libraries and Loading Other Image Formats
Lesson 07 - Texture Loading and Rendering
Lesson 08 - Geometry Rendering
Lesson 09 - The Viewport
Lesson 10 - Color Keying
Lesson 11 - Clip Rendering and Sprite Sheets
Lesson 12 - Color Modulation
Lesson 13 - Alpha Blending
Lesson 14 - Animated Sprites and Vsync
Lesson 15 - Rotation and Flipping
Lesson 16 - True Type Fonts
Lesson 17 - Mouse Events
Lesson 18 - Key States
(NOT IMPLEMENTED) Lesson 19 - Gamepads and Joysticks
(NOT IMPLEMENTED) Lesson 20 - Force Feedback
(TODO) Lesson 21 - Sound Effects and Music
(TODO) Lesson 22 - Timing
(TODO) Lesson 23 - Advanced Timers
(TODO) Lesson 24 - Calculating Frame Rate
(TODO) Lesson 25 - Capping Frame Rate
(TODO) Lesson 26 - Motion
(TODO) Lesson 27 - Collision Detection
(TODO) Lesson 28 - Per-pixel Collision Detection
(TODO) Lesson 29 - Circular Collision Detection
(TODO) Lesson 30 - Scrolling
(TODO) Lesson 31 - Scrolling Backgrounds
(TODO) Lesson 32 - Text Input and Clipboard Handling
(TODO) Lesson 33 - File Reading and Writing
(NOT IMPLEMENTED) Lesson 34 - Audio Recording
(TODO) Lesson 35 - Window Events
(TODO) Lesson 36 - Multiple Windows
(TODO) Lesson 37 - Multiple Displays
(TODO) Lesson 38 - Particle Engines
(TODO) Lesson 39 - Tiling
(TODO) Lesson 40 - Texture Manipulation
(TODO) Lesson 41 - Bitmap Fonts
(TODO) Lesson 42 - Texture Streaming
(TODO) Lesson 43 - Render to Texture
(TODO) Lesson 44 - Frame Independent Movement
(TODO) Lesson 45 - Timer Callbacks
(TODO) Lesson 46 - Multithreading
(TODO) Lesson 47 - Semaphores
(TODO) Lesson 48 - Atomic Operations
(TODO) Lesson 49 - Mutexes and Conditions
(TODO) Lesson 50 - SDL and OpenGL 2
(TODO) Lesson 51 - SDL and Modern OpenGL
(NOT IMPLEMENTED) Lesson 52 - Hello Mobile
(NOT IMPLEMENTED) Lesson 53 - Extensions and Changing Orientation
(NOT IMPLEMENTED) Lesson 54 - Touches
(NOT IMPLEMENTED) Lesson 55 - Multitouch

Requirements

To run any of these examples, you will need two things:

The nightly build of Rust. Some of these examples use features that still aren't in stable (as of 1.14)
The SDL2 Development libraries. You will also need the image library, SDL_Image 2.0; and the truetype library, SDL_TTF 2.0.

On OS X, you can use Homebrew:

brew install sdl2
brew install sdl2_image
brew install sdl2_ttf

On Fedora:

sudo dnf install SDL2-devel SDL2_ttf-devel SDL2_image-devel

On RedHat/Centos:

sudo yum install SDL2-devel SDL2_ttf-devel SDL2_image-devel

For other platforms, refer to your existing package documentation.

Compiling and Running the Examples

Once you have a version of rust installed, you can build all the examples with the command

cargo build

To run a specific lesson, run

cargo run --bin lesson<NN>