Files

ssdfasd dc850d7739 docs: 重构 API 文档结构并修正源码准确性

- 重组文档目录结构: 每个模块的概述页移动到模块子目录
- 重命名 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 个断裂引用

2026-03-19 00:22:30 +08:00

2.4 KiB

Raw Blame History

MemoryManager

命名空间: XCEngine::Memory

类型: class (singleton)

描述: 全局内存管理器单例，提供系统分配器和各种专用分配器的创建。

概述

MemoryManager 是 XCEngine 内存管理系统的核心单例。它负责维护系统分配器，提供分配器工厂方法，并支持内存泄漏检测和报告。

单例访问

方法	描述
`Get`	获取单例实例

公共方法

生命周期

方法	描述
`Initialize`	初始化内存管理器
`Shutdown`	关闭内存管理器

系统分配器

方法	描述
`GetSystemAllocator`	获取系统默认分配器

分配器创建

方法	描述
`CreateLinearAllocator`	创建线性分配器
`CreatePoolAllocator`	创建内存池分配器
`CreateProxyAllocator`	创建代理分配器

内存管理

方法	描述
`SetTrackAllocations`	设置是否跟踪分配
`DumpMemoryLeaks`	输出内存泄漏报告
`GenerateMemoryReport`	生成内存使用报告

宏定义

XE_ALLOC

#define XE_ALLOC(allocator, size, ...) allocator->Allocate(size, ##__VA_ARGS__)

内存分配宏。

XE_FREE

#define XE_FREE(allocator, ptr) allocator->Free(ptr)

内存释放宏。

使用示例

#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();

2.4 KiB Raw Blame History