Files
XCEngine/docs/api/rhi/texture/texture.md
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.2 KiB

RHITexture

命名空间: XCEngine::RHI

类型: class (abstract)

描述: GPU 纹理资源抽象接口,用于管理 1D、2D、3D 纹理和立方体贴图等 GPU 资源。

公共方法

属性访问

方法 文档
GetWidth 详细文档
GetHeight 详细文档
GetDepth 详细文档
GetMipLevels 详细文档
GetFormat 详细文档
GetTextureType 详细文档

状态管理

方法 文档
GetState 详细文档
SetState 详细文档

生命周期

方法 文档
Shutdown 详细文档

其他

方法 文档
GetNativeHandle 详细文档
GetName 详细文档
SetName 详细文档

纹理类型 (TextureType)

枚举值 描述
TextureType::Texture1D 1D 纹理
TextureType::Texture2D 2D 纹理
TextureType::Texture2DArray 2D 纹理数组
TextureType::Texture3D 3D 纹理(体积纹理)
TextureType::TextureCube 立方体贴图
TextureType::TextureCubeArray 立方体贴图数组

纹理格式 (Format)

格式 描述
Format::R8G8B8A8_UNorm 四通道 8 位归一化
Format::R16G16B16A16_Float 四通道 16 位浮点
Format::D32_Float 32 位深度
Format::BC1_UNorm BC1 压缩 (DXT1)
Format::BC7_UNorm BC7 高质量压缩

使用示例

TextureDesc desc;
desc.width = 1024;
desc.height = 1024;
desc.format = (uint32_t)Format::R8G8B8A8_UNorm;
desc.textureType = (uint32_t)TextureType::Texture2D;

RHITexture* texture = device->CreateTexture(desc);
texture->SetState(ResourceStates::PixelShaderResource);
texture->Shutdown();

相关文档