菜单栏

**菜单栏提供软件的基本功能**

* [**工程**](#h2-工程)
* [**视图**](#h2-视图)
* [**调试**](#h2-调试)
* [**工具**](#h2-工具)
* [**权限**](#h2-权限)
* [**帮助**](#h2-帮助)
## 工程

![](/media/202601/2026-01-14_170908_0625680.22231313837814926.png)
### 新建工程

---

VG3是以工程为最高命名，工程里可创建多个配方，配方有两种，***一种通用配方，一种全局配方***。全局配方只能有一个，该全局配方是由多个全局流程组成。通用配方可以有多个，每个通用配方可以创建多个流程。

更好的理解请看下面结构图

```mermaid
graph TD
    工程 --> 全局配方 --> 流程1  --> 模块1
    流程1  --> 模块3
    全局配方 --> 流程2  --> 模块2
    流程2 --> 模块4
    流程2 --> 模块5
    工程 -->通用配方1 -->  流程3  --> 模块6
    流程3 --> 模块7
    流程3 --> 模块8
    通用配方1 -->  流程4  --> 模块9
    流程4 --> 模块10
    工程 -->  通用配方2   -->  流程5  --> 模块11
    流程5 --> 模块12
    通用配方2 -->  流程6   --> 模块13
```

创建新工程，当用户点击此菜单时，如果用户已经打开了一个工程并且没有保存，会提示是否保存，然后再新建。
![](/media/202601/2026-01-16_170419_4169770.8696593568636057.png)
新建工程需要用户修改工程名，和工程路径。工程名默认会以数字递增的方式增加到 ***新建工程*** 文字后面。工程路径默认放到软件安装的路径下。当点击确定后，VG3会立即打开新建的工程。
#### 新建工程的目录结构
![](/media/202601/2026-01-19_102142_3447590.2363462396471825.png)
**cyGlobalData文件夹**
存入工程所使用的全局变量，标定数据，各种模型图片等
**cyRelativeDataRef文件夹**
存入工程的一些仿真图像数据，可以使得工程导出后，导入到另外的电脑中可以直接运行，无需重新设置仿真图像连接地址。
**全局配方文件夹**
存入全局配方所使用的数据
**通用配方文件夹（默认新建配方1）**
存入通用配方所使用的数据
**工程的入口文件**
一般打开工程可以选择多种方式，其中一种就是打开的时候选择到这个入口文件，即可导入工程所有信息和数据。

>i **打开文件格式**
>.cysln 工程入口文件，前面已介绍
.zip 标准工程压缩文件，旧的VG3软件导出是.zip格式，由于编码问题，新版的VG3采用准易工程压缩文件格式。
.cySlnZip 准易工程压缩文件

### 打开工程

---

选择已有工程导入。在视觉方案设计中，通常会分享方案，此时可以使用该功能打开一个已有的工程进行编辑和调试。如果检测到工程与现有的VG3软件不匹配，一般工程版本较低时出现，VG3软件会提示用户转换工程。具体转换工程的方式和版本信息，可以参考下方的 [转换工程](#h3-转换工程) 栏目。
 VG3支持3种文件格式的打开
###  最近打开工程
  VG3软件会保存最近使用过的15个工程，方便用户切换工程。旧工程信息会因为上限的限制而被清除，用户也可以自行点击清除所有工程信息，即可清空该列表。
### 打开工程所在文件夹
  当用户需要快速找到当前编辑的工程所在的目录时，可以通过点击此菜单一键跳转到工程目录位置。
### 工程保存 - Ctrl+s
  保存工程，配方，流程和数据到工程原本的本地的路径
### 工程另存
  保存工程，配方，流程和数据等到用户指定的新路径，会将工程另存为 .cySlnZip的格式，相当于工程的准易格式的压缩文件。当使用打开工程是，支持该格式，软件会自动识别解压并导入VG3。
### 工程重命名
  将工程名称重新命名，成功后会将工程的入口文件名称改变，从而改变标题的工程显示名称。
### 配方切换
  配方切换可以进行通用配方的切换，新建跟多配方可以进入配方管理进行更多操作。
### 转换工程
  当工程版本与VG3软件版本不匹配的时候，打开工程会提示软件版本不匹配的信息，这时候就得使用转换工程来讲工程版本转换。一般这种情况是工程使用的是高版本软件创建和编译的，但是使用低版本的VG3软件打开时，会提示用户升级软件版本即可正常打开。各种软件版本请参照 [软件版本说明](/doc/299)。。。
  
### 视图

![](/media/202601/2026-01-14_171915_7995190.07410849232661021.png)
* 重置窗口布局
  重新将软件的布局恢复原状。由于VG3软件采用Docker布局模式，可以根据用户的习惯设置自己喜欢的软件布局结构。原始布局请看 [软件介绍](/doc/287) 。。。
* 图像布局

常规布局：一行最多4个图像窗口，多了换行，不允许调整窗口位置和布局

![](/media/202601/2026-01-20_145905_0449660.7654543537062962.png)
指定图像窗口位置：可以自己调整窗口展示的位置

![](/media/202601/2026-01-20_145602_8085010.4624296572617642.png)

![](/media/202601/2026-01-20_145625_3931320.03017397697485935.png)
点击排列窗口，可以快速恢复
点击锁定位置，可以锁定你们窗口的调整位置，也可以点击解除锁定，继续调整窗口位置。
指定图像排列模式：
![](/media/202601/2026-01-20_145206_4071350.2366671399801985.png)
提供7中模式的窗口布局，快速切换适合的。
* 显示设置
  软件的其它显示设置，详情请看下面的[工具](#h3-工具)栏目

###   调试

![](/media/202601/2026-01-14_172010_8547730.7225613916466279.png)
* 运行
  连续运行当前配方的所有流程，包括全局流程。
* 停止 `仅在点击运行后才会出现`
  停止运行当前配方的所有流程，不会停止全局流程。
* 连续测试
  连续测试当前选中的流程，即函数树展示的流程。
* 单次测试 - F5
  单次测试当前选中的流程，即函数树展示的流程。
* 全部停止
  停止软件的调试,运行,全局流程运行，如果存在运动控制还会停止轴。

###   工具

![](/media/202601/2026-01-14_172106_1245350.4693038754458938.png)
* 选项设置
![](/media/202601/2026-01-20_145939_2790520.7462533283481037.png)

| 设置项 | 描述 | 参数解释 |
| --- | --- | --- |
| 软件启动 | 软件启动，主题设置 | **开机启动：** 开机自动启动; 手动打开软件; **开机自动启动：** 同一台电脑上最多允许一个VG3软件自动启动，若设置多个开机自动启动的VG3软件，软件则以最后一个启动的为准。 **手动打开软件：** 需要手动点击VG3的软件启动图标才可成功运行软件。 |
| | | **开机自动延时：** 搭配开机启动使用，当设置开机启动方式为开机自动启动时，有一些特殊情况我们需要等待其它的软件或者硬件优先加载再启动VG3，这时，就可以设置延时多少ms后启动VG3。 |
| | | **软件运行模式：** 以前台模式运行；以后台模式运行。 **以前台模式运行：** 每次启动VG3软件，即显示VG3的编辑界面或者运行界面，是否显示运行界面在后面的其它设置中会有相应的设置。 **以后台模式运行：** 每次启动VG3软件，不会立即显示VG3的编辑界面或者运行界面，会在后台运行，相当于最小化软件，用户可以点击电脑状态栏的图标显示编辑界面。 `注意：` `以后台模式运行时，软件不会刷新图像。` |
| | | **加载工程后：** 直接开始执行，输入密码后执行，输入密码后编辑，手动点击开始运行 **直接开始执行**：当打开VG3软件，并成功加载到一个工程后，会直接触发运行，使当前配方的所有流程包括全局流程连续运行起来 **输入密码后执行：** 当打开VG3软件，并成功加载到一个工程后，弹出登录窗口，需登录成功后立即执行运行。 **输入密码后编辑：** 当打开VG3软件，并成功加载到一个工程后，弹出登录窗口，需登录成功后进入编辑界面，不执行立即运行。 **手动点击开始运行：** 当打开VG3软件，并成功加载到一个工程后，无需登录，也不会立即执行，直接进入到编辑界面。 |
| | | **语言显示：** 简体中文，English 显示语言改变后，请重启软件。|
| | | **主题颜色风格：** 白色，黑色 主题颜色风格改变后，若出现颜色不一致，请重启软件。|
| | | **图像窗口背景：** 无，马赛克，浅灰，深灰 全部流程和当前流程图像背景，部分模块独立界面的背景。 **无:** 无背景绘制，会跟随主题风格的颜色进行切换，不会消耗额外性能 **马赛克:** 绘制黑白方块相间的颜色，利于图像边缘查看，不会跟随主题风格的颜色进行切换，会消耗一定的刷新效率 **浅灰:** 绘制纯色，不会跟随主题风格的颜色进行切换，比绘制马赛克消耗的性能要小一些 **深灰:** 绘制纯色，不会跟随主题风格的颜色进行切换，比绘制马赛克消耗的性能要小一些|
| 软件其它 | 软件账户，其它设置 | **软件密码** 可以给三种角色（管理员，工程师，操作员）重新设置登录密码，需管理员可以设置。 |
| | | **崩溃文件：** 当软件崩溃时，默认会在exe同级目录下的VG3DmpHelper文件夹中，生成定位崩溃问题的帮助文件。 不导出:不根据错误码停止并生成崩溃文件，仅在try-catch捕获到异常时退出 正常导出：崩溃文件一般在300-500MB左右，压缩后20-100MB左右，可以看到一般堆栈数据； 详细导出：崩溃文件一般在1000MB左右，压缩后50-300MB左右, 但压缩时间较长，崩溃文件更加详细，包括堆栈信息、变量的完整内存映射。|
| | | **日志文件数量：** 当软件运行时，会将一些运行的情况写入到日志文件中，便于软件发生问题时排查 每个文件最大10MB, 默认会生成10个文件，修改此属性会更改日志文件的数量 比如：若修改为100，则最大可能占用磁盘1000MB空间，推荐根据硬盘空间大小自定义的修改此选项 文件位于软件同级目录下logs文件夹，若此数量设置的比较大，若软件一切正常的情况下，推荐一段时间后手动删除该文件夹| 
| 运行设置 | 工程运行相关设置 | VG3支持运行时调用外部软件，弃用此功能，配置参数： 调用外部软件，调用软件后延时 ， 外部软件路径 **调用外部软件：** 其实是外部软件和VG3软件打开的顺序设置。优先打开外部软件，优先打开本软件。 `此选项主要用在通讯场景上，VG3和客户的软件做TCP服务端与客户端的场景应用。` |
| | | **调用软件后延时：** 其实是优先打开的软件延时多少ms后打开另一个软件的间隔时间。|
| | | **外部软件的路径：** 选择外部软件的启动exe文件路径 |
| | | **切换相机触发方式时切换流程触发方式：** 当切换相机采图的触发方式的下拉框时，自动切换当前模块所屈流程的执行模式。 此选项开启时 1. 当流程执行模式为连续执行，且流程不为子流程时，切换相机采图模块的触发方式为自触发或软件触发，流程执行模式将会切换为等待触发 2. 当流程执行模式为等待触发，且流程不为子流程时，切换相机采图模块的触发方式为硬件触发，流程执行模式将会切换为连续执行关闭时则不会自动切换。|
| | | **修改模块参数或者拖动R0I时禁止自动检测：** 修改模块参数或拖动ROI等操作时默认会自动行模块及基下方模块的检测处理，不必修改完参数后手动点击单次测试按钮，便于查看刷新检测后的效果。勾选此选项会关闭此功能，会避免一些模块修改参数后崩溃问题。|
| | | **开启硬件后台扫描：** 硬件后台扫描:寄存器和输入、输出口的状态定时回报 启用后，会在点击工程运行时开启硬件后台扫描 未启用时，不会开启硬件扫描|
| 显示设置 | 工程界面显示设置 | **刷新效率控制：** 密集刷新[性能优先]，密集刷新[刷新优先]，跳跃刷新，禁止图像刷新。 密集刷新[性能优先]：是保证检测后尽量及时刷新图像窗口的图像 密集刷新[刷新优先]：是保证检测后立即在图像窗口刷新图像 跳跃刷新：是软件在空闲时刷新图像窗口的图像 禁止图像刷新：检测过程中不刷新图像也不刷新绘制信息 异步刷新：检测过程中异步刷新图像，在刷新图像时检测耗时较少，但为20260728新增功能需要进行测试后再使用。|
| | | **显示函数运行时间：** 开启或者关闭显示函数树里的每个函数运行时间。|
| | | **显示流程运行时间：** 开启或者关闭显示流程树以及全局流程的运行时间。|
| | | **显示函数运行图标：** 开启或者关闭函数树里每个函数的运行图标，运行图标有以下几种： ![](/media/202601/2026-01-28_173112_4480590.7776871139758036.png)|
| | | **显示流程运行图标：** 开启或者关闭显示流程树以及全局流程的运行图标。|
| | | **连续运行时重置函数和流程运行时间和图标** 在点击开始运行按钮开启新一轮检测时，清空上次检测时的函数、流程运行图标状态|
| | | **点击函数图标时弹出界面：** 此选项开启时，点击函数树上的每一个函数模块的图标时，都会弹出独立编辑界面。不启用，点击不会打开。|
| | | **允许开启全局变量树等界面状态定时刷新：** 此选项开启后 1.全局变量树会在聚焦离开、界面显示时开启数据刷新定时器 2.轴监控树(运动控制特有)、轴输入树、轴输出树会在聚焦进入、界面显示时开启数据刷新定时器 `此选项关闭后则仅会在上述操作时刷新一次，其他情况下想要刷新需要手动点击刷新按钮` |
| | | **图像上显示结果线条画笔尺寸：** 图像上显示结果模块的绘制直线、点时的尺寸 在结合提取直线等模块使用时，绘制直线、点时的画笔尺寸一般为5 修改此选项可改变该尺寸|
| 其它设置 | 工程其它设置 | **启用软键盘** 当软件在一体机上使用时，可以开启软键盘代替鼠标和键盘。|
| | | **工程自动备份** 开启自动备份，当用户保存工程时，会自动copy一份到工程所在的目录下的backupSolution文件夹下。一般保存最近三次保存操作时的工程。 关闭自动备份，软件不会自己备份工程，可以点击旁边的立即备份进行备份操作。|
| | | **加载工程后显示组态运行界面** 当工程有自己的运行界面，开启此选项，工程打开后会立即显示用户设置好的组态运行界面，否则会进入VG3的编辑界面。如何编辑界面请参考 [运行界面编辑](/doc/283)。|
| | | **组态权限自动降级至操作员时间：** 组态有权限设置，目前支持三种，管理员，工程师以及操作员。当用户登录非操作员的权限，会在设置的时间后，自动降级到操作员级别。|

### 权限

![](/media/202601/2026-01-14_172136_1550220.24414159706927063.png)
* 登录
  VG3软件提供三种权限等级，管理员，工程师以及操作员
| 权限说明 | 管理员 | 工程师| 操作员 |
| --- | --- | --- | --- |
| 运行暂停流程 | ✅️ |✅️ | --- |
| 删除新增编辑流程 | ✅️ | ✅️ | ❌️ |
| 删除新增编辑函数 | ✅️ | ✅️ | ❌️ |
| 全局数据模型编辑 | ✅️ | ✅️ | ❌️ |
| 流程设置-函数显隐 | ✅️ | ❌️ |❌️ |
| 字符串监控 |✅️ | ❌️ | ❌️ |
| 寄存器监控 | ✅️ |❌️ | ❌️ |
| 数字输入输出监控 | ✅️ | ❌️ |❌️ |
| 修改密码 |✅️ | ❌️ | ❌️ |

* 修改密码
  只有管理员权限可以修改密码，可以修改管理员，工程师以及操作员的密码

###   帮助

![](/media/202601/2026-01-14_172204_4392640.6584684473521183.png)
*   显示帮助
  联系供应商即可获得
*   Lua手册
  VG3软件提供快捷的脚本语言进行复杂的流程搭建或者函数之间的处理。相关的语法和说明见此说明手册。
*   关于
  
![](/media/202601/2026-01-29_172300_6439100.689661084277986.png)
展示软件的基本信息，包括软件版本，发布日期，版权所有以及联系的邮箱地址

*   崩溃打包
使用此功能可以方便的将最近崩溃的调试信息文件打包，发送给软件开发人员可以使其快速解决问题

![](/media/202607/2026-07-28_173726_3761700.30062404358417205.png)

![](/media/202607/2026-07-28_174756_8547540.37053686599757374.png)

![](/media/202607/2026-07-28_175027_7057980.9035961526680933.png)
选择勾选的崩溃文件，若选择太多则会导致打包文件过大

点击此处跳转到对应的中文说明书文章页:&nbsp;[Menu Bar](/doc/585)