crisp-game-lib-portable-sdl

SDL1, 2, 3 port of Minimal C-lang library for creating classic arcade-like mini-games running on devices and browsers

Project maintained by joyrider3774 Hosted on GitHub Pages — Theme by mattgraham

SDL Version of crisp-game-lib-portable

DownloadCountTotal DownloadCountLatest LatestVersion License

This is a repo containing sdl ports of the crisp games library which is a Minimal C-lang library for creating classic arcade-like mini-games running on devices and browsers. Re-implemented version of crisp-game-lib for smaller devices. You can play sample games in your browser.

see src/cglpSDL1 for SDL 1 Port

see src/cglpSDL2 for SDL 2 Port

see src/cglpSDL3 for SDL 3 Port

Prebuild versions of the SDL2 and SDL3 port are available in the release Section.

Controls:

Commandline parameters:

Usage: CglpSDL3.exe [-w <WIDTH>] [-h <HEIGHT>] [-f] [-ns] [-a] [-fps] [-nd] [-g <GAMENAME>] [-ms] [-cgl] [-nsd] [CGL file]

Commands:

Windows Prebuild Versions

Windows versions will run fine on any recent os and SDL2 library is baked in, what will not work is running the x64 versions on a 32bit os but 32bit versions are available for download as well

Mac Prebuild Versions and gatekeeper

Macos prebuild binaries are now available as well for different os and architecture versions and contain the sdl2 lib in the binary. Generally speaking binaries build on older versions of macos will run fine on a newer macos if you keep using same architecture but not the other way around. I personally tested the mac os intel builds (not arm ones) on mac os sequoia 15.2 i did not test the arm versions. However due to apple requiring signed and notarized binaries, macos will probably prevent you from running the app bundle directly and display a message like in the screenshot below

If this happens you need to go to system settings in the privacy and security section and scroll all the way down, there will be an entry there where you can unblock it as you can see in screenshot below

once you click allow it will show a new dialog where you choose to open the binary, but you may have to provide the administrator password.

once you have done this a single time it won’t ask about this again.

(Ubuntu) Linux Prebuild Versions

Linux prebuild versions are only available for ubuntu flavor os’es and contain sdl2 in the binary already so you don’t need to deal with apt normally. However since there are only ubuntu runners on github i can not provide binaries for other os’es and the prebuild ones for ubuntu might not work on other os’es. You will just have to build them manually then from source which is not that hard. (More info below). Generally speaking binaries build on older versions of an os will run fine on a newer os but not the other way around. I did not test the Arm versions of the binaries

Target devices

Sample game codes and reference

How to write your own game

  1. Copy game_Template.c to game[your game name].c

  2. Comment out other games in menuGameList.c and add void addGame[your game name](); and addGame[your game name]()

    ...(snip)...
void addGameReflector();
void addGame[your game name]();

void addGames() {
  /*addGameThunder();
  ...(snip)...
  addGameReflector();*/
  addGame[your game name]();
}

  3. Write your own game in game[your game name].c and rename void addGame_Template() { to void addGame[your game name]() {

  4. Build for browser and debug

  5. Once the game is complete, revert other games that were commented out in menuGameList.c and build it for other devices

Build for [target device]

M5StickCPlus, M5Stack, PyBadge

  1. Install LovyanGFX library

  2. Create cglp[target device]/ directory (e.g. cglpM5StickCPlus/)

  3. Copy cglp[target device].ino, ./src/lib/* and ./src/games/* files to the directory

  4. Verify and upload cglp[target device].ino with Arduino IDE

Playdate

  1. Copy ./src/cglpPlaydate directory

  2. Create cglpPlaydate/build directory

  3. Move to cglpPlaydate/build directory and cmake ..

  4. Open crisp-game-lib-portable.sln with Visual Studio

  5. Build the solution (see Building for the Simulator using Visual Studio)

  6. See also Building for the Playdate using NMake

Arduboy

Note: Some features are limited due to device resource limitations.

ESP32-2432S028R

ESPboy

Funkey or RG-Nano

Any Device supporting SDL1, SDL2 or SDL3

  1. (Cross)compile using provided Makefile by running make -f ./src/cglpSDL2/Makefile or make -f ./src/cglpSDL1/Makefile in rootfolder of this repo or use the CMake with the provided src/cglpSDL2/CMakelists or src/cglpSDL3/CMakelists file

  2. Checkout binary --help for information on commandline parameters

Browser

  1. Install Emscripten

  2. Run dev npm script to start the dev server and watch js files

  3. Run dev_c npm script to watch c files and build wasm files

How to operate

Back to the game selection menu

Toggle sound on/off

Key assignment on SDL Ports

Key assignment on browser

How to port the library to other devices

The source codes for library and games are written device-independent. Besides, you need to implement device-dependent code for the following functions:

Sample device-dependent codes are cglpM5StickCPlus.ino and cglpPyBadge.ino.

Porting games from crisp-game-lib using an AI chatbot

You can use an AI chatbot to port game source code for crisp-game-lib to crisp-game-lib-portable. By providing the prompt and set of files to the chatbot, you can obtain the code ported to the C language. I have tried this using Claude 3 Opus, but it is expected to work to some extent with other LLMs as well. The ported code is not perfect, so it needs to be manually checked and corrected.