This project is part of the 🎮 SDL One-Night-Stand collection (unhappy name, I know, but that's my sense of humor).
Making a long story short, that afternoon I was playing a game with those circular keypads to insert codes. Unfortunately, a huge monster had the great idea of letting me kill him right on one of those keypads so that I couldn't see most of the keypad itself, making it really hard for me to insert the correct code as I didn't know where the digits were.
Well after spending 10 minutes trying to insert that code, I took my tablet and rendered the digits on a wheel to understand how to tilt the gamepad's stick to insert the code in the game (this saved the day, btw).
A few hours later, watching TV (boring thing itself), I decided to work on that dumb static circle and I made this dumb game where you basically need to guess 3 codes in a given time, with only a color hint. If you make it in time, you win, otherwise some extinction-scale bomb will blow up and everything is lost and that kinda stuff..
The game is really simple, doesn't use any image or sound, just 2D primitives and a font. It took really little to implement it but it was fun since, unlike the other games of the collection, this one wasn't just a copy of something... yes, that's what happens when I have creative freedom, a rolling disc of numbers...
Irrelevant information, skip this paragraph. I mean it.
As all the project in this collection, this has been developed on my Android tablet, with a rickety IDE, as an evening filler while watching TV from my bed. That's to say none of these projects ever claimed to be serious.
After finishing a couple of these projects, I started wondering what would mean porting them to a web version. War Plan:
- Move the sources to my PC
- Make a decent refactoring (finally I had a keyboard, I couldn't stand that ugly code any further)
- Widely comment, so the dumb future me will understand what the past me did
- Added Emscripten support
That's how this collection started, so look at this as something born to be trivial enough not to distract me too much from the TV.
You can clone the repository using you favourite git client or via cli:
git clone https://github.com/guareschiluca/sdl-keypad.git
cd sdl-keypadThis repository includes a Visual Studio solution file fully configured and ready to run, if you want to compile it for PC.
To build for PC just open the solution in Visual Studio and build! Debug and Release configuration differ by initialization and console output. Release configuration will build a windows application while Debug configuration will show up the console.
In general, the Debug configuration has a few tricks to ease debugging, while Release configuration is made to look good.
If you want to build the web version you will need a fully configured Emscripten environment (download), CMake (download) and Ninja (download).
With a fully configured environment, and all ports built, all you need to build for web is to run the build batch file.
REM Run a web assembly build
build-wasm.bat
REM Run a clean web assembly build (clears cache before building)
build-wasm.bat -c
REM or
build-wasm.bat --clean
REM Run a web assembly build and open output directory (can be combined with -c or --clean)
build-wasm.bat -o
REM or
build-wasm.bat --openOnce the build succeeded, a directory called public-html should contain the built files plus:
- a testing html page
- a testing server batch file (requires python).
If you run the testing server, you can test the build at http://localhost:8000/ (unless you edit the configuration).
The game is implemented based on:
- Two Paddles (with separate customizable control)
- Ball with discrete collision detection
- Bodies overlap resolution (drafted)
- Scoreboard
- Nice splash screen art
- Basic sound made of a looping soundtrack and 3 simple sound effects
The repository also contains:
- Web Assembly Building Script
- Sample Web Page to Test
- Python-based Testing Server
This project is for educational purposes and does not accept collaborators. However, feel free to fork the repository and make your own modifications.
Read the license file for more information: LICENSE.md
This repository is based on the following libraries:
- SDL2 - Simple DirectMedia Layer
- SDL2_ttf - SDL Fonts Support