GameLib API Cheat Sheet v1.9.3 — Single-header C++ Game Library for Win32

Quick Start

#include "GameLib.h"
int main() {
    GameLib game;
    game.Open(640, 480, "Title", true);
    while (!game.IsClosed()) {
        game.Clear(COLOR_BLACK);
        // ...draw here...
        game.Update();
        game.WaitFrame(60);
    }
}

Build: g++ -o game.exe main.cpp -mwindows

Window

• Open(w, h, title, center=false, resizable=false) → 0=OK
• IsClosed() window closed?
• Update() flush frame & poll input
• WaitFrame(fps) frame rate limit
• GetWidth() / GetHeight() framebuffer size
• GetFramebuffer() raw pixel pointer (uint32_t*), index as fb[y*W+x]
• WinResize(w, h) resize client area
• SetMaximized(bool) maximize (resizable only)
• GetDeltaTime() frame delta (s, double)
• GetFPS() / GetTime() FPS & elapsed time
• SetTitle(title) change title (UTF-8)
• ShowFps(bool) FPS in titlebar
• ShowMouse(bool) show/hide cursor
• ShowMessage(text, title, btns) message box

Buttons: MESSAGEBOX_OK / MESSAGEBOX_YESNO
Returns: MESSAGEBOX_RESULT_OK / _YES / _NO

Drawing

• Clear(color=BLACK) fill clip rect (no blend)
• SetPixel(x, y, color) draw pixel (alpha blend)
• GetPixel(x, y) read pixel
• SetClip(x, y, w, h) set clip rect
• ClearClip() reset to full screen
• GetClip(&x,&y,&w,&h) / GetClipX/Y/W/H()
• Screenshot(filename) save BMP

Primitives (all alpha-blend capable)

• DrawLine(x1, y1, x2, y2, color)
• DrawRect(x, y, w, h, color) outline
• FillRect(x, y, w, h, color)
• DrawCircle(cx, cy, r, color)
• FillCircle(cx, cy, r, color)
• DrawEllipse(cx, cy, rx, ry, color)
• FillEllipse(cx, cy, rx, ry, color)
• DrawTriangle(x1,y1, x2,y2, x3,y3, color)
• FillTriangle(x1,y1, x2,y2, x3,y3, color)

Text

Built-in 8x8 Font (ASCII 32~126)

• DrawText(x, y, text, color)
• DrawNumber(x, y, number, color)
• DrawTextScale(x, y, text, color, w, h)
• DrawPrintf(x, y, color, fmt, ...)
• DrawPrintfScale(x, y, color, w, h, fmt, ...)

System Font (GDI, CJK support)

• DrawTextFont(x, y, text, color, fontSize)
• DrawTextFont(x, y, text, color, fontName, fontSize)
• DrawPrintfFont(x,y, color, size, fmt,...)
• DrawPrintfFont(x,y, color, name, size, fmt,...)
• GetTextWidthFont(text, [fontName,] fontSize)
• GetTextHeightFont(text, [fontName,] fontSize)

Sprites

• CreateSprite(w, h) → ID (-1=fail)
• LoadSprite(file) PNG/JPG/BMP/GIF/TIFF
• LoadSpriteBMP(file) BMP 8/24/32-bit
• FreeSprite(id)
• DrawSprite(id, x, y) opaque fast path
• DrawSpriteEx(id, x, y, flags)
• DrawSpriteRegion(id, x, y, sx, sy, sw, sh)
• DrawSpriteRegionEx(id, x,y, sx,sy,sw,sh, flags)
• DrawSpriteScaled(id, x, y, w, h, flags=0)
• DrawSpriteRotated(id, cx, cy, angle, flags=0)
• DrawSpriteFrame(id, x,y, fW,fH, idx, flags=0)
• DrawSpriteFrameScaled(id, x,y,
 fW,fH, idx, w,h, flags=0)
• DrawSpriteFrameRotated(id, cx,cy,
 fW,fH, idx, angle, flags=0)
• Set/GetSpritePixel(id, x, y [,color])
• GetSpriteWidth(id) / GetSpriteHeight(id)
• Set/GetSpriteColorKey(id [,color])

Input

Keyboard

• IsKeyDown(key) held down
• IsKeyPressed(key) just pressed (edge)
• IsKeyReleased(key) just released (edge)

Mouse

• GetMouseX() / GetMouseY() logical pos
• IsMouseDown(btn) / IsMousePressed(btn)
  / IsMouseReleased(btn)
• GetMouseWheelDelta() since last Update
• IsActive() window focused?

MOUSE_LEFT=0   MOUSE_RIGHT=1   MOUSE_MIDDLE=2

Key Constants

KEY_LEFT/RIGHT/UP/DOWN KEY_A ~ KEY_Z KEY_0 ~ KEY_9 KEY_F1 ~ KEY_F12 KEY_SPACE KEY_ENTER KEY_ESCAPE KEY_TAB KEY_SHIFT KEY_CONTROL KEY_BACK

All mapped to Windows Virtual Key Codes.

Sound

• PlayWAV(file, repeat, volume) → channel ID, -1/-2/-4=fail
• PlayPCM(pcm, nch, nsamp, rate, repeat, volume) → channel ID, -1/-2/-4=fail
• StopWAV(channel) → 1=success
• IsPlaying(channel) → 1/0
• SetVolume(channel, volume) 0~1000
• StopAll() stop all WAV
• SetMasterVolume(volume) 0~1000, returns actual
• GetMasterVolume()
• PlayMusic(file, loop) MP3/MIDI/WAV → true
• StopMusic()
• IsMusicPlaying()
• PlayBeep(freq, duration, repeat, volume) async, returns channel ID

WAV and Music are independent, can play simultaneously. Volume range: 0~1000.

Tilemap

• CreateTilemap(cols, rows, tileSize, tilesetId) → ID
• LoadTilemap(file, tilesetId) from .glm
• SaveTilemap(file, mapId) to .glm
• FreeTilemap(mapId)
• SetTile(mapId, col, row, tileId) -1=empty
• GetTile(mapId, col, row)
• GetTilemapCols/Rows(mapId) / GetTileSize(mapId)
• WorldToTileCol(mapId, x) / WorldToTileRow(mapId, y)
• GetTileAtPixel(mapId, x, y)
• FillTileRect(mapId, col, row, cols, rows, tileId)
• ClearTilemap(mapId, tileId=-1)
• DrawTilemap(mapId, x, y, flags=0)

Scroll: DrawTilemap(id, -camX, -camY). Supports COLORKEY/ALPHA flags.

Scene Management

• SetScene(scene) switch next frame
• GetScene() current scene
• IsSceneChanged() 1st frame of new scene?
• GetPreviousScene()

Use enum { MENU, PLAY, OVER }. Initial=0, first frame IsSceneChanged()=true.

UI Controls Immediate Mode

• Button(x, y, w, h, text, color) → true on click
• Checkbox(x, y, text, &checked) toggle
• RadioBox(x, y, text, &value, index) mutual exclusive
• ToggleButton(x, y, w, h, text, &toggled, color)

Save / Load static

• GameLib::SaveInt(file, key, value)
• GameLib::SaveFloat(file, key, value)
• GameLib::SaveString(file, key, value)
• GameLib::LoadInt(file, key, def=0)
• GameLib::LoadFloat(file, key, def=0.0f)
• GameLib::LoadString(file, key, def="")
• GameLib::HasSaveKey(file, key)
• GameLib::DeleteSaveKey(file, key)
• GameLib::DeleteSave(file)

File: GAMELIB_SAVE header + key=value lines. UTF-8 paths.

Utilities static

• GameLib::Random(min, max) int [min,max]
• GameLib::RectOverlap(x1,y1,w1,h1, x2,y2,w2,h2)
• GameLib::CircleOverlap(cx1,cy1,r1, cx2,cy2,r2)
• GameLib::PointInRect(px, py, x, y, w, h)
• GameLib::Distance(x1, y1, x2, y2) → float

Grid Helpers (instance)

• DrawGrid(x, y, rows, cols, size, color)
• FillCell(gx, gy, row, col, size, color)

Colors ARGB 0xAARRGGBB

COLOR_BLACK COLOR_WHITE COLOR_RED COLOR_GREEN COLOR_BLUE COLOR_YELLOW COLOR_CYAN COLOR_MAGENTA COLOR_ORANGE COLOR_PINK COLOR_PURPLE COLOR_GRAY COLOR_DARK_GRAY COLOR_LIGHT_GRAY COLOR_DARK_RED COLOR_DARK_GREEN COLOR_DARK_BLUE COLOR_SKY_BLUE COLOR_BROWN COLOR_GOLD COLOR_TRANSPARENT

Color Macros

• COLOR_RGB(r, g, b) opaque color
• COLOR_ARGB(a, r, g, b) with alpha
• COLOR_GET_A/R/G/B(color) extract channel

When alpha < 255, SetPixel & all primitives auto alpha-blend.