# Gcode解析

**Repository Path**: b612zhanyu/gcode-parsing

## Basic Information

- **Project Name**: Gcode解析
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-27
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NC Viewer - GCode可视化工具

这是一个完全按照 ncviewer.com 功能设计的桌面端GCode可视化工具，使用Python和PyQt5开发。

## 功能特性

### 🎯 核心功能
- **GCode文件加载** - 支持.nc、.gcode、.txt格式
- **语法高亮** - G/M指令、数字、注释的彩色显示
- **3D可视化** - 实时3D路径预览
- **数字读数** - 实时显示X/Y/Z坐标和A/B/C角度
- **文件拖拽** - 直接拖拽文件到窗口即可加载

### 🎨 界面布局
- **左侧控制面板** - 数字读数显示和机器选项设置
- **右侧主视图** - 3D可视化区域和代码编辑器
- **现代化设计** - 类似ncviewer.com的界面风格

### ⚙️ 机器选项
- **绘图方向** - 垂直(Z-Up) / 水平(Y-Up)
- **直径模式** - 车床模式支持
- **可视化选项**:
  - 显示/隐藏网格
  - 显示/隐藏快速移动
  - 显示工具路径点
  - 位置后隐藏工具路径
  - 启用5轴移动

### 🎮 3D交互
- **鼠标控制**:
  - 左键拖拽 - 旋转视角
  - 右键拖拽 - 平移视角
  - 滚轮 - 缩放
- **自动适配** - 自动调整视角以适应路径
- **坐标轴** - 彩色坐标轴显示(X红/Y绿/Z蓝)

## 安装依赖

```bash
pip install PyQt5 pyqtgraph numpy PyOpenGL
```

## 运行应用

```bash
python gcode_viewer.py
```

## 使用方法

1. **打开文件**:
   - 菜单栏: 文件 → 打开
   - 快捷键: Ctrl+O
   - 拖拽文件到窗口

2. **查看3D路径**:
   - 切换到3D预览标签页
   - 使用鼠标交互查看不同角度
   - 灰色线条 = 快速移动(G0)
   - 红色线条 = 切削移动(G1)

3. **调整显示选项**:
   - 在左侧面板调整各种显示选项
   - 实时预览效果

4. **查看代码**:
   - 在底部文本编辑器查看GCode内容
   - 支持语法高亮

## 示例文件

项目包含一个示例GCode文件 `sample.nc`，包含简单的矩形和圆形路径，可以用来测试应用功能。

## 技术特点

- **高性能3D渲染** - 使用OpenGL加速
- **实时解析** - 即时解析和显示GCode
- **跨平台** - 支持Windows、macOS、Linux
- **模块化设计** - 易于扩展和维护

## 与ncviewer.com的对比

| 功能 | ncviewer.com | 本应用 |
|------|-------------|--------|
| 3D可视化 | ✅ | ✅ |
| 数字读数 | ✅ | ✅ |
| 机器选项 | ✅ | ✅ |
| 语法高亮 | ✅ | ✅ |
| 文件拖拽 | ✅ | ✅ |
| 离线使用 | ❌ | ✅ |
| 本地处理 | ❌ | ✅ |
| 自定义扩展 | ❌ | ✅ |

## 开发计划

- [ ] 添加更多GCode指令支持
- [ ] 实现路径动画播放
- [ ] 添加测量工具
- [ ] 支持多文件对比
- [ ] 添加导出功能
- [ ] 实现插件系统

## 贡献

欢迎提交Issue和Pull Request来改进这个项目！

## 许可证

MIT License