# 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

![QtVCP Vismach 5 Axis Gantry](../assets/reference/linuxcnc-gui/qtvismach_5axis_gantry.png)

原始文件：

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

推荐用途：

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

建议选择程度：高。

### 2.2 gmoccapy 5 Axis

![gmoccapy 5 Axis](../assets/reference/linuxcnc-gui/gmoccapy_5_axis.png)

原始文件：

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

推荐用途：

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

建议选择程度：高。

### 2.3 AXIS

![AXIS](../assets/reference/linuxcnc-gui/axis.png)

原始文件：

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

推荐用途：

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

建议选择程度：高。

### 2.4 AXIS + PyVCP

![AXIS PyVCP](../assets/reference/linuxcnc-gui/axis-pyvcp.png)

原始文件：

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

推荐用途：

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

建议选择程度：高。

## 3. 现代操作屏参考

### 3.1 QtDragon

![QtDragon](../assets/reference/linuxcnc-gui/qtdragon.png)

原始文件：

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

推荐用途：

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

建议选择程度：中高。

### 3.2 QtDragon HD

![QtDragon HD](../assets/reference/linuxcnc-gui/qtdragon_hd.png)

原始文件：

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

推荐用途：

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

建议选择程度：中。

## 4. Vismach 机床仿真参考

### 4.1 Vismach

![Vismach](../assets/reference/linuxcnc-gui/vismach.png)

原始文件：

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

推荐用途：

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

建议选择程度：中。

### 4.2 QtVismach

![QtVismach](../assets/reference/linuxcnc-gui/qtvismach.png)

原始文件：

```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
```