English | 中文
TriangleBin 的多平台移植合集,用于测试 GPU 的填充率与着色顺序:
- Windows DirectX — Direct3D 11 / 12,x86 / x64 / ARM64,支持 Windows 7 及更新系统
- Windows Vulkan — Vulkan 1.0,x86 / x64 / ARM64,支持 Windows 7 及更新系统(需显卡驱动提供 Vulkan 支持)
- macOS Metal — Intel(macOS 10.15+)与 Apple Silicon(macOS 11.0+)通用版
- Android OpenGL ES — OpenGL ES 3.2(不支持时自动回退 3.1),单 APK 含四套 ABI,支持 Android 5.0 及更新系统
- Android Vulkan — Vulkan 1.0,单 APK 含四套 ABI,支持 Android 7.0 及更新系统
- HarmonyOS 源码包(自行签名) — 一套源码覆盖手机、平板、2in1、手表、车机、电视六类设备;Vulkan 1.0;内置 XEngine 1.5× 空间超分
HarmonyOS 版用同一套源码适配六类设备:手机 / 平板 / 2in1 共用桌面布局,手表支持表冠与触屏两种输入,车机 / 电视使用宽屏 Controls。
它绘制一叠互相重叠的三角形,并统计 GPU 实际光栅化了多少个片段。这个数量可以判断你的显卡是 IMR(立即模式渲染,每个三角形的每个覆盖像素都要着色)还是 TBR(分块渲染,几何按 tile 分桶,每个像素基本只着色一次)。
最新版本:v1.1.0
| 平台 | Release 文件 | 架构 |
|---|---|---|
| Windows DirectX | TriangleBin-Windows-DirectX-v1.1.0.exe | x86 / x64 / ARM64 |
| Windows Vulkan | TriangleBin-Windows-Vulkan-v1.1.0.exe | x86 / x64 / ARM64 |
| macOS Metal | TriangleBin-macOS-Metal-v1.1.0.zip | Universal(Intel / Apple Silicon) |
| Android OpenGL ES | TriangleBin-Android-OpenGLES-v1.1.0.apk | arm64-v8a / armeabi-v7a / x86 / x86_64 |
| Android Vulkan | TriangleBin-Android-Vulkan-v1.1.0.apk | arm64-v8a / armeabi-v7a / x86 / x86_64 |
| HarmonyOS 源码包(自行签名) | TriangleBin-HarmonyOS-Source-20261120.zip | DevEco Studio 工程(不含签名) |
HarmonyOS 源码包的
module.json声明phone、tablet、2in1、wearable、car、tv六类设备;构建产物为单个 HAP,同时含arm64-v8a与x86_64。
HarmonyOS 不提供预编译 HAP:开发调试签名会绑定已登记设备,不适合公开下载。请下载源码包,用 DevEco Studio 的“自动签名”为自己的设备签名后构建;面向所有用户公开发布时,请使用 AppGallery Connect 的 release 证书/Profile。
不确定下载哪个? Windows 用户直接选 DirectX 版即可:兼容性最好,会在 D3D12 与 D3D11 之间自动选择。需要做 Vulkan 对比测试时再使用 Vulkan 版。下载文件的 SHA-256 校验值见 Release 说明。
Windows 两个版本都是单文件启动器:一个 .exe 内含 x86 / x64 / ARM64 三份程序,启动时自动识别 CPU 并运行对应版本,退出后自动清理;无需安装,不写注册表。
macOS Metal 版解压后得到 TriangleBin.app,为 Intel 与 Apple Silicon 通用二进制。若首次打开被 Gatekeeper 拦截,请右键选择“打开”。
HarmonyOS 源码包构建出的 HAP 内同时含 arm64-v8a 与 x86_64;手表每次进入前台会先选择“有表冠 / 无表冠(触屏)”,车机与电视自动使用宽屏 Controls 布局。
| 版本 | 操作系统 | 图形 API | 备注 |
|---|---|---|---|
| Windows DirectX | Windows 7 及更新 | Direct3D 12 / 11(自动选择) | 着色器已内嵌,无需 d3dcompiler_47.dll 或 VC++ 运行库 |
| Windows Vulkan | Windows 7 及更新 | Vulkan 1.0 core + VK_KHR_swapchain |
需要显卡驱动提供 Vulkan loader |
| macOS Metal | macOS 10.15+(Intel)/ 11.0+(Apple Silicon) | Metal | 通用二进制 |
| Android OpenGL ES | Android 5.0+(API 21) | OpenGL ES 3.2 / 3.1(自动回退) | 单 APK 含 arm64-v8a / armeabi-v7a / x86 / x86_64;需要设备支持 ES 3.1 |
| Android Vulkan | Android 7.0+(API 24) | Vulkan 1.0+ | 单 APK 含 arm64-v8a / armeabi-v7a / x86 / x86_64 |
| HarmonyOS 源码包 | HarmonyOS 5.0+(API 12) | Vulkan 1.0 | 构建产物为单 HAP,声明 phone / tablet / 2in1 / wearable / car / tv 六类设备;手表支持表冠与触屏两种输入 |
自动选择图形 API。 Windows DirectX 版会优先创建 Direct3D 12 设备,失败则回退到 Direct3D 11 并在日志中说明。
一套源码,六类设备。 HarmonyOS 版用同一套源码声明 phone、tablet、2in1、wearable、car、tv 六类设备,构建产物是单个 HAP:手机 / 平板 / 2in1 使用桌面布局,车机 / 电视按屏幕尺寸切换到宽屏,手表使用圆形安全区面板。手表每次进入前台会先选择“有表冠”或“无表冠(触屏)”,分别走表冠旋转或 -/+ 按钮,两种模式都保留 ppf、Tris、Reset 与 Auto Increment。
XEngine 1.5× 空间超分。 HarmonyOS Vulkan 版加入 XEngine 空间超分:场景按每轴 2/3 的长度渲染,再由 XEG_spatial_upscale 扩展到原生分辨率,等效 1.5× 超分。设备支持时默认开启,Controls 内可随时切换;不支持时自动显示 unsupported 并保持关闭,不影响普通渲染路径。
选择 GPU(F2)。 Windows DirectX 与 Windows Vulkan 版均可在运行时选择显卡:DirectX 版列出所有硬件 DXGI 适配器及驱动版本,不支持 D3D12 的会标注 (D3D11 only);Vulkan 版列出 Vulkan 物理设备及驱动/Vulkan 版本。这在同时有核显和独显的笔记本上很有用——Windows 默认分配的那块不一定是你想测的那块。Auto (best GPU for this app) 保持默认行为。切换适配器需要重建设备,界面会对连续点击做 300 ms 防抖,合并成一次切换,并等待上一帧完成后才释放旧设备,避免偶发卡死。同一块物理显卡被驱动或虚拟显示适配器重复枚举时,选择列表会按 PCI 身份(VendorId / DeviceId / SubSysId / Revision)和驱动版本自动合并,只保留一项。
启动诊断报告。 启动遇到致命错误(例如找不到支持 DirectX 11 的设备)或发生未处理异常时,程序会在可执行文件旁边生成 trianglebin-error-report.txt,内含系统版本与内部版本号、CPU 架构、显卡名称、驱动版本、支持的最高 DirectX 特性级别,以及具体错误。排查启动闪退时把这个文件发出来就够了。
运行时数值标注。 原版通过 glGetString(...) 显示的几项信息,现在标注了对应的 DirectX 调用来源:DXGI GetDesc(适配器)、DXGI CheckInterfaceSupport(驱动版本)、D3D12CreateDevice / D3D11CreateDevice(所用设备)。Vulkan 版同样显示设备、驱动与 Vulkan 版本。
ARM64 支持。 x86、x64、ARM64 三个配置共用同一份源码。ARM64 采用静态链接 SDL2(deps/SDL2/lib/arm64/SDL2-static.lib),因为 MSVC 下无法链接 SDL2 的动态库;src/sdl2_atomic_shim.c 负责补齐缺失的 _Interlocked* 符号。
单文件启动器。 tools/launcher 会把 x64、x86、ARM64 三份程序作为资源嵌入同一个可执行文件,运行时释放与当前 CPU 匹配的那一份。发布时因此只需要一个 .exe,而不用为每个架构单独打包。
性能与显存。 DirectX 与 Vulkan 后端优先使用 D16_UNORM 深度缓冲(0–200 层三角形仍有足够精度,深度缓冲内存减半);D3D11 缓存每个后缓冲区的 RTV,并用动态常量缓冲与 GPU 端 UAV 清零更新每帧数据;D3D12 使用 ClearUnorderedAccessViewUint 清零片段计数器,省掉每帧两次资源屏障和一次 4 字节拷贝;D3D11 / D3D12 / Vulkan / Metal 在三角形数量不变时均跳过随机顶点缓冲的重复上传。
这是一个多平台移植合集,不是打补丁。核心思路、控制项和测量方式来自 Swung 0x48 的 TriangleBin(MIT);Windows DirectX 版源码位于本仓库,Windows Vulkan、macOS Metal、Android 两版以 Releases 成品提供;HarmonyOS 源码包也作为 Release 资产提供(Android 源码在独立的 Gradle + NDK 工程中维护;HarmonyOS 源码在独立的 DevEco Studio 工程中维护)。
| TriangleBin | TriangleBin-MultiPlatform(本仓库) | |
|---|---|---|
| 图形 API | OpenGL / OpenGL ES | Windows DirectX 11/12、Windows Vulkan 1.0、macOS Metal、Android OpenGL ES 3.1、Android Vulkan 1.0、HarmonyOS Vulkan 1.0 |
| 平台 | Android(APK,按 ABI 分包)+ Windows x64 | Windows:x86 / x64 / ARM64;macOS:Intel / Apple Silicon;Android:单 APK 四 ABI;HarmonyOS:源码包构建出的单 HAP 覆盖 phone / tablet / 2in1 / wearable / car / tv |
| 构建 | Gradle + Android NDK | CMake + MSVC(Windows DirectX 源码);Vulkan / macOS 以 Releases 成品提供;HarmonyOS 以 Releases 源码包提供(DevEco Studio + ArkTS/C++ 工程) |
| 选择 GPU | 无 | Windows DirectX / Vulkan 版支持运行时选择 GPU(F2) |
| 启动失败诊断 | 无 | Windows 启动失败时生成诊断报告;Android 版在图形上下文创建失败时打印原因并优雅退出,不闪退 |
| 空间超分 | 无 | HarmonyOS Vulkan 版支持 XEngine 1.5× 空间超分(XEG_spatial_upscale) |
Android 两个版本都是原版 Android 应用的源码级再构建(原版只提供 OpenGL ES 版,且要求 ES 3.2),界面、控件、着色器、Frag Count 计算方式完全一致,只做了下面这几处兼容性与性能改动:
| 项目 | 原版 TriangleBin(Android) | 本仓库 Android 版 |
|---|---|---|
| 渲染上下文 | 直接创建 OpenGL ES 3.2 上下文,设备只支持 3.1 时创建失败并崩溃退出 | 先试 ES 3.2,失败后记录 Could not create OpenGL ES 3.2 context, retrying 3.1 并改用 ES 3.1 重建;两者都失败时打印 Could not create required OpenGL ES 3.1 context. 后正常退出,不闪退 |
| 最低图形能力 | OpenGL ES 3.2 | OpenGL ES 3.1(着色器依赖 atomicCounterIncrement 与 std140 UniformBlock,ES 3.0 无法实现,因此 3.1 是硬底线) |
ppf 显示 |
格式串为 "%.1f%%",Android bionic 的 vsnprintf 把 %% 压成一个 %,界面数字错位 |
格式串改为 "%.1f",显示 1.0,与桌面版一致 |
| 应用名 / 包名 | Triangle Bin / com.socpk.trianglebin,GLES 与 Vulkan 版互相顶掉 |
Triangle Bin (GLES) / com.socpk.trianglebin.opengles,Triangle Bin (VK) / com.trianglebin.vulkan,两版可共存 |
| APK 拆分 | 按 ABI 分包 | 单 APK 内含 arm64-v8a / armeabi-v7a / x86 / x86_64 |
| 每帧开销 | 每帧 3 次 glGetString、1 次 glGetIntegerv(GL_VIEWPORT)、多次 glBufferData 重分配与 uniform 查询,release 下仍有最多 15 次 glGetError |
以上全部改为启动时缓存 / 一次分配 / 按需上传,glCheckError 在 NDEBUG 下编译为空 |
| Vulkan 后端 | 无(原版只有 OpenGL ES) | 新增 Vulkan 1.0 后端,Controls 面板与 GLES 版同结构,切后台自动重建 swapchain |
| 版本号 | — | 与其它三平台统一为 v1.1.0(versionCode 2) |
实测(本地 Android 12 x86_64 模拟器,10 秒 /proc/<pid>/stat 采样):GLES 版主循环 CPU 24.6% → 21.7%,APK 5,369,064 → 5,353,951 字节;Vulkan 版 11.5% → 11.3%(Vulkan 侧每帧本来只有约 1.8 ms)。两版都被 vsync 限制在 60 FPS,因此帧率数字看不出差别,收益体现在 CPU 占用与 GL/Vulkan 调用数上。
Android 版源码位于独立的 Android 工程(Gradle + NDK),与本仓库的 Windows DirectX 源码分开维护,成品通过 Releases 分发。
| Android OpenGL ES(PCT-AL10 / Kirin 980,100% + Tris 200) | Android Vulkan(PCT-AL10 / Mali-G76,100% + Tris 0) |
|---|---|
![]() |
![]() |
HarmonyOS 版把同一套 TriangleBin 逻辑移植到 ArkTS + C++/Vulkan,用一套源码覆盖六类设备,构建产物为单个 HAP:
| 设备类型 | 布局与输入 |
|---|---|
| phone / tablet / 2in1 | 与桌面版一致的 Controls 面板,按屏幕尺寸自适应 |
| wearable | 圆形安全区面板;每次进入前台先选择“有表冠”或“无表冠(触屏)”,分别使用表冠旋转或 -/+ 按钮调值 |
| car / tv | 按屏幕尺寸切换的宽屏 Controls,适合车机与电视的远距离操作 |
Vulkan 后端同时加入 XEngine 1.5× 空间超分:场景按每轴 2/3 的长度渲染,再由 XEG_spatial_upscale 扩展到原生分辨率。设备支持时默认开启,Controls 内可随时切换;不支持时自动回退到普通渲染。构建出的 HAP 内含 arm64-v8a 与 x86_64,module.json 声明 phone、tablet、2in1、wearable、car、tv 六类 deviceTypes,最低 HarmonyOS 5.0(API 12)。
HarmonyOS 版仅提供源码包,不提供预编译 HAP:开发调试签名会绑定已登记设备,无法覆盖公开用户。请使用源码包,用自己的开发者账号签名:
- 下载并解压
TriangleBin-HarmonyOS-Source-20261120.zip; - 用 DevEco Studio 5.0+ 打开工程,等待 ohpm / Hvigor Sync 完成;
- 连接设备,在
File > Project Structure > Signing Configs中勾选Automatically generate signature,登录华为账号; - 选择
Build > Build Hap(s),产物位于entry/build/default/outputs/default/entry-default-signed.hap; - 用
hdc install -r <hap>安装到设备。
源码包内 README.md 有完整步骤、包名冲突和 release 签名说明。面向所有用户公开发布时,请使用 AppGallery Connect 的 release 证书/Profile 签名。
| 控件 | 含义 |
|---|---|
Rendered/Screen % |
已渲染片段数 / 屏幕像素数,以百分比表示,范围 0–500。 |
0% / 100% |
直接跳到 0% 或 100%。 |
Tris |
随机三角形数量,0–200,不包含两个全屏三角形。 |
Auto Increment |
每帧自动增加 Rendered/Screen %。 |
ppf |
每帧增量:勾选 Auto Increment 后 Rendered/Screen % 每帧增加的数值,范围 0–10。 |
Frag Count |
本帧 GPU 实际光栅化的片段数,应当不超过目标值。 |
clear color |
背景色。 |
F2 |
打开 / 关闭选择 GPU 窗口(仅 Windows 版;Android 版没有多适配器选择,Controls 顶部直接显示当前设备与驱动/API 版本)。 |
XEngine 1.5× Upscale |
HarmonyOS Vulkan 版空间超分开关;设备支持时默认开启,不支持时显示 unsupported。 |
怎么看结果:提高 Tris,观察 Frag Count。如果它随三角形数量持续上升,说明每个三角形的覆盖像素都被着色,这是 IMR 的行为;如果它明显低于目标值并趋于平稳,说明几何被分桶、每个像素每 tile 只着色一次,这是 TBR 的行为。
Windows 提示“未知发布者”或 SmartScreen 拦截? 点击“更多信息 → 仍要运行”即可。程序没有购买代码签名证书。
为什么不需要安装 d3dcompiler_47.dll 或 VC++ 运行库?
Windows 版的着色器已在编译期嵌入,并使用静态 CRT。
Vulkan 版提示找不到 Vulkan 设备? 请安装或更新显卡驱动,确保驱动自带 Vulkan loader。虚拟机、远程桌面或部分旧驱动可能不提供 Vulkan 支持。
macOS 提示无法打开 TriangleBin.app?
右键点击应用选择“打开”;或在“系统设置 → 隐私与安全性”中允许运行。
Android 版应该下载哪一个? 兼容性优先选 OpenGL ES 版(Android 5.0+,几乎覆盖所有设备);需要做 Vulkan 对比测试时再用 Vulkan 版(Android 7.0+,需要设备支持 Vulkan 1.0)。两个 APK 包名不同,可以同时安装。
Android 版为什么需要 OpenGL ES 3.1?
着色器用 atomicCounterIncrement 统计片段数、用 std140 UniformBlock 传参数,这两项都是 ES 3.1 才有的;ES 3.0 设备会在启动时打印 Could not create required OpenGL ES 3.1 context. 后退出,这是预期行为。
Android 版启动后是黑屏?
默认 Rendered/Screen % 为 0%,画面就是黑的(与原版一致)。点 100% 按钮即可显示渐变;把 Tris 拖到 0 可看完整全屏渐变。
怎么确认当前用的是 D3D12 还是 D3D11?
Controls 窗口顶部会显示 D3D12CreateDevice (API): "Direct3D 12" 或对应的 Direct3D 11 信息。
环境要求:
- Windows 10 或 11
- Visual Studio 2022 或更高版本,需勾选 使用 C++ 的桌面开发 工作负载
- CMake 3.20 或更高版本(Visual Studio 自带的即可)
SDL2、Dear ImGui、GLM 已放在 deps/ 下,无需包管理器。
git clone https://github.com/ddYIbb/TriangleBin-MultiPlatform.git
cd TriangleBin-MultiPlatform
cmake -S . -B build-x64 -A x64
cmake --build build-x64 --config Release如果装了多个版本的 Visual Studio 而 CMake 选错了,可以显式指定生成器:
-G "Visual Studio 17 2022" 或 -G "Visual Studio 18 2026"。
产物为 build-x64/demo-dx.exe。运行前需要把 deps/SDL2/lib/x64/SDL2.dll 复制到它旁边。
其余架构只是换一下生成器平台和输出目录:
cmake -S . -B build-x86 -A Win32
cmake --build build-x86 --config Release
cmake -S . -B build-arm64 -A ARM64
cmake --build build-arm64 --config ReleaseARM64 静态链接 SDL2,因此不需要 SDL2.dll。
Android 两版不在本仓库构建:它们来自独立的 Gradle + NDK 工程(JDK 17、Gradle 7.6.4、Android SDK 31、NDK 27.0.12077973),GLES 版 minSdk 21、Vulkan 版 minSdk 24,两者的 ABI 均为 arm64-v8a / armeabi-v7a / x86 / x86_64。构建产物直接作为 Release 资产分发,本仓库只提供 README 与截图。
HarmonyOS 版不在本仓库构建:源码作为 Release 资产 TriangleBin-HarmonyOS-Source-20261120.zip 提供,是独立的 DevEco Studio 工程,使用 ArkTS 页面 + C++/Vulkan 渲染层,compatibleSdkVersion 为 5.0.0(12)。构建产物为单个 HAP,内含 arm64-v8a 与 x86_64,并声明 phone / tablet / 2in1 / wearable / car / tv 六类 deviceTypes。使用 DevEco Studio 的“自动签名”为自己的设备签名后即可构建,步骤见源码包内 README.md。
tools/launcher 会把上面三个可执行文件和两份 SDL2.dll 作为资源嵌入。请务必在三个架构都编译完成之后再配置它,因为资源编译器在构建时就要读取这些文件:
cmake -S tools/launcher -B tools/launcher/build -A Win32
cmake --build tools/launcher/build --config Release产物是 tools/launcher/build/demo-dx.exe,单文件、可直接分发。它刻意按 Win32(x86)编译,这样同一个文件能在所有 Windows 机器上运行:x86 和 x64 原生执行,ARM64 走系统内置的模拟层。
launcher.rc.in 是模板,配置阶段由 CMakeLists.txt 把各载荷的绝对路径填进去并生成 launcher.rc 到构建目录,仓库里不保存任何跟机器相关的路径。
src/ DirectX 11/12 渲染器、主程序与 SDL2 兼容层
tools/launcher/ 单文件启动器(嵌入 x86 / x64 / ARM64 载荷)
deps/ SDL2、Dear ImGui、GLM
docs/ README 截图(Windows / Android)
CMakeLists.txt 顶层构建配置
| 组件 | 版本 | 许可证 |
|---|---|---|
| SDL2 | 2.30.11 | zlib |
| Dear ImGui | — | MIT |
| GLM | — | MIT |
MIT,详见 LICENSE。
本项目基于 Swung 0x48 的 TriangleBin(MIT 许可)修改而来,原作者的版权声明保留在 LICENSE 中。
遇到问题或有建议,欢迎提交 Issue。


