67 lines
1.7 KiB
Markdown
67 lines
1.7 KiB
Markdown
# ResourceFileSystem::ReadResource
|
|
|
|
## 方法签名
|
|
|
|
```cpp
|
|
Containers::Array<Core::uint8> ReadResource(const Containers::String& relativePath) const;
|
|
```
|
|
|
|
## 所属类
|
|
|
|
`XCEngine::Resources::ResourceFileSystem`
|
|
|
|
## 描述
|
|
|
|
读取指定相对路径的资源内容，以字节数组形式返回。该方法会首先查找资源的绝对路径，然后从文件系统读取数据。
|
|
|
|
此方法线程安全。
|
|
|
|
## 参数
|
|
|
|
| 参数名 | 类型 | 描述 |
|
|
|--------|------|------|
|
|
| `relativePath` | `const Containers::String&` | 资源的相对路径 |
|
|
|
|
## 返回值
|
|
|
|
- `Containers::Array<Core::uint8>` - 资源数据的字节数组。如果读取失败或资源不存在，返回空数组。
|
|
|
|
## 示例
|
|
|
|
```cpp
|
|
#include "Resources/ResourceFileSystem.h"
|
|
|
|
using namespace XCEngine::Resources;
|
|
|
|
ResourceFileSystem& fs = ResourceFileSystem::Get();
|
|
fs.Initialize("C:/Game/Resources");
|
|
fs.AddDirectory("C:/Game/Assets");
|
|
|
|
// 读取文本资源
|
|
auto textData = fs.ReadResource("shaders/forward.glsl");
|
|
if (textData.Size() > 0) {
|
|
printf("Shader size: %zu bytes\n", textData.Size());
|
|
// 处理着色器源码
|
|
}
|
|
|
|
// 读取二进制资源
|
|
auto texData = fs.ReadResource("textures/player/diffuse.png");
|
|
if (texData.Size() > 0) {
|
|
// 使用图像数据
|
|
const uint8_t* pixels = texData.Data();
|
|
size_t width = *reinterpret_cast<const size_t*>(pixels);
|
|
}
|
|
|
|
// 读取不存在的资源
|
|
auto invalidData = fs.ReadResource("nonexistent/file.txt");
|
|
if (invalidData.Empty()) {
|
|
printf("Resource not found or read error\n");
|
|
}
|
|
```
|
|
|
|
## 注意事项
|
|
|
|
- 返回的数组直接包含文件的原始字节数据
|
|
- 当前实现仅支持从文件系统读取，档案读取待实现
|
|
- 读取失败时返回空数组，可通过 `Empty()` 方法检查
|