# GraphicsEngine **Repository Path**: sttplay/GraphicsEngine ## Basic Information - **Project Name**: GraphicsEngine - **Description**: No description available - **Primary Language**: C++ - **License**: LGPL-2.1 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-01-20 - **Last Updated**: 2026-11-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # GraphicsEngine FrameArc 可通过 `--http-port PORT` 启用 HTTP API 和网页控制台,支持窗口和离屏模式。 本机打开 `http://127.0.0.1:PORT/`,局域网其他设备打开 `http://电脑IP:PORT/`,端口 80 可省略端口号。 深色控制台可查看状态、控制推流/录制和查看最长边 480 像素的舞台快照。 预览帧率可在网页选择 25、15、5、1 FPS,默认 1 FPS;按目标帧率扣除取图耗时调度,同一页面最多一个取图请求在途,实际帧率受取图耗时影响。暂停或页面隐藏时停止请求,后端无请求时不生成预览图。 参数、接口及调用示例见 [FrameArc HTTP API](docs/framearc-http-api.md)。 依赖库的当前版本、Windows x64/x86 四 CRT 编译与放置、静态/动态选择、FFmpeg 历史弃用登记及 macOS 迁移准备,统一见 [依赖库构建与放置](docs/DEPENDENCIES-BUILD-AND-LAYOUT.md)。 源码已经按职责拆成三个可独立配置、构建和打开的 CMake 项目: | 配置 | 内容 | 生成的解决方案 | | --- | --- | --- | | `GraphicsCore` | `vkcore`、`xrenderer`、`xlog` 及内部依赖 | `GraphicsCore.sln` | | `GraphicsCoreMini` | 引入 `GraphicsCore`,并生成 `libgraphics` 和控制台 `testapi` | `GraphicsCoreMini.sln` | | `GraphicsEngine` | 引入 `GraphicsCore`,并生成媒体库、FrameArc 和测试项目;不包含 `GraphicsCoreMini` | `GraphicsEngine.sln` | 目录边界如下: ```text GraphicsCore/ vkcore、xrenderer、xlog 和 Core 内部依赖 GraphicsCoreMini/ libgraphics 和公开接口控制台测试 GraphicsEngine/ 媒体库、FrameArc、测试、测试资源和 Android 工程 libraries/gres/ 可独立引入的通用资源编译模块 ``` 仓库根目录的 `CMakeLists.txt` 继续保留 `GRAPHICS_PROJECT` 兼容入口;日常开发建议直接使用下面三个真实源码入口。 通用资源模块 [`gres`](libraries/gres/README.md) 支持通过 `add_subdirectory()` 一次引入, 再为各程序分别定义资源包。FrameArc 的 UI 图标、`GWMSansUI-Regular.ttf` 和 `arial.ttf` 由 `framearc.grc` 清单编译进程序,界面直接从内存加载字体,启动及界面文字无需外部资源目录。 视频字幕的字体文件仍按原规则随程序部署。 ## Windows 生成 下面使用本机的 `windows-deps-x86_64` 路径生成三个互不干扰的构建目录: ```powershell $deps = (Resolve-Path "deps/windows-deps-x86_64").Path $vulkanSdk = $env:VULKAN_SDK cmake -S GraphicsCore -B build/graphics-core -G "Visual Studio 16 2019" -A x64 ` -DDEPS_DIR="$deps" -DVULKAN_SDK_DIR="$vulkanSdk" cmake -S GraphicsCoreMini -B build/graphics-core-mini -G "Visual Studio 16 2019" -A x64 ` -DDEPS_DIR="$deps" -DVULKAN_SDK_DIR="$vulkanSdk" cmake -S GraphicsEngine -B build/graphics-engine -G "Visual Studio 16 2019" -A x64 ` -DDEPS_DIR="$deps" -DVULKAN_SDK_DIR="$vulkanSdk" ``` 分别打开: - `build/graphics-core/GraphicsCore.sln` - `build/graphics-core-mini/GraphicsCoreMini.sln` - `build/graphics-engine/GraphicsEngine.sln` `GraphicsEngine` 在 Windows 下还会生成独立的 `GraphicsTaskManager`。它使用 xrenderer GUI 展示进程资源占用;性能页按设备展示 CPU、内存、磁盘、网卡和 GPU 的 最近 60 秒曲线,以及频率、温度、显存、驱动与系统资源等信息。支持名称/PID 筛选、数值列排序、 自动刷新以及带二次确认的结束任务操作。详细说明见 [`GraphicsEngine/TaskManager/README.md`](GraphicsEngine/TaskManager/README.md)。 使用 Visual Studio 2022 时,将生成器替换为 `Visual Studio 17 2022`。 新的 Windows 依赖使用 `MT/<包>`、`MTd/<包>`、`MD/<包>`、`MDd/<包>` 目录。 `DEPS_DIR` 传入这些 CRT 目录的共同父目录。`STATIC_CRT=ON`(默认)自动选择 Release 的 MT 和 Debug 的 MTd;设为 OFF 则选择 MD/MDd,同一个 VS 解决方案可以切换 Debug/Release。RelWithDebInfo、MinSizeRel 使用对应的 Release 依赖。 `BUILD_SHARED=ON`(默认)同时构建引擎动态库并链接第三方 DLL 导入库,按当前配置 复制所需 DLL;设为 OFF 则构建引擎静态库并链接各包的 `*-static.lib`。 由于 glslang 的 C++/STL 对象不适合跨 MT/MTd DLL 边界,静态 CRT 下的 glslang 始终使用静态库。 FFmpeg 使用包内的 CMake 配置,保留 libass/avfilter 字幕渲染;GLAD 使用编译库。 旧的平铺依赖目录仍走原有配置。 当前 `build_windows_x64` 可直接重新配置和编译 FrameArc: ```powershell cmake -S . -B build_windows_x64 -DGRAPHICS_PROJECT=GraphicsEngine ` -DDEPS_DIR="$deps" -DSTATIC_CRT=ON -DBUILD_SHARED=ON cmake --build build_windows_x64 --config Release --target FrameArc --parallel 2 -- /p:CL_MPCount=4 cmake --build build_windows_x64 --config Debug --target FrameArc --parallel 2 -- /p:CL_MPCount=4 ``` 产物位于 `build_windows_x64/bin/Release` 和 `bin/Debug`。 `BUILD_SHARED=ON` 时,引擎、媒体和第三方依赖的 DLL 均需要随程序部署。 MD/MDd 使用独立构建目录,采用相同的动态链接方式: ```powershell cmake -S . -B build_windows_x64/crt-check-md -G "Visual Studio 16 2019" -A x64 ` -DDEPS_DIR="$deps" -DVULKAN_SDK_DIR="$vulkanSdk" ` -DSTATIC_CRT=OFF -DBUILD_SHARED=ON ` -DENABLE_GLSLANG=ON -DENABLE_ASSIMP=ON cmake --build build_windows_x64/crt-check-md --config Release --target FrameArc --parallel 2 -- /p:CL_MPCount=4 cmake --build build_windows_x64/crt-check-md --config Debug --target FrameArc --parallel 2 -- /p:CL_MPCount=4 ``` 对应产物位于 `build_windows_x64/crt-check-md/bin/Release`(MD)和 `bin/Debug`(MDd)。 字体后端使用 FreeType + HarfBuzz,已替换 stb_truetype:FreeType 栅格化,HarfBuzz 整形, 复用现有字形图集与渲染接口。构建前需要准备这两个依赖包。 独立静态库构建、版本锁定及跨平台复编入口见 [`docs/TEXT-DEPENDENCIES-BUILD.md`](docs/TEXT-DEPENDENCIES-BUILD.md)。 ## SDK 安装边界 `GraphicsCore` 只导出 `GraphicsCore::xrenderer`,不依赖 Qt 或 SDL。日志接口来自 xtools 提供的独立目标 `xtools::xlog`;GraphicsCore 不再重复安装 `xlog/xlog.h` 或 xlog 库,使用安装包时需要让 CMake 能找到 xtools。日志创建扩展直接声明在 `xrenderer.h` 中,不新增或安装 `xrenderer_log.h`,也不安装 vkcore、GLM、volk、生成的 `vk_config.h` 或其他内部头文件。共享构建仍会安装运行所需的 `vkcore` 动态库。SDL 输入到 xrenderer 标准输入事件的转换属于 `GraphicsEngine`。 ```powershell cmake --build build/graphics-core --config Release cmake --install build/graphics-core --config Release --prefix build/sdk/GraphicsCore ``` 外部项目通过导出的 CMake 包使用核心库: ```cmake find_package(GraphicsCore CONFIG REQUIRED) target_link_libraries(app PRIVATE GraphicsCore::xrenderer) ``` `GraphicsCoreMini` 同时安装 `GraphicsCore` 和 `libgraphics`,其外部目标为 `GraphicsCoreMini::libgraphics`: ```cmake find_package(GraphicsCoreMini CONFIG REQUIRED) target_link_libraries(app PRIVATE GraphicsCoreMini::libgraphics) ```