Files
XCEngine/docs/api/XCEngine/Rendering/RenderSurface/SetSampleDesc.md

999 B

RenderSurface::SetSampleDesc

设置目标表面的采样数和采样质量。

void SetSampleDesc(uint32_t sampleCount, uint32_t sampleQuality = 0);

参数

  • sampleCount - 期望的采样数;传入 0 时会被归一化为 1
  • sampleQuality - 采样质量;仅当有效 sampleCount > 1 时才会被保留。

当前语义

  • 当前实现会把 sampleCount 归一化到至少 1
  • 当有效 sampleCount <= 1 时,内部会把 sampleQuality 强制置为 0
  • 该描述会被一些 pipeline 构建路径读取,用于让图形 pipeline 与目标 surface 的 MSAA 配置保持一致。

当前实现边界

  • 这不会自动创建 MSAA 附件,也不会验证当前 color / depth attachment 是否真的匹配该采样描述。
  • 该接口只描述目标 surface 的采样元数据,不涉及 resolve 行为。

相关文档