raylib 游戏编程库

raylib 是什么

raylib 是一个用纯 C（C99）编写的简单易用的游戏编程库，灵感来自 Borland BGI 图形库与 XNA 框架。它的目标不是提供花哨的编辑器或可视化工具，而是让开发者用最纯粹的编码方式享受游戏编程的乐趣。

它特别适合原型开发、工具制作、图形应用、嵌入式系统与教学场景。

核心特性

• 零外部依赖：所有需要的库都已内置在 raylib 源码中，无需额外安装。
• 多平台支持：Windows、Linux、macOS、树莓派、Android、HTML5/WebAssembly 等。
• 硬件加速：基于 OpenGL 1.1 / 2.1 / 3.3 / 4.3 及 ES 2.0 / ES 3.0。
• 完整 3D 支持：3D 形状、模型、公告板、高度图、骨骼动画（IQM、M3D、glTF）。
• 材质与着色器：支持 PBR 贴图与后处理着色器。
• 音频播放：支持 WAV、QOA、OGG、MP3、FLAC、XM、MOD 等格式。
• VR 立体渲染：可配置 HMD 设备参数。
• 丰富生态：200+ 代码示例，70+ 语言绑定。

快速上手

下面是一个最基础的示例，创建窗口并在屏幕中央绘制文字：

#include "raylib.h"

int main(void)
{
    InitWindow(800, 450, "raylib example - basic window");

    while (!WindowShouldClose())
    {
        BeginDrawing();
            ClearBackground(RAYWHITE);
            DrawText("Congrats! You created your first window!", 190, 200, 20, LIGHTGRAY);
        EndDrawing();
    }

    CloseWindow();

    return 0;
}

整体结构非常清晰：初始化窗口 → 主循环（绘制开始 / 清屏 / 绘制内容 / 绘制结束）→ 关闭窗口。

安装与构建

官方在 GitHub Releases 页面提供 Windows、Linux、macOS、Android 与 HTML5 的预编译二进制包，同时也可通过多种操作系统的包管理器安装。

详细的各平台构建说明可参考官方 Wiki，涵盖 Windows、macOS、GNU Linux、Chrome OS、FreeBSD、树莓派、Android、Web（HTML5）以及 CMake 通用构建方式。

已知限制

raylib 出于代码简洁性的考虑，在设计上存在一些限制：

• 默认只支持单窗口、单 OpenGL 上下文，不支持多窗口。
• 在支持窗口的平台上，窗口缩放或移动会暂停渲染循环。
• RenderTexture 按 OpenGL 约定垂直翻转，需要用户自行处理绘制方向。
• 字体光栅化质量低于使用 FreeType2、HarfBuzz 或 Slug 的方案。
• 文本绘制不支持 RTL、连字或 emoji。

这些限制大多可通过社区分支或自行修改库来绕过。

适合谁使用

如果你是游戏开发初学者、图形学爱好者，或需要快速验证游戏原型、开发小型工具与嵌入式图形程序，raylib 都是一个门槛极低、上手极快的选择。