《OGRE 3D 渲染引擎原理与架构》9.3 三后端对比

Metal、D3D11、GL3Plus、Vulkan 四个后端在 getName、设备名来源、纹理单元数与 RSC_FIXED_FUNCTION 支持上差异明显:只有 Metal 以 FIXME hack 方式声明固定功能,D3D11 显式排除,GL3Plus 与 Vulkan 不声明。lab 用纯 C++ 复现 OGRE_CAPS_VALUE 编码与四后端能力表。

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
GL3PlusglGetIntegerv(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 等后端时使用对应着色器和目标能力,并记录颜色空间、深度范围及实际命令。

源码定位

上游引用固定到 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 纹理单元状态 。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图