82 lines
1.8 KiB
Markdown
82 lines
1.8 KiB
Markdown
|
# OpenGLDevice::CreateTexture
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
RHITexture* CreateTexture(const TextureDesc& desc) override
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
创建 OpenGL 纹理对象。
|
|||
|
|
|
|||
|
|
## 详细描述
|
|||
|
|
|
|||
|
|
根据 `TextureDesc` 创建一个 OpenGL 纹理对象。纹理类型映射：
|
|||
|
|
|
|||
|
|
| TextureDesc.textureType | OpenGLTextureType |
|
|||
|
|
|------------------------|-------------------|
|
|||
|
|
| 0 | Texture1D |
|
|||
|
|
| 1 (默认) | Texture2D |
|
|||
|
|
| 2 | Texture3D |
|
|||
|
|
| 3 | TextureCube |
|
|||
|
|
|
|||
|
|
### 纹理格式
|
|||
|
|
|
|||
|
|
当前实现固定使用 `RGBA8` (RGBA, 8 bits per channel) 格式。
|
|||
|
|
|
|||
|
|
### 纹理参数
|
|||
|
|
|
|||
|
|
| 参数 | 值 |
|
|||
|
|
|------|-----|
|
|||
|
|
| 格式 | RGBA8 |
|
|||
|
|
| Mipmap | 根据 `desc.mipLevels` |
|
|||
|
|
| 类型 | GL_UNSIGNED_BYTE |
|
|||
|
|
|
|||
|
|
## 参数
|
|||
|
|
|
|||
|
|
- `desc` - 纹理描述符
|
|||
|
|
|
|||
|
|
### TextureDesc 字段
|
|||
|
|
|
|||
|
|
| 字段 | 描述 |
|
|||
|
|
|------|------|
|
|||
|
|
| `textureType` | 纹理类型 (0=1D, 1=2D, 2=3D, 3=Cube) |
|
|||
|
|
| `width` | 纹理宽度 |
|
|||
|
|
| `height` | 纹理高度 |
|
|||
|
|
| `depth` | 纹理深度（用于 3D 纹理） |
|
|||
|
|
| `mipLevels` | Mipmap 级别数量 |
|
|||
|
|
|
|||
|
|
## 返回值
|
|||
|
|
|
|||
|
|
`RHITexture*` - 创建的纹理指针
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
- 当前实现创建的纹理初始数据为 `nullptr`（空纹理）
|
|||
|
|
- 返回的纹理对象归调用者所有，需自行管理生命周期
|
|||
|
|
- 1D 纹理使用 `height=1`，3D 纹理使用 `depth` 参数
|
|||
|
|
|
|||
|
|
## 示例
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
// 创建 2D 纹理
|
|||
|
|
TextureDesc tex2dDesc;
|
|||
|
|
tex2dDesc.textureType = 1; // Texture2D
|
|||
|
|
tex2dDesc.width = 1024;
|
|||
|
|
tex2dDesc.height = 1024;
|
|||
|
|
tex2dDesc.mipLevels = 1;
|
|||
|
|
|
|||
|
|
RHITexture* tex2d = device.CreateTexture(tex2dDesc);
|
|||
|
|
|
|||
|
|
// 创建立方体纹理
|
|||
|
|
TextureDesc texCubeDesc;
|
|||
|
|
texCubeDesc.textureType = 3; // TextureCube
|
|||
|
|
texCubeDesc.width = 512;
|
|||
|
|
texCubeDesc.height = 512;
|
|||
|
|
texCubeDesc.mipLevels = 1;
|
|||
|
|
|
|||
|
|
RHITexture* texCube = device.CreateTexture(texCubeDesc);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 相关文档
|
|||
|
|
|
|||
|
|
- [OpenGLDevice](device.md) - 类总览
|
|||
|
|
- [OpenGLTexture](../opengl-texture.md) - OpenGL 纹理实现
|