Raylib Module

GX includes a raylib module for game and graphics development. Raylib is a simple C library for games — no callbacks, no complex setup, just a polling game loop. The GX module wraps raylib’s C API directly via extern fn and extern struct, keeping the familiar PascalCase naming.

Prerequisites

Raylib must be installed separately. You need:

1. raylib.h — place in modules/raylib/c/
2. raylib.lib (MSVC) or libraylib.a (GCC) — place in modules/raylib/lib/
3. Clang or GCC — required for linking

Usage

Import the sub-modules you need:

import raylib.core      // window, timing, drawing, shaders, camera, structs
import raylib.input     // keyboard/mouse enums and functions
import raylib.shapes    // 2D shape drawing, splines, collision
import raylib.text      // text drawing, fonts, codepoints
import raylib.textures  // texture/image loading, drawing, color utilities
import raylib.colors    // color constants (rl_red, rl_blue, etc.)
import raylib.models    // 3D shapes, model loading, mesh, materials
import raylib.audio     // sound, music streaming, audio streams

Build with -I modules:

gx myapp.gx -I modules -o myapp.exe

Hello World

import raylib.core
import raylib.input
import raylib.shapes
import raylib.text
import raylib.colors

fn main() {
    InitWindow(800, 450, "GX + Raylib")
    SetTargetFPS(60)

    while (!WindowShouldClose()) {
        BeginDrawing()
        ClearBackground(rl_raywhite())

        DrawText("Hello from GX!", 190, 200, 20, rl_darkgray())
        DrawRectangle(100, 100, 200, 80, rl_red())
        DrawCircle(400, 300, 50.0, rl_blue())
        DrawFPS(10, 10)

        if (IsKeyPressed(KEY_ESCAPE)) {
            CloseWindow()
            return
        }

        EndDrawing()
    }
    CloseWindow()
}

Core (raylib.core)

Structs

All raylib types are declared as extern struct and used directly:

Construct structs by declaring a variable and setting fields:

var pos:Vector2
pos.x = 100.0
pos.y = 200.0

Window Functions

Drawing Lifecycle

Shader Functions

Screen-Space

Timing

Mouse (Core)

Touch & Gestures

Camera

Gamepad

Random

Misc

Input (raylib.input)

Keyboard

if (IsKeyPressed(KEY_SPACE)) { jump() }
if (IsKeyDown(KEY_A)) { move_left() }

All keyboard keys are available as enum constants: KEY_A through KEY_Z, KEY_ZERO through KEY_NINE, KEY_SPACE, KEY_ESCAPE, KEY_ENTER, KEY_TAB, KEY_F1 through KEY_F12, arrow keys (KEY_UP, KEY_DOWN, KEY_LEFT, KEY_RIGHT), modifiers (KEY_LEFT_SHIFT, KEY_LEFT_CONTROL, KEY_LEFT_ALT), and more.

Mouse Buttons

if (IsMouseButtonPressed(MOUSE_BUTTON_LEFT)) { shoot() }

Constants: MOUSE_BUTTON_LEFT, MOUSE_BUTTON_RIGHT, MOUSE_BUTTON_MIDDLE.

Shapes (raylib.shapes)

Lines

Circles

Rectangles

Triangles and Polygons

Collision Detection

Text (raylib.text)

Textures (raylib.textures)

Colors (raylib.colors)

Raylib colors are provided as functions prefixed with rl_:

var bg = rl_raywhite()       // Light background
var fg = rl_darkgray()       // Dark text
var highlight = rl_red()     // Bright red

Custom colors with rl_color:

var custom = rl_color(128, 64, 200, 255)    // r, g, b, a

Models (raylib.models)

3D Shape Drawing

DrawCube(pos, 2.0, 2.0, 2.0, rl_red())
DrawSphere(pos, 1.0, rl_blue())
DrawGrid(10, 1.0)

Model Loading & Drawing

Mesh Generation

var cube = GenMeshCube(1.0, 1.0, 1.0)
var sphere = GenMeshSphere(0.5, 16, 16)

Functions: GenMeshPoly, GenMeshPlane, GenMeshCube, GenMeshSphere, GenMeshHemiSphere, GenMeshCylinder, GenMeshCone, GenMeshTorus, GenMeshKnot, GenMeshHeightmap, GenMeshCubicmap.

3D Collision

Audio (raylib.audio)

Setup

InitAudioDevice()
defer CloseAudioDevice()

Sound (short samples)

var sfx = LoadSound("explosion.wav")
PlaySound(sfx)
SetSoundVolume(sfx, 0.8)
// ...
UnloadSound(sfx)

Music (streaming)

var music = LoadMusicStream("background.ogg")
PlayMusicStream(music)
// In game loop:
UpdateMusicStream(music)

Wave Processing

Config Flags

Set before InitWindow with SetConfigFlags:

SetConfigFlags(FLAG_WINDOW_RESIZABLE)
InitWindow(800, 600, "Resizable Window")

Platform Notes

• Windows: Auto-switches to Clang for linking. The -DNOGDI -DNOUSER flags are automatically applied to prevent windows.h from conflicting with raylib’s Rectangle, CloseWindow, and ShowCursor definitions.
• Linux: Links against libraylib.a with -lGL -lm -lpthread -ldl -lrt -lX11.
• macOS: Links against libraylib.a with CoreVideo, IOKit, Cocoa, OpenGL frameworks.
• TCC: Not supported for raylib (can’t link static libraries). Clang is used automatically.

Why Not Source Compilation?

Unlike Sokol (which uses a single @cfile bridge), raylib cannot be compiled in a single translation unit. Its internal headers (rlgl.h, glad.h) define global variables that cause redefinition errors when multiple .c files are included together. Additionally, TCC lacks the Windows SDK headers that raylib’s GLFW backend requires. The prebuilt library approach is the most reliable path.

Module Layout

modules/
  raylib/
    c/
      raylib.h         Raylib header (v5.5)
    lib/
      raylib.lib       Prebuilt static library (MSVC/Windows)
      libraylib.a      Prebuilt static library (GCC/Linux/macOS)
    gx/
      core.gx          Build directives, 29 structs, window, timing, camera, shaders
      input.gx         Keyboard/mouse enums and query functions
      shapes.gx        2D shapes, splines, 2D collision
      text.gx          Text drawing, fonts, codepoints, text utilities
      textures.gx      Image/texture loading, manipulation, color utilities
      colors.gx        Color constants (rl_red, rl_blue, etc.)
      models.gx        3D shapes, model/mesh/material, animations, 3D collision
      audio.gx         Sound, music streaming, wave processing, audio streams