ssdfasd
dc850d7739
- 重组文档目录结构: 每个模块的概述页移动到模块子目录 - 重命名 index.md 为 main.md - 修正所有模块文档中的错误: - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式 - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节 - core: 修复 types 链接错误 - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI - memory: 修复头文件路径, malloc vs operator new, 新增方法文档 - resources: 修复 Shader/Texture 链接错误 - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接 - 验证: fix_links.py 确认 0 个断裂引用
103 lines
2.4 KiB
Markdown
103 lines
2.4 KiB
Markdown
# MemoryManager
|
|
|
|
**命名空间**: `XCEngine::Memory`
|
|
|
|
**类型**: `class` (singleton)
|
|
|
|
**描述**: 全局内存管理器单例，提供系统分配器和各种专用分配器的创建。
|
|
|
|
## 概述
|
|
|
|
`MemoryManager` 是 XCEngine 内存管理系统的核心单例。它负责维护系统分配器，提供分配器工厂方法，并支持内存泄漏检测和报告。
|
|
|
|
## 单例访问
|
|
|
|
| 方法 | 描述 |
|
|
|------|------|
|
|
| `Get` | 获取单例实例 |
|
|
|
|
## 公共方法
|
|
|
|
### 生命周期
|
|
|
|
| 方法 | 描述 |
|
|
|------|------|
|
|
| `Initialize` | 初始化内存管理器 |
|
|
| `Shutdown` | 关闭内存管理器 |
|
|
|
|
### 系统分配器
|
|
|
|
| 方法 | 描述 |
|
|
|------|------|
|
|
| `GetSystemAllocator` | 获取系统默认分配器 |
|
|
|
|
### 分配器创建
|
|
|
|
| 方法 | 描述 |
|
|
|------|------|
|
|
| `CreateLinearAllocator` | 创建线性分配器 |
|
|
| `CreatePoolAllocator` | 创建内存池分配器 |
|
|
| `CreateProxyAllocator` | 创建代理分配器 |
|
|
|
|
### 内存管理
|
|
|
|
| 方法 | 描述 |
|
|
|------|------|
|
|
| `SetTrackAllocations` | 设置是否跟踪分配 |
|
|
| `DumpMemoryLeaks` | 输出内存泄漏报告 |
|
|
| `GenerateMemoryReport` | 生成内存使用报告 |
|
|
|
|
## 宏定义
|
|
|
|
### XE_ALLOC
|
|
|
|
```cpp
|
|
#define XE_ALLOC(allocator, size, ...) allocator->Allocate(size, ##__VA_ARGS__)
|
|
```
|
|
|
|
内存分配宏。
|
|
|
|
### XE_FREE
|
|
|
|
```cpp
|
|
#define XE_FREE(allocator, ptr) allocator->Free(ptr)
|
|
```
|
|
|
|
内存释放宏。
|
|
|
|
## 使用示例
|
|
|
|
```cpp
|
|
#include <XCEngine/Memory/MemoryManager.h>
|
|
|
|
// 初始化
|
|
MemoryManager::Get().Initialize();
|
|
|
|
// 获取系统分配器
|
|
IAllocator* sysAlloc = MemoryManager::Get().GetSystemAllocator();
|
|
|
|
// 创建专用分配器
|
|
auto linearAlloc = MemoryManager::Get().CreateLinearAllocator(1024 * 1024);
|
|
auto poolAlloc = MemoryManager::Get().CreatePoolAllocator(sizeof(MyObject), 1000);
|
|
auto proxyAlloc = MemoryManager::Get().CreateProxyAllocator("GameFrame");
|
|
|
|
// 使用宏分配
|
|
void* ptr = XE_ALLOC(proxyAlloc, 256);
|
|
XE_FREE(proxyAlloc, ptr);
|
|
|
|
// 跟踪内存
|
|
MemoryManager::Get().SetTrackAllocations(true);
|
|
MemoryManager::Get().GenerateMemoryReport();
|
|
|
|
// 关闭
|
|
MemoryManager::Get().Shutdown();
|
|
```
|
|
|
|
## 相关文档
|
|
|
|
- [Memory 模块总览](../memory.md) - 返回模块总览
|
|
- [IAllocator](../allocator/allocator.md) - 分配器接口
|
|
- [LinearAllocator](../linear-allocator/linear-allocator.md) - 线性分配器
|
|
- [PoolAllocator](../pool-allocator/pool-allocator.md) - 内存池分配器
|
|
- [ProxyAllocator](../proxy-allocator/proxy-allocator.md) - 代理分配器
|