52 lines
1.1 KiB
Markdown
52 lines
1.1 KiB
Markdown
|
# ResourceFileSystem::AddArchive
|
||
|
|
|
||
|
|
## 方法签名
|
||
|
|
|
||
|
|
```cpp
|
||
|
|
bool AddArchive(const Containers::String& archivePath);
|
||
|
|
```
|
||
|
|
|
||
|
|
## 所属类
|
||
|
|
|
||
|
|
`XCEngine::Resources::ResourceFileSystem`
|
||
|
|
|
||
|
|
## 描述
|
||
|
|
|
||
|
|
添加档案压缩包作为资源来源。档案文件（如 ZIP、Pak 等格式）会被注册为可搜索的资源位置。
|
||
|
|
|
||
|
|
此方法线程安全。
|
||
|
|
|
||
|
|
## 参数
|
||
|
|
|
||
|
|
| 参数名 | 类型 | 描述 |
|
||
|
|
|--------|------|------|
|
||
|
|
| `archivePath` | `const Containers::String&` | 档案压缩包的路径 |
|
||
|
|
|
||
|
|
## 返回值
|
||
|
|
|
||
|
|
- `bool` - 成功添加返回 `true`
|
||
|
|
|
||
|
|
## 示例
|
||
|
|
|
||
|
|
```cpp
|
||
|
|
#include "Resources/ResourceFileSystem.h"
|
||
|
|
|
||
|
|
using namespace XCEngine::Resources;
|
||
|
|
|
||
|
|
ResourceFileSystem& fs = ResourceFileSystem::Get();
|
||
|
|
fs.Initialize("C:/Game/Resources");
|
||
|
|
|
||
|
|
// 添加多个档案作为资源来源
|
||
|
|
fs.AddArchive("C:/Game/Paks/Common.pak");
|
||
|
|
fs.AddArchive("C:/Game/Paks/Textures.pak");
|
||
|
|
fs.AddArchive("C:/Game/Paks/Audio.pak");
|
||
|
|
|
||
|
|
// 读取档案中的资源
|
||
|
|
auto data = fs.ReadResource("textures/player/diffuse.png");
|
||
|
|
```
|
||
|
|
|
||
|
|
## 注意事项
|
||
|
|
|
||
|
|
- 当前实现仅存储路径，实际档案加载功能待实现
|
||
|
|
- 档案中的资源会通过 `FindInArchives` 被搜索
|