wangdequan
626bcfe8e3
结论：完成 LinuxCNC kinematics WASM ABI 覆盖，并将 web-rtcp-5axis-sim-plan 的 RTCP frame/boundary adapter 接到 xyzac-trt kinematics SDK；Node、build、browser smoke 验证通过。
227 lines
5.0 KiB
Markdown
227 lines
5.0 KiB
Markdown
# LinuxCNC 原始界面参考图册
|
||
|
||
生成时间：2026-06-20 CST
|
||
|
||
## 1. 目的
|
||
|
||
本图册收集 LinuxCNC 源码树自带的实际界面截图，用于选择 Web 五轴数控系统仿真界面的视觉和布局方向。
|
||
|
||
图片来源：
|
||
|
||
```text
|
||
linuxcnc/docs/src/gui/images/
|
||
```
|
||
|
||
已复制到本项目：
|
||
|
||
```text
|
||
web-rtcp-5axis-sim-plan/assets/reference/linuxcnc-gui/
|
||
```
|
||
|
||
这些图片只作为界面参考，不代表 Web 项目会直接移植 LinuxCNC 原生 GUI runtime。
|
||
|
||
## 2. 优先参考图
|
||
|
||
### 2.1 QtVCP Vismach 5 Axis Gantry
|
||
|
||
|
||
|
||
原始文件：
|
||
|
||
```text
|
||
linuxcnc/docs/src/gui/images/qtvismach_5axis_gantry.png
|
||
```
|
||
|
||
推荐用途：
|
||
|
||
- 五轴机床模型参考优先级最高。
|
||
- 可参考其 3D 机床视图、动态轴显示和仿真模型表达。
|
||
- 适合作为 Web 版 Three.js 五轴机床主视口的方向。
|
||
|
||
建议选择程度：高。
|
||
|
||
### 2.2 gmoccapy 5 Axis
|
||
|
||
|
||
|
||
原始文件：
|
||
|
||
```text
|
||
linuxcnc/docs/src/gui/images/gmoccapy_5_axis.png
|
||
```
|
||
|
||
推荐用途：
|
||
|
||
- 操作员界面参考。
|
||
- 大按钮、DRO、运行控制、状态区、手动操作面板可以借鉴。
|
||
- 适合触控屏或工业操作台风格。
|
||
|
||
建议选择程度：高。
|
||
|
||
### 2.3 AXIS
|
||
|
||
|
||
|
||
原始文件：
|
||
|
||
```text
|
||
linuxcnc/docs/src/gui/images/axis.png
|
||
```
|
||
|
||
推荐用途：
|
||
|
||
- 经典 LinuxCNC 操作布局参考。
|
||
- 菜单、工具栏、G-code、预览、DRO、状态栏结构清晰。
|
||
- 适合作为第一版 Web 五轴仿真工作台的主布局骨架。
|
||
|
||
建议选择程度：高。
|
||
|
||
### 2.4 AXIS + PyVCP
|
||
|
||
|
||
|
||
原始文件：
|
||
|
||
```text
|
||
linuxcnc/docs/src/gui/images/axis-pyvcp.png
|
||
```
|
||
|
||
推荐用途：
|
||
|
||
- 右侧 PyVCP 面板参考。
|
||
- `SWITCHKINS`、joint value、offset/rot-point、RTCP 状态面板可以采用类似侧栏。
|
||
- 适合把五轴专用控件放在主预览旁边。
|
||
|
||
建议选择程度：高。
|
||
|
||
## 3. 现代操作屏参考
|
||
|
||
### 3.1 QtDragon
|
||
|
||
|
||
|
||
原始文件：
|
||
|
||
```text
|
||
linuxcnc/docs/src/gui/images/qtdragon.png
|
||
```
|
||
|
||
推荐用途：
|
||
|
||
- 现代化大屏 CNC 操作界面参考。
|
||
- 面板区、状态区、按钮区和探测/刀具相关布局可借鉴。
|
||
- 如果目标是更接近工业触控屏，可参考此方向。
|
||
|
||
建议选择程度：中高。
|
||
|
||
### 3.2 QtDragon HD
|
||
|
||
|
||
|
||
原始文件：
|
||
|
||
```text
|
||
linuxcnc/docs/src/gui/images/qtdragon_hd.png
|
||
```
|
||
|
||
推荐用途：
|
||
|
||
- 大屏布局参考。
|
||
- 适合后续做宽屏 Web 版操作台。
|
||
|
||
建议选择程度：中。
|
||
|
||
## 4. Vismach 机床仿真参考
|
||
|
||
### 4.1 Vismach
|
||
|
||
|
||
|
||
原始文件：
|
||
|
||
```text
|
||
linuxcnc/docs/src/gui/images/vismach.png
|
||
```
|
||
|
||
推荐用途：
|
||
|
||
- Python `vismach.py` 原始机床仿真窗口参考。
|
||
- 可参考机床模型、坐标轴、视角控制和独立仿真窗口表达。
|
||
|
||
建议选择程度：中。
|
||
|
||
### 4.2 QtVismach
|
||
|
||
|
||
|
||
原始文件：
|
||
|
||
```text
|
||
linuxcnc/docs/src/gui/images/qtvismach.png
|
||
```
|
||
|
||
推荐用途：
|
||
|
||
- QtVCP 嵌入式机床仿真面板参考。
|
||
- 适合思考 Three.js 视口如何嵌入主操作界面。
|
||
|
||
建议选择程度：中。
|
||
|
||
## 5. 推荐界面方案
|
||
|
||
用户已选择 `gmoccapy_5_axis.png` 作为目标界面风格。建议第一版 Web 五轴 RTCP 仿真界面以 gmoccapy 5 轴界面为主风格，再吸收 QtVismach 5 Axis Gantry 的机床模型表达和 PyVCP 的五轴状态控件。
|
||
|
||
```text
|
||
主风格：gmoccapy_5_axis.png
|
||
3D 机床视口：QtVCP Vismach 5 Axis Gantry
|
||
五轴专用状态：PyVCP SWITCHKINS / joint values
|
||
经典布局参考：AXIS
|
||
后续大屏扩展：QtDragon / QtDragon HD
|
||
```
|
||
|
||
具体布局建议：
|
||
|
||
```text
|
||
顶部：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. 图片清单
|
||
|
||
```text
|
||
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. 选择建议
|
||
|
||
当前选择：
|
||
|
||
```text
|
||
gmoccapy 5 Axis + QtVismach 5 Axis Gantry + PyVCP SWITCHKINS
|
||
```
|
||
|
||
如果后续需要更经典 LinuxCNC 桌面风格，可退回：
|
||
|
||
```text
|
||
AXIS + PyVCP + QtVismach 5 Axis Gantry
|
||
```
|
||
|
||
如果后续需要更现代大屏触控风格，可扩展：
|
||
|
||
```text
|
||
gmoccapy + QtDragon HD
|
||
```
|