平台与后端支持
TGFX（Tencent Graphics）是一个面向现代 GPU 设计的轻量级 2D 图形库，在 Android、iOS、macOS、Web、Linux、Windows 和 HarmonyOS 等主流平台上提供高性能的文字、图片和矢量图形渲染能力。
支持的平台
| 平台 | 最低版本 | 构建工具 |
|---|---|---|
| macOS | 10.15+ | Xcode 11.0+ |
| iOS | 9.0+ | Xcode 11.0+ |
| Android | 5.0+ | NDK 20+（推荐 20.1.5948944） |
| Windows | 7.0+ | Visual Studio 2019+ |
| Linux | — | GCC 9.0+ |
| Web（Chrome） | 69.0+ | Emscripten 3.1.58+ |
| Web（Safari） | 15.0+ | Emscripten 3.1.58+ |
| HarmonyOS | 5.0+ | DevEco IDE |
GPU 渲染后端
| 后端 | 版本要求 | 状态 |
|---|---|---|
| OpenGL | 3.2+（Desktop） | ✅ 可用 |
| OpenGL ES | 3.0+ | ✅ 可用 |
| WebGL | 2.0+ | ✅ 可用 |
| Metal | 1.1+ | 🔧 开发中 |
| Vulkan | 1.1+ | 🔧 开发中 |
| Direct3D 12 | 12.0+ | 🗓 计划中 |
| WebGPU | — | 🔧 开发中 |
平台与后端对应关系
下表列出了每个平台的默认 GPU 后端及可选后端。所有平台默认启用 OpenGL 系列后端（TGFX_USE_OPENGL=ON）。
| 平台 | 默认后端 | 可选后端 |
|---|---|---|
| macOS | OpenGL（CGL） | Metal / Qt |
| iOS | OpenGL ES（EAGL） | Metal |
| Android | OpenGL ES（EGL） | Vulkan |
| Windows | OpenGL（WGL） | ANGLE / Qt / Direct3D 12（计划中） |
| Linux | OpenGL ES（EGL） | SwiftShader |
| Web | WebGL | WebGPU（开发中） |
| HarmonyOS | OpenGL ES（EGL） | — |
[!NOTE] Metal 和 OpenGL 后端互斥——启用
TGFX_USE_METAL=ON时会自动禁用 OpenGL 相关选项。