9.3 三后端对比
前两节分别看了 Metal 与 D3D11,第 8 章看过 Vulkan,卷一也接触过 GL3Plus。把它们摆在一起,最能看出 OGRE「一个接口、多套实现」的代价与取舍。这节用四个可核对的点对比:getName 的名字、设备名从哪来、纹理单元数怎么报、以及最微妙的——固定功能(RSC_FIXED_FUNCTION)到底谁支持。
本章与站内既有内容的分工
helio 四卷的自研渲染器对比过 GL/Vulkan 两路后端;这里把 OGRE 的四个生产后端(Metal/D3D11/GL3Plus/Vulkan)的能力上报差异集中成一张表,重点讲 RenderSystemCapabilities 的编码机制,不与具体图形 API 的使用细节重复。
名字与设备名:各报各的
四个后端 getName 都返回静态字符串,作为 Root 的后端键:
| 后端 | getName() | 设备名来源 |
|---|---|---|
| Metal | "Metal Rendering Subsystem" | mActiveDevice->mDevice.name(MTLDevice 自带名字) |
| D3D11 | "Direct3D11 Rendering Subsystem" | mActiveD3DDriver.DriverDescription()(DXGI 驱动描述) |
| GL3Plus | "OpenGL 3+ Rendering Subsystem" | glGetString(GL_RENDERER) |
| Vulkan | "Vulkan Rendering Subsystem" | properties.deviceName(VkPhysicalDeviceProperties) |
设备名各走各的路,但都汇入同一个 setDeviceName。Vulkan 的写法最能体现「设备查询」的味道:
// RenderSystems/Vulkan/src/OgreVulkanRenderSystem.cpp:VulkanRenderSystem::getName 与能力开头(v14.6.3 源码摘录,已删减)
const String &VulkanRenderSystem::getName( void ) const
{
static String strName( "Vulkan Rendering Subsystem" );
return strName;
}
...
RenderSystemCapabilities *VulkanRenderSystem::createRenderSystemCapabilities( void ) const
{
RenderSystemCapabilities *rsc = new RenderSystemCapabilities();
rsc->setRenderSystemName( getName() );
// We would like to save the device properties for the device capabilities limits.
// These limits are needed for buffers' binding alignments.
VkPhysicalDeviceProperties *vkProperties =
const_cast<VkPhysicalDeviceProperties *>( &mActiveDevice->mDeviceProperties );
vkGetPhysicalDeviceProperties( mActiveDevice->mPhysicalDevice, vkProperties );
...
rsc->setDeviceName( properties.deviceName );
注意能力对象同时记系统名与设备名:系统名是软件标识(“Vulkan Rendering Subsystem”),设备名是硬件标识(“NVIDIA GeForce RTX 4070”)。
纹理单元数:常量、查询与 clamp
四个后端的差异体现到具体数字上:
// RenderSystems/GL3Plus/src/OgreGL3PlusRenderSystem.cpp:GL3PlusRenderSystem::createRenderSystemCapabilities(v14.6.3 源码摘录,已删减)
rsc->setRenderSystemName(getName());
rsc->setVendor(mVendor);
// Check for hardware mipmapping support.
rsc->setCapability(RSC_AUTOMIPMAP_COMPRESSED);
// Multitexturing support and set number of texture units
GLint units;
OGRE_CHECK_GL_ERROR(glGetIntegerv(GL_MAX_TEXTURE_IMAGE_UNITS, &units));
rsc->setNumTextureUnits(std::min(OGRE_MAX_TEXTURE_LAYERS, units));
| 后端 | 纹理单元数上报 |
|---|---|
| Metal | 固定 16(setNumTextureUnits(16)) |
| D3D11 | 固定 OGRE_MAX_TEXTURE_LAYERS |
| GL3Plus | glGetIntegerv(GL_MAX_TEXTURE_IMAGE_UNITS) 后 std::min(OGRE_MAX_TEXTURE_LAYERS, 查询值) |
| Vulkan | 固定 VULKAN_MAX_TEXTURE_UNITS(宏展开为 16) |
GL3Plus 的 clamp 最讲究:驱动报 32 也要压回 OGRE_MAX_TEXTURE_LAYERS,因为上层纹理单元数组按这个常量开大小。
RSC_FIXED_FUNCTION:谁在支持
这是对比里最有信息量的一点。OgreRenderSystemCapabilities.h 里固定功能的能力位定义在 CAPS_CATEGORY_COMMON_2 类别:
// OgreMain/include/OgreRenderSystemCapabilities.h:RSC_FIXED_FUNCTION 定义(v14.6.3 源码摘录,已删减)
// NOTE: Although 4 bits (currently) are enough
#define CAPS_CATEGORY_SIZE 4
#define OGRE_CAPS_BITSHIFT (32 - CAPS_CATEGORY_SIZE)
#define CAPS_CATEGORY_MASK (((1 << CAPS_CATEGORY_SIZE) - 1) << OGRE_CAPS_BITSHIFT)
#define OGRE_CAPS_VALUE(cat, val) ((cat << OGRE_CAPS_BITSHIFT) | (1 << val))
...
/// Supports fixed-function pipeline
RSC_FIXED_FUNCTION = OGRE_CAPS_VALUE(CAPS_CATEGORY_COMMON_2, 9),
能力值是 (类别 << 28) | (1 << 序号):高 4 位是类别(COMMON/COMMON_2/D3D9/GL/COMMON_3),低 28 位是位图。RenderSystemCapabilities 内部按类别存 int mCapabilities[CAPS_CATEGORY_COUNT],setCapability/hasCapability 先解出类别再操作对应槽位。
四个后端对固定功能的态度:
// RenderSystems/Metal/src/OgreMetalRenderSystem.mm:MetalRenderSystem::createRenderSystemCapabilities(v14.6.3 源码摘录)
rsc->addShaderProfile( "metal" );
rsc->setCapability(RSC_FIXED_FUNCTION); // FIXME: hack to get past RTSS
// RenderSystems/Direct3D11/src/OgreD3D11RenderSystem.cpp:D3D11RenderSystem::createRenderSystemCapabilities(v14.6.3 源码摘录)
// Does NOT support fixed-function!
//rsc->setCapability(RSC_FIXED_FUNCTION);
| 后端 | RSC_FIXED_FUNCTION | 实际含义 |
|---|---|---|
| Metal | 设(// FIXME: hack to get past RTSS) | 用默认 Metal 着色器模拟固定功能 |
| D3D11 | 注释掉,不设 | 纯可编程管线,上层走降级路径 |
| GL3Plus | 不设 | 没有固定功能阶段 |
| Vulkan | 不设 | 没有固定功能阶段 |
FIXME: hack to get past RTSS 值得单独解释:RTSS(实时着色器系统)需要 RSC_FIXED_FUNCTION 才走内置的固定功能模拟路径;Metal 后端用默认着色器顶替了这一条,于是声明「我支持固定功能」来满足 RTSS 的分支判断——这是一种兼容性 hack,不是真正的固定功能管线。
用同一份绘制输入比较不同后端
比较每个后端实际接收的布局、索引、Pass、纹理和深度约定。API 是否存在、构建是否启用、设备是否支持、样例是否跑通应分别记录。
以 Tiny 的逻辑结果作为通用基线。验证 Metal、D3D11 等后端时使用对应着色器和目标能力,并记录颜色空间、深度范围及实际命令。
源码定位
OgreMain/include/OgreRenderSystemCapabilities.h:OGRE_CAPS_VALUE宏(45-49)、CapabilitiesCategory(61-70)、RSC_FIXED_FUNCTION(156-157)、mCapabilities[CAPS_CATEGORY_COUNT](285)RenderSystems/Metal/src/OgreMetalRenderSystem.mm:getName(110-114)、createRenderSystemCapabilities含 FIXME hack(121-247)RenderSystems/Direct3D11/src/OgreD3D11RenderSystem.cpp:getName(216-220)、createRenderSystemCapabilities注释掉固定功能(781-789)RenderSystems/GL3Plus/src/OgreGL3PlusRenderSystem.cpp:getName(174-178)、createRenderSystemCapabilitiesclamp 纹理单元(213-235)RenderSystems/Vulkan/src/OgreVulkanRenderSystem.cpp:getName(319-323)、createRenderSystemCapabilities设备名(420-548)
上游引用固定到 OGRE v14.6.3 源码 。
可运行产物:C++ 最小验证
下面用纯 C++ 复现 OGRE_CAPS_VALUE 编码与四个后端的差异。它与 src/09-3-backend-comparison.cpp 逐字节一致:
// file: src/09-3-backend-comparison.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/09-3-backend-comparison.cpp -o bin/09-3-backend-comparison && ./bin/09-3-backend-comparison
//
// 复现四个后端的 getName 与能力上报差异(对应 OgreMain/include/OgreRenderSystemCapabilities.h
// 45-70、157 与 Metal/D3D11/GL3Plus/Vulkan 各自 RenderSystem.cpp):
// OGRE_CAPS_VALUE 把类别编入高 4 位,能力位存入低 28 位;
// Metal 设 RSC_FIXED_FUNCTION(OgreMetalRenderSystem.mm 247 FIXME hack);
// D3D11/GL3Plus/Vulkan 均不设 RSC_FIXED_FUNCTION;
// D3D11 纹理单元 = OGRE_MAX_TEXTURE_LAYERS,GL3Plus 取 min(OGRE_MAX_TEXTURE_LAYERS, 查询值)。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"
#include <algorithm>
#include <cstdint>
#include <string>
namespace ogre_repro {
constexpr uint32_t CAPS_CATEGORY_SIZE = 4;
constexpr uint32_t OGRE_CAPS_BITSHIFT = 32 - CAPS_CATEGORY_SIZE;
constexpr uint32_t CAPS_CATEGORY_MASK = 0x0Fu << OGRE_CAPS_BITSHIFT;
constexpr uint32_t OGRE_CAPS_VALUE(uint32_t cat, uint32_t val) {
return (cat << OGRE_CAPS_BITSHIFT) | (1u << val);
}
// 对应 CapabilitiesCategory 枚举(OgreRenderSystemCapabilities.h 61-70)
enum CapabilitiesCategory : uint32_t {
CAPS_CATEGORY_COMMON = 0,
CAPS_CATEGORY_COMMON_2 = 1,
CAPS_CATEGORY_D3D9 = 2,
CAPS_CATEGORY_GL = 3,
CAPS_CATEGORY_COMMON_3 = 4,
CAPS_CATEGORY_COUNT = 5,
};
// 对应 RSC_* 能力值(按真实宏展开)
constexpr uint32_t RSC_DEPTH_CLAMP = OGRE_CAPS_VALUE(CAPS_CATEGORY_COMMON, 3);
constexpr uint32_t RSC_ANISOTROPY = OGRE_CAPS_VALUE(CAPS_CATEGORY_COMMON, 2);
constexpr uint32_t RSC_HWSTENCIL = OGRE_CAPS_VALUE(CAPS_CATEGORY_COMMON, 5);
constexpr uint32_t RSC_32BIT_INDEX = OGRE_CAPS_VALUE(CAPS_CATEGORY_COMMON, 8);
constexpr uint32_t RSC_TWO_SIDED_STENCIL = OGRE_CAPS_VALUE(CAPS_CATEGORY_COMMON, 12);
constexpr uint32_t RSC_TEXTURE_COMPRESSION = OGRE_CAPS_VALUE(CAPS_CATEGORY_COMMON_2, 0);
constexpr uint32_t RSC_FIXED_FUNCTION = OGRE_CAPS_VALUE(CAPS_CATEGORY_COMMON_2, 9);
constexpr uint32_t RSC_UNIFORM_BUFFERS = OGRE_CAPS_VALUE(CAPS_CATEGORY_COMMON_2, 19);
constexpr uint16_t OGRE_MAX_TEXTURE_LAYERS = 16;
constexpr uint16_t VULKAN_MAX_TEXTURE_UNITS = 16;
// 对应 RenderSystemCapabilities:mCapabilities[CAPS_CATEGORY_COUNT] 按类存储
class RenderSystemCapabilities {
public:
void setCapability(uint32_t cap) {
const uint32_t cat = (cap & CAPS_CATEGORY_MASK) >> OGRE_CAPS_BITSHIFT;
mCapabilities[cat] |= (cap & ~CAPS_CATEGORY_MASK);
}
bool hasCapability(uint32_t cap) const {
const uint32_t cat = (cap & CAPS_CATEGORY_MASK) >> OGRE_CAPS_BITSHIFT;
return (mCapabilities[cat] & (cap & ~CAPS_CATEGORY_MASK)) != 0u;
}
void setNumTextureUnits(uint16_t n) { mNumTextureUnits = n; }
uint16_t getNumTextureUnits() const { return mNumTextureUnits; }
void setDeviceName(const std::string& n) { mDeviceName = n; }
const std::string& getDeviceName() const { return mDeviceName; }
void setRenderSystemName(const std::string& n) { mRenderSystemName = n; }
private:
uint32_t mCapabilities[CAPS_CATEGORY_COUNT] = {};
uint16_t mNumTextureUnits = 0;
std::string mDeviceName;
std::string mRenderSystemName;
};
class RenderSystem {
public:
virtual ~RenderSystem() = default;
virtual const std::string& getName() const = 0;
virtual RenderSystemCapabilities createRenderSystemCapabilities() const = 0;
};
// Metal:设 RSC_FIXED_FUNCTION(OgreMetalRenderSystem.mm 247)
class MetalRenderSystem : public RenderSystem {
public:
const std::string& getName() const override {
static const std::string n("Metal Rendering Subsystem");
return n;
}
RenderSystemCapabilities createRenderSystemCapabilities() const override {
RenderSystemCapabilities rsc;
rsc.setRenderSystemName(getName());
rsc.setDeviceName("Apple M1"); // mActiveDevice->mDevice.name
rsc.setNumTextureUnits(16);
rsc.setCapability(RSC_HWSTENCIL);
rsc.setCapability(RSC_ANISOTROPY);
rsc.setCapability(RSC_FIXED_FUNCTION); // FIXME: hack to get past RTSS
return rsc;
}
};
// D3D11:显式不设 RSC_FIXED_FUNCTION(OgreD3D11RenderSystem.cpp 788-789)
class D3D11RenderSystem : public RenderSystem {
public:
const std::string& getName() const override {
static const std::string n("Direct3D11 Rendering Subsystem");
return n;
}
RenderSystemCapabilities createRenderSystemCapabilities() const override {
RenderSystemCapabilities rsc;
rsc.setRenderSystemName(getName());
rsc.setDeviceName("NVIDIA GeForce RTX 4080"); // mActiveD3DDriver.DriverDescription()
rsc.setNumTextureUnits(OGRE_MAX_TEXTURE_LAYERS);
rsc.setCapability(RSC_HWSTENCIL);
rsc.setCapability(RSC_ANISOTROPY);
rsc.setCapability(RSC_32BIT_INDEX);
rsc.setCapability(RSC_UNIFORM_BUFFERS);
return rsc;
}
};
// GL3Plus:按 glGetIntegerv 查询后 clamp 到 OGRE_MAX_TEXTURE_LAYERS,不设固定功能
class GL3PlusRenderSystem : public RenderSystem {
public:
const std::string& getName() const override {
static const std::string n("OpenGL 3+ Rendering Subsystem");
return n;
}
static uint16_t clampTextureUnits(uint16_t queried) {
return std::min(OGRE_MAX_TEXTURE_LAYERS, queried); // OgreGL3PlusRenderSystem.cpp 235
}
RenderSystemCapabilities createRenderSystemCapabilities() const override {
RenderSystemCapabilities rsc;
rsc.setRenderSystemName(getName());
rsc.setDeviceName("AMD Radeon Pro 5700X"); // glGetString(GL_RENDERER)
rsc.setNumTextureUnits(clampTextureUnits(32)); // GL_MAX_TEXTURE_IMAGE_UNITS=32
rsc.setCapability(RSC_HWSTENCIL);
rsc.setCapability(RSC_TWO_SIDED_STENCIL);
rsc.setCapability(RSC_ANISOTROPY);
rsc.setCapability(RSC_32BIT_INDEX);
rsc.setCapability(RSC_UNIFORM_BUFFERS);
return rsc;
}
};
// Vulkan:设备名取 VkPhysicalDeviceProperties.deviceName;不设固定功能、不设 HWSTENCIL
class VulkanRenderSystem : public RenderSystem {
public:
const std::string& getName() const override {
static const std::string n("Vulkan Rendering Subsystem");
return n;
}
RenderSystemCapabilities createRenderSystemCapabilities() const override {
RenderSystemCapabilities rsc;
rsc.setRenderSystemName(getName());
rsc.setDeviceName("NVIDIA GeForce RTX 4070"); // properties.deviceName
rsc.setNumTextureUnits(VULKAN_MAX_TEXTURE_UNITS);
rsc.setCapability(RSC_TEXTURE_COMPRESSION);
rsc.setCapability(RSC_32BIT_INDEX);
rsc.setCapability(RSC_TWO_SIDED_STENCIL);
rsc.setCapability(RSC_DEPTH_CLAMP);
return rsc;
}
};
} // namespace ogre_repro
int main() {
using namespace ogre_repro;
// 四个后端各报自己的名字
MetalRenderSystem metal;
D3D11RenderSystem d3d11;
GL3PlusRenderSystem gl3;
VulkanRenderSystem vulkan;
CHECK(metal.getName() == "Metal Rendering Subsystem");
CHECK(d3d11.getName() == "Direct3D11 Rendering Subsystem");
CHECK(gl3.getName() == "OpenGL 3+ Rendering Subsystem");
CHECK(vulkan.getName() == "Vulkan Rendering Subsystem");
// 固定功能支持差异:只有 Metal 设了 RSC_FIXED_FUNCTION
RenderSystemCapabilities metalCaps = metal.createRenderSystemCapabilities();
CHECK(metalCaps.getDeviceName() == "Apple M1");
CHECK(metalCaps.hasCapability(RSC_FIXED_FUNCTION));
CHECK(!d3d11.createRenderSystemCapabilities().hasCapability(RSC_FIXED_FUNCTION));
CHECK(!gl3.createRenderSystemCapabilities().hasCapability(RSC_FIXED_FUNCTION));
CHECK(!vulkan.createRenderSystemCapabilities().hasCapability(RSC_FIXED_FUNCTION));
// 纹理单元数:D3D11 直接用常量,GL3Plus 查询后 clamp
CHECK(metalCaps.getNumTextureUnits() == 16);
CHECK(d3d11.createRenderSystemCapabilities().getNumTextureUnits() == OGRE_MAX_TEXTURE_LAYERS);
CHECK(gl3.createRenderSystemCapabilities().getNumTextureUnits() == 16); // min(16, 32)
CHECK(GL3PlusRenderSystem::clampTextureUnits(8) == 8);
CHECK(vulkan.createRenderSystemCapabilities().getNumTextureUnits() == VULKAN_MAX_TEXTURE_UNITS);
// 常见能力位差异:HWSTENCIL 只有 Vulkan 未设(源码注释掉)
CHECK(metalCaps.hasCapability(RSC_HWSTENCIL));
CHECK(d3d11.createRenderSystemCapabilities().hasCapability(RSC_HWSTENCIL));
CHECK(gl3.createRenderSystemCapabilities().hasCapability(RSC_HWSTENCIL));
CHECK(!vulkan.createRenderSystemCapabilities().hasCapability(RSC_HWSTENCIL));
// 各后端现代能力:D3D11 UNIFORM_BUFFERS、GL3Plus ANISOTROPY、Vulkan 32BIT_INDEX
CHECK(d3d11.createRenderSystemCapabilities().hasCapability(RSC_UNIFORM_BUFFERS));
CHECK(gl3.createRenderSystemCapabilities().hasCapability(RSC_ANISOTROPY));
CHECK(vulkan.createRenderSystemCapabilities().hasCapability(RSC_32BIT_INDEX));
// 编码验证:能力值的类别高 4 位正确
CHECK(((RSC_FIXED_FUNCTION & CAPS_CATEGORY_MASK) >> OGRE_CAPS_BITSHIFT) == CAPS_CATEGORY_COMMON_2);
CHECK(((RSC_HWSTENCIL & CAPS_CATEGORY_MASK) >> OGRE_CAPS_BITSHIFT) == CAPS_CATEGORY_COMMON);
return lab::report("09-3 三后端对比");
}
本机实测(Apple clang 16,clang++ -std=c++20 -Wall -I.):编译零警告,断言 23/23 通过。
小结
- 四个后端的
getName()各不相同,作为Root的后端键;设备名来源也各走各的路。 - 纹理单元数:Metal/D3D11/Vulkan 用常量(16),GL3Plus 查
GL_MAX_TEXTURE_IMAGE_UNITS后 clamp 到OGRE_MAX_TEXTURE_LAYERS。 OGRE_CAPS_VALUE(cat, val)把类别编入高 4 位、能力位放低 28 位;mCapabilities[CAPS_CATEGORY_COUNT]按类存储。RSC_FIXED_FUNCTION只有 Metal 声明(FIXME: hack to get past RTSS);D3D11 显式注释、GL3Plus 与 Vulkan 不设。- 能力表是幂等位集合:
setCapability只或运算,不覆盖已有位。
阅读导航:上一节:9.2 D3D11 渲染系统 · 下一节:10.1 纹理单元状态 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。