From 0b5e40a5280bc31b82a5628e325364360aea4ead Mon Sep 17 00:00:00 2001
From: RayPals <raypals@noreply.codeberg.org>
Date: Mon, 1 Jun 2026 00:54:12 +0200
Subject: [PATCH] Add docs/SDL12.md from Claro v1.17.26 zip

---
 docs/SDL12.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 docs/SDL12.md

diff --git a/docs/SDL12.md b/docs/SDL12.md
new file mode 100644
index 0000000..57394ee
--- /dev/null
+++ b/docs/SDL12.md
@@ -0,0 +1,41 @@
+# SDL 1.2 Support (Optional)
+
+Claro can be built with optional SDL 1.2 support for simple 2D graphics and input.
+
+## Build (MinGW example)
+
+Install SDL 1.2 development files, then compile with:
+
+```sh
+gcc -DCLARO_WITH_SDL12=1 -I<SDL_INCLUDE_DIR> src/claro.c -L<SDL_LIB_DIR> -lSDL -mwindows -O2 -o claro.exe
+```
+
+On some setups you may need `-lSDLmain` too.
+
+## Commands
+
+All SDL commands are grouped under `SDL ...`:
+
+- `SDL OPEN <w> <h> <title>`
+- `SDL CLEAR <r> <g> <b>`
+- `SDL RECT <x> <y> <w> <h> <r> <g> <b>` (filled rectangle)
+- `SDL PRESENT`
+- `SDL POLL` (updates variables `SDLEVENT` and `SDLKEY`)
+- `SDL DELAY <ms>`
+- `SDL CLOSE`
+
+### Event variables
+
+After `SDL POLL`, Claro variables update:
+
+- `SDLEVENT` = `"NONE" | "QUIT" | "KEYDOWN" | "KEYUP" | "OTHER"`
+- `SDLKEY` = key code number (SDLKey) for KEYDOWN/KEYUP, otherwise `0`
+
+## Sprite / bitmap support
+
+- `SDL LOADBMP <path> AS var` → loads a BMP and stores a numeric handle in `var`
+- `SDL BLIT <handle> AT x y` → draws the loaded bitmap at x,y
+- `SDL KEYDOWN <keycode> AS var` → sets var to 1/0 based on current key state
+
+- `SDL BLITCLIP <handle> SRC sx sy sw sh AT x y` → blit part of a surface (sprite-sheet)
+- `SDL MOUSE AS mx my mb` → writes mouse x/y and button bitmask