Raylib 杂记

Raylib 杂记

Raylib 简介
Raylib 是一个 简单、易用且跨平台 的游戏开发库,无外部依赖,
特别适合用来学习图形学、游戏编程和快速制作原型。
它完全使用 C 语言写成(同时也提供了超过 50 种语言的绑定),
核心设计理念是“没有复杂依赖,开箱即用”。

2D坐标,原点在屏幕左上角

  • x: 指向屏幕横向向右
  • y: 指向屏幕纵向向下

3D坐标,采用右手系

  • x: 指向屏幕横向向右
  • y: 指向屏幕纵向向上
  • z: 指向屏幕外侧

OpenGL 相关模块

GLFW

Graphics Library Framework
是一个专门为 OpenGL 设计的 跨平台窗口和输入处理库

  • 功能:创建窗口、创建 OpenGL 上下文、处理键盘鼠标手柄输入、管理时间等,彻底屏蔽操作系统层面的差异
  • 目前版本的 Raylib 不再依赖 GLFW,目前Raylib已拥有窗口和输入管理功能

GLSL

OpenGL Shading Language
是运行在 GPU 上的, 着色器编程语言,语法类似于 C

  • 作用:现代图形渲染管线是“可编程”的,GLSL 就是用来编写这些运行在显卡上的程序。最常见的是顶点着色器(处理每个顶点的位置变换)和片元着色器(计算每个像素的颜色)。
  • 使用前提:将 顶点着色器 放在 .vs 命名的目录下,将 面着色器 放在 .fs 命名的目录下

在 Raylib 中可以使用 LoadShader() 加载 <name>.glsl 文件,并使用 BeginShaderMode() 应用该着色器程序

<rlgl.h>

Raylib OpenGL

对 OpenGL 渲染管线 进行了轻量封装,提供了一个操作 OpenGL层 的方法,是 Raylib 与 OpenGL 的一个中间层


API与数据类型设计

Function 函数

每个 Raylib 函数命名都遵循以下语法结构:
<动词><主语><补语>
或者说
<动作行为><对象><属性/状态>
即:
在 <某物> 的 <某 属性/状态> 上,做 <动作行为>

Raylib 函数大多被设计为值传递函数,小部分需要传递引用


Structure 结构类型

Raylib 定义了 34种结构类型 (v5.1)

Struct Name 结构名称 字段数量
Vector2 2D向量 2
Vector3 3D向量 3
Vector4 4D向量 4
Matrix 矩阵 16
Transform 3D变换矩阵 3
Color 颜色 4
Rectangle 矩形 4
Image 图片 5
Texture 纹理 5
RenderTexture 渲染纹理 3
NPatchInfo 9-patch信息(九宫格缩放) 6
GlyphInfo 单个字符字形信息 5
Font 字体 6
Camera2D 2D相机 4
Camera3D 3D相机 5
Mesh 网格 21
Shader 着色器 2
Material 材质 3
MaterialMap 材质贴图槽 3
Model 模型 12
BoneInfo 骨骼信息 2
ModelAnimation 模型动画 5
BoundingBox 包围盒(碰撞箱) 2
Ray 光线 2
RayCollision 光线碰撞信息 4
Wave .wav格式音频文件 5
AudioStream 音频流 5
Sound 音效 2
Music 音乐 5
FilePathList 文件路径列表 3
AutomationEvent 自动化事件 3
AutomationEventList 自动化事件列表 3
VrDeviceInfo VR设备信息 9
VrStereoConfig VR立体配置 8

Enumerator 枚举类型

Raylib 定义了 21种枚举类型 (v5.1)
各个枚举类中的枚举值,一般都将该类的 大写全称 作为 前缀
随着库的更新,可能会添加相应的枚举状态

没有函数指向这些枚举类型,所有相关参数都被定义为 int 类型,在程序中仅作为定义值使用

Enum Name 枚举类型名称 枚举数量
ConfigFlags 配置标志 16
TraceLogLevel 日志输出级别 8
KeyboardKey 键盘键值 114
MouseButton 鼠标按钮 7
MouseCursor 鼠标光标样式 11
GamepadButton 手柄按钮 18
GamepadAxis 手柄轴 6
Gesture 触控手势 11
PixelFormat 像素格式 24
BlendMode 颜色混合模式 8
MaterialMapIndex 材质贴图槽索引 11
ShaderLocationIndex 着色器位置索引 26
ShaderUniformDataType 着色器Uniform(GLSL术语)数据类型 (从CPU传入GPU的全局只读变量) 9
ShaderAttributeDataType 着色器属性数据类型 4
TextureFilter 纹理滤镜 6
TextureWrap 纹理寻址模式 4
CubemapLayout 立方体贴图布局 6
FontType 字体类型 3
CameraMode 相机模式 5
CameraProjection 相机投影 2
NPatchLayout 9-patch(九宫格缩放)布局 3

快速开始

使用格式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
#include <raylib.h>

int main(void)
{
// 初始化常量
const int WIDTH = 1080;
const int HEIGHT = 720;

// 初始化窗口
InitWindow(WIDTH, HEIGHT, "LEARNING RAYLIB");

// 设定帧率
SetTargetFPS(30);

// 主循环
while(!WindowShouldClose()) // ESC 后退出
{
BeginDrawing(); // 开始绘制窗口
ClearBackground(BLACK); // 使用颜色清理背景



EndDrawing(); // 结束绘制
}

// 关闭窗口
CloseWindow();
return 0;
}

简单示例

源程序

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
#include <raylib.h>
#include <rlgl.h>
#include <math.h>

typedef struct {
Vector3 position;
float length;
float width;
float height;
Color wire_color;
Color face_color;
} Cube_t;

typedef struct {
Vector3 axis;
float speed;
} Rotate_t;

typedef struct {
double pre_tick;
double cur_tick;
} Global_Clock_t;

double RenewGlobalClock(Global_Clock_t *global_clock) {
float pre_tick = global_clock->cur_tick;
global_clock->cur_tick = GetTime();
double gap_time = global_clock->cur_tick - pre_tick;
global_clock->pre_tick = pre_tick;
return gap_time;
}

int main(void)
{
// 初始化
const int screenWidth = 1080;
const int screenHeight = 720;
const int FPS = 60;
const Color background_color = {0x66, 0xCC, 0xFF, 0xFF};

// 启用反锯齿
SetConfigFlags(FLAG_MSAA_4X_HINT);

// 初始化窗口
InitWindow(screenWidth, screenHeight, "rotate cube");

// 加载着色器
Shader my_shader = LoadShader(0, "grey-shader.glsl");

// 初始化摄像机
Camera3D camera = {
.position = (Vector3){ 40.f, 50.f, 30.f }, // 相机所在位置{x,y,z}
.target = (Vector3){ 0.0f, 0.0f, 0.0f }, // 相机朝向位置{x,y,z}
.up = (Vector3){ 0.0f, 1.0f, 0.0f }, // 相机正上方朝向矢量
.fovy = 70.0f, // 相机视野宽度
.projection = CAMERA_PERSPECTIVE // 采用透视投影
};

// 初始化方体参数
Cube_t cube = {
.height = 20.0f,
.length = 20.0f,
.width = 20.0f,
.wire_color = BLACK,
.face_color = (Color){0xAA, 0x00, 0x00, 0xFF},
.position = {
.x = 0.0f,
.y = 0.0f,
.z = 0.0f
}
};

float cube_angle=0.f; //多边形旋转角度
Rotate_t cube_rotate = {
.axis = {
.x = 0.f,
.y = 1.f,
.z = 0.f
},
.speed = 50.f
};

// 设定帧率
SetTargetFPS(FPS);
Global_Clock_t global_clock = {
.cur_tick = GetTime()
};

// 主循环
while (!WindowShouldClose())
{
const float gap_time = RenewGlobalClock(&global_clock);

cube_angle += cube_rotate.speed * gap_time;
cube_angle = fmodf(cube_angle, 360.f);

BeginDrawing();
ClearBackground(background_color);
BeginMode3D(camera);

BeginShaderMode(my_shader); // 使用自定义着色器

rlPushMatrix();
rlTranslatef(cube.position.x, cube.position.y, cube.position.z);
rlRotatef(cube_angle,
cube_rotate.axis.x, cube_rotate.axis.y, cube_rotate.axis.z);
rlTranslatef(-cube.position.x, -cube.position.y, -cube.position.z);
DrawCube(cube.position,
cube.length, cube.height, cube.width,
cube.face_color);
DrawCubeWires(cube.position,
cube.length, cube.height, cube.width,
cube.wire_color);
rlPopMatrix();

EndShaderMode(); // 恢复默认着色器

DrawSphere(
(Vector3){30.f, 0.f, 0.f},
5.f,
(Color){0xAA, 0x00, 0xAA, 0xFF});

EndMode3D();
EndDrawing();
}

// 释放着色器资源
UnloadShader(my_shader);
// 关闭窗口
CloseWindow();

return 0;
}
glsl 着色程序
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
#version 330
// 使用的 glsl 版本

// input: 从顶点着色器传来的纹理坐标
in vec2 fragTexCoord;

// output: 最终颜色
out vec4 finalColor;

// uniform: 默认会绑定到当前激活的纹理
// (Raylib 绘制的物体通常会使用白色纹理)
uniform sampler2D texture0;

void main()
{
vec4 texColor = texture(texture0, fragTexCoord);
// 灰度公式
float gray = dot(texColor.rgb, vec3(0.299, 0.587, 0.114));
finalColor = vec4(vec3(gray), texColor.a);
}
构建文件
1
2
3
4
5
6
7
8
9
CC = gcc
CFLAG = -g -Wall
LINK = -lraylib -lm

TARGET = main

# gcc main.c -g -Wall -lraylib -lm -o main
$(TARGET): main.c
$(CC) $^ $(CFLAG) $(LINK) -o $@