101 lines
2.4 KiB
Markdown
101 lines
2.4 KiB
Markdown
# 资源加载示例
|
||
|
||
演示如何使用 Extra2D 引擎的资源管理器加载各种资源。
|
||
|
||
## 功能演示
|
||
|
||
1. **纹理加载** - 从文件加载 PNG/JPG 纹理
|
||
2. **字体加载** - 使用 FreeType 加载 TTF 字体，支持中英文
|
||
3. **文本创建** - 创建可渲染的文本对象
|
||
4. **着色器加载** - 从文件或源码加载 GLSL 着色器
|
||
5. **材质创建** - 组合纹理和着色器创建材质
|
||
6. **音频加载** - 加载音效和音乐
|
||
7. **资源统计** - 查看已加载资源的统计信息
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
resource_loading/
|
||
├── main.cpp # 示例主文件
|
||
├── xmake.lua # 构建脚本
|
||
├── README.md # 本文件
|
||
└── romfs/
|
||
└── assets/ # 资源目录
|
||
├── textures/ # 纹理文件
|
||
├── fonts/ # 字体文件
|
||
├── audio/ # 音频文件
|
||
└── shaders/ # 着色器文件
|
||
```
|
||
|
||
## 构建
|
||
|
||
### MinGW (Windows)
|
||
|
||
```bash
|
||
xmake f -p mingw -a x86_64
|
||
xmake resource_loading
|
||
```
|
||
|
||
### Nintendo Switch
|
||
|
||
```bash
|
||
xmake f -p switch -a aarch64
|
||
xmake resource_loading
|
||
```
|
||
|
||
## 运行
|
||
|
||
### Windows
|
||
|
||
```bash
|
||
./build/examples/resource_loading/resource_loading.exe
|
||
```
|
||
|
||
### Switch
|
||
|
||
将生成的 `resource_loading.nro` 复制到 Switch SD 卡运行。
|
||
|
||
## 资源管理 API 示例
|
||
|
||
```cpp
|
||
// 获取资源管理器
|
||
auto& resources = app->context().resources();
|
||
|
||
// 加载纹理
|
||
auto texture = resources.getTexture("assets/textures/image.png");
|
||
|
||
// 加载字体
|
||
FontConfig config;
|
||
config.fontSize = 24;
|
||
config.preloadCommon = true;
|
||
auto font = resources.getFont("assets/fonts/font.ttf", config);
|
||
|
||
// 创建文本
|
||
auto text = resources.createText(font, "Hello 世界!");
|
||
text->setFontSize(32);
|
||
text->rebuild();
|
||
|
||
// 加载着色器
|
||
auto shader = resources.getShader("vs.glsl", "fs.glsl");
|
||
|
||
// 创建材质
|
||
auto material = resources.createMaterial(shader);
|
||
material->setTexture("uTexture", texture);
|
||
material->setColor("uColor", Color::Red);
|
||
|
||
// 加载音频
|
||
auto sound = resources.getAudio("jump.wav", AudioType::Sound);
|
||
auto music = resources.getAudio("bgm.mp3", AudioType::Music);
|
||
|
||
// 获取资源统计
|
||
auto stats = resources.getStats();
|
||
printf("Textures: %zu\n", stats.textureCount);
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- 字体文件需要是 TTF 格式
|
||
- 纹理支持 PNG、JPG、BMP 等格式（通过 stb_image）
|
||
- 音频支持 WAV、MP3、OGG 等格式（通过 SDL2_mixer）
|
||
- 着色器使用 OpenGL ES 3.2 语法
|