docs/api/resources/texture/create.md

# Texture::Create

```cpp
bool Create(Core::uint32 width, Core::uint32 height, Core::uint32 depth,
            Core::uint32 mipLevels, TextureType type, TextureFormat format,
            const void* data, size_t dataSize)
```

创建纹理资源。设置纹理的尺寸、格式和像素数据，并分配 GPU 资源。

**参数：**
- `width` - 纹理宽度（像素）
- `height` - 纹理高度（像素）
- `depth` - 纹理深度（3D 纹理设为 1）
- `mipLevels` - Mipmap 级别数
- `type` - 纹理类型
- `format` - 纹理格式
- `data` - 像素数据指针
- `dataSize` - 像素数据大小

**返回：** 创建成功返回 true

**复杂度：** O(n)，n 为像素数量

**示例：**

```cpp
Texture tex;
bool ok = tex.Create(
    1024, 1024, 1, 0,
    TextureType::Texture2D,
    TextureFormat::RGBA8_UNORM,
    pixelData, pixelDataSize
);
```

## 相关文档

- [Texture 总览](texture.md) - 返回类总览
-												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
+								# Texture::Create
 								```cpp
 								bool Create(Core::uint32 width, Core::uint32 height, Core::uint32 depth,
 								            Core::uint32 mipLevels, TextureType type, TextureFormat format,
 								            const void* data, size_t dataSize)
 								```
 								创建纹理资源。设置纹理的尺寸、格式和像素数据，并分配 GPU 资源。
 								**参数：**
 								- `width` - 纹理宽度（像素）
 								- `height` - 纹理高度（像素）
 								- `depth` - 纹理深度（3D 纹理设为 1）
-												docs: 修正 API 文档准确性 (第二轮检查)

修复的问题:
- math: 修复 Quaternion::Normalize 链接错误
- containers: HashMap 迭代器示例使用不存在的 cbegin/cend，删除冗余构造函数声明
- core: RefCounted 析构函数访问级别修正 (protected)
- debug: LogLevelToString 示例返回值大小写修正
- memory: 修正 LinearAllocator::Reallocate 返回 nullptr，ProxyAllocator 统计描述，头文件路径 IAllocator.h -> Allocator.h
- resources: Texture::Create mipLevels 参数描述修正
- rhi: 修复多处链接错误，新增缺失的方法文档
- threading: TaskSystem 配置项未实现状态标注，Wait 方法空实现标注

											
										
										
											2026-03-19 00:31:14 +08:00
+								- `mipLevels` - Mipmap 级别数
-												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
+								- `type` - 纹理类型
 								- `format` - 纹理格式
 								- `data` - 像素数据指针
 								- `dataSize` - 像素数据大小
 								**返回：** 创建成功返回 true
 								**复杂度：** O(n)，n 为像素数量
 								**示例：**
 								```cpp
 								Texture tex;
 								bool ok = tex.Create(
 , 1024, 1, 0,
 								    TextureType::Texture2D,
 								    TextureFormat::RGBA8_UNORM,
 								    pixelData, pixelDataSize
 								);
 								```
 								## 相关文档
 								- [Texture 总览](texture.md) - 返回类总览