cnc_wams/web-rtcp-5axis-sim-plan/docs/linuxcnc-gui-reference-gallery.md

LinuxCNC 原始界面参考图册

生成时间：2026-06-20 CST

1. 目的

本图册收集 LinuxCNC 源码树自带的实际界面截图，用于选择 Web 五轴数控系统仿真界面的视觉和布局方向。

图片来源：

linuxcnc/docs/src/gui/images/

已复制到本项目：

web-rtcp-5axis-sim-plan/assets/reference/linuxcnc-gui/

这些图片只作为界面参考，不代表 Web 项目会直接移植 LinuxCNC 原生 GUI runtime。

2. 优先参考图

2.1 QtVCP Vismach 5 Axis Gantry

原始文件：

linuxcnc/docs/src/gui/images/qtvismach_5axis_gantry.png

推荐用途：

• 五轴机床模型参考优先级最高。
• 可参考其 3D 机床视图、动态轴显示和仿真模型表达。
• 适合作为 Web 版 Three.js 五轴机床主视口的方向。

建议选择程度：高。

2.2 gmoccapy 5 Axis

原始文件：

linuxcnc/docs/src/gui/images/gmoccapy_5_axis.png

推荐用途：

• 操作员界面参考。
• 大按钮、DRO、运行控制、状态区、手动操作面板可以借鉴。
• 适合触控屏或工业操作台风格。

建议选择程度：高。

2.3 AXIS

原始文件：

linuxcnc/docs/src/gui/images/axis.png

推荐用途：

• 经典 LinuxCNC 操作布局参考。
• 菜单、工具栏、G-code、预览、DRO、状态栏结构清晰。
• 适合作为第一版 Web 五轴仿真工作台的主布局骨架。

建议选择程度：高。

2.4 AXIS + PyVCP

原始文件：

linuxcnc/docs/src/gui/images/axis-pyvcp.png

推荐用途：

• 右侧 PyVCP 面板参考。
• SWITCHKINS、joint value、offset/rot-point、RTCP 状态面板可以采用类似侧栏。
• 适合把五轴专用控件放在主预览旁边。

建议选择程度：高。

3. 现代操作屏参考

3.1 QtDragon

原始文件：

linuxcnc/docs/src/gui/images/qtdragon.png

推荐用途：

• 现代化大屏 CNC 操作界面参考。
• 面板区、状态区、按钮区和探测/刀具相关布局可借鉴。
• 如果目标是更接近工业触控屏，可参考此方向。

建议选择程度：中高。

3.2 QtDragon HD

原始文件：

linuxcnc/docs/src/gui/images/qtdragon_hd.png

推荐用途：

• 大屏布局参考。
• 适合后续做宽屏 Web 版操作台。

建议选择程度：中。

4. Vismach 机床仿真参考

4.1 Vismach

原始文件：

linuxcnc/docs/src/gui/images/vismach.png

推荐用途：

• Python vismach.py 原始机床仿真窗口参考。
• 可参考机床模型、坐标轴、视角控制和独立仿真窗口表达。

建议选择程度：中。

4.2 QtVismach

原始文件：

linuxcnc/docs/src/gui/images/qtvismach.png

推荐用途：

• QtVCP 嵌入式机床仿真面板参考。
• 适合思考 Three.js 视口如何嵌入主操作界面。

建议选择程度：中。

5. 推荐界面方案

用户已选择 gmoccapy_5_axis.png 作为目标界面风格。建议第一版 Web 五轴 RTCP 仿真界面以 gmoccapy 5 轴界面为主风格，再吸收 QtVismach 5 Axis Gantry 的机床模型表达和 PyVCP 的五轴状态控件。

主风格：gmoccapy_5_axis.png
3D 机床视口：QtVCP Vismach 5 Axis Gantry
五轴专用状态：PyVCP SWITCHKINS / joint values
经典布局参考：AXIS
后续大屏扩展：QtDragon / QtDragon HD

具体布局建议：

顶部：gmoccapy 风格标题栏 + machine/session/run state
左侧：黑底 Three.js 五轴机床和刀路预览
右上：大号绿色 DRO，显示 X/Y/Z/A/B/C、TCP、RTCP、DTG
中右：G-code 当前行列表和运行进度
右侧：竖向模式按钮栏，参考 gmoccapy 大按钮
中下：tool info / G-code properties / RTCP diagnostics tabs
下方：velocity、rapid/feed override、coolant、spindle 面板
底部：open、reload、run、stop、pause、step、home、fullscreen

6. 图片清单

assets/reference/linuxcnc-gui/qtvismach_5axis_gantry.png
assets/reference/linuxcnc-gui/gmoccapy_5_axis.png
assets/reference/linuxcnc-gui/axis.png
assets/reference/linuxcnc-gui/axis-pyvcp.png
assets/reference/linuxcnc-gui/qtdragon.png
assets/reference/linuxcnc-gui/qtdragon_hd.png
assets/reference/linuxcnc-gui/vismach.png
assets/reference/linuxcnc-gui/qtvismach.png

7. 选择建议

当前选择：

gmoccapy 5 Axis + QtVismach 5 Axis Gantry + PyVCP SWITCHKINS

如果后续需要更经典 LinuxCNC 桌面风格，可退回：

AXIS + PyVCP + QtVismach 5 Axis Gantry

如果后续需要更现代大屏触控风格，可扩展：

gmoccapy + QtDragon HD