4.0 KiB
4.0 KiB
OpenGLResourceView
命名空间: XCEngine::RHI
类型: class
头文件: XCEngine/RHI/OpenGL/OpenGLResourceView.h
描述: OpenGL 后端统一资源视图对象，把 RHI 层的多种 view 语义映射为纹理、缓冲区、framebuffer 及其绑定元数据。
概览
在 D3D12 / Vulkan 里，resource view 往往会自然让人想到独立的 descriptor 或 view object。OpenGL 不是这套模型，它更多依赖:
- 纹理对象本身
- buffer 对象本身
- framebuffer 绑定关系
- texture unit / image unit / uniform buffer binding point
OpenGLResourceView 的职责，就是把这些分散的 OpenGL 机制整理成统一的 RHI 视图对象，让上层仍然可以用 RenderTargetView、ShaderResourceView、ConstantBufferView 这类抽象去表达渲染意图。
设计定位
它不是“单一原生句柄的薄封装”，而是一个多态视图元数据对象:
- RTV / DSV: 依赖现有 framebuffer，并缓存附件信息
- SRV: 仅保存纹理和格式信息，不立即分配纹理单元
- UAV: 分配纹理单元，并立刻绑定 image texture
- CBV: 分配 uniform buffer binding point
- VB / IB: 只保存 buffer、偏移、步长和格式
这种设计的好处是跨后端接口统一，代价是 GetNativeHandle() 的真实含义会随着 ResourceViewType 改变。
生命周期
- 构造时对象为空，但默认
m_viewType会被初始化成RenderTarget。 - 调用某个
InitializeAs...方法后进入对应视图模式。 - Shutdown 会释放它占用的 texture unit 或 binding point，并清空缓存元数据。
- 析构时自动调用
Shutdown()。
线程语义
- 当前实现没有锁。
- 由于涉及 OpenGL 资源和绑定点分配器，应视为依赖渲染线程 / OpenGL 上下文的对象，不适合跨线程并发读写。
当前实现的真实行为
- RTV / DSV 不创建独立 OpenGL view object，而是引用已有
OpenGLFramebuffer并缓存FramebufferAttachment。 - SRV 当前只是只读纹理视图元数据，不会立即占用 texture unit。
- UAV 会直接调用
glBindImageTexture()，但当前绑定参数是硬编码的GL_RGBA8 + mip0 + layer0 + read_write。 - CBV 通过
OpenGLUniformBufferManager分配绑定点，但当前底层使用glBindBufferBase，不支持范围绑定。 - VB / IB 不创建额外对象，只把 buffer 信息缓存起来供命令列表消费。
OpenGLCommandList会真实使用这些信息:TransitionBarrier()通过 GetTextureResource 更新纹理状态SetRenderTargets()通过 framebuffer attachment 重新组装 FBOSetVertexBuffers()/SetIndexBuffer()读取偏移、步长和格式
为什么这样设计
这和商业引擎里常见的“跨后端统一资源视图层”是一致的思路:
- 上层系统可以统一讨论 SRV / UAV / RTV / DSV / CBV
- 底层后端各自用最接近自己的机制去实现
对使用者来说，重要的不是假设所有后端都拥有完全对称的 view 模型，而是清楚知道当前 OpenGL 后端真正落到了哪一层。这个页面就是为了把这种边界说清楚。
当前限制
GetNativeHandle()不是统一类型句柄。- SRV 不负责即时分配 texture unit。
- UAV 的 image 绑定参数是简化实现，不足以覆盖完整 typed / layered image view 需求。
- CBV 没有实现真正的 offset/size range 绑定。
- 构造后的默认
GetViewType()是RenderTarget，但对象并不有效。
关键方法
- InitializeAsRenderTarget
- InitializeAsShaderResource
- InitializeAsUnorderedAccess
- InitializeAsConstantBuffer
- IsValid
- Shutdown