Claro/docs/SDL12.md

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:

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