Appearance
界面介绍
运行环境
系统：win10/win11 企业版或专业版
CPU：I5-10代
内存：8G
硬盘：500G SSD
页面总览
AI-Vision主页面总共分为八个板块：
菜单栏：进行软件的设置和系统参数修改，显示软件名称及当前版本号，调整界面大小工具栏：常用工具的操作，如文件操作、运行操作等工程列表：显示软件当前加载的工程和程序工具列表：显示软件当前支持的工具程序运行栏：显示由各工具组合而成的测量流程，可以通过运行工具来调试图像显示栏：显示工具执行完成后的3D效果图，可以通过鼠标进行拖动、滚动、缩放等操作调试输出栏：显示寄存器、全局变量、设备列表等状态栏：显示当前工程的位置和运行时间，以及系统信息
菜单栏
菜单栏分为三个部分：
菜单选项：按照不同的功能，菜单分：文件、编辑、视图、设置、工程、调试、语言、帮助软件版本：显示软件名称及当前版本号，例AI-Vision-Studio V1.0.0窗口操作：控制窗口的最小化、最大化、关闭
文件参考案例：弹出案例窗口，可以通过此选项打开软件的"入门/进阶/工程示例"。
新建程序：弹出新建程序窗口，输入新程序名，点击保存，为当前工程添加一个新的程序，当输入程序名与已有程序名相同时，会弹出提示框。
当前工程存在变更，建新工程后会弹出新建工程：AI-Vision没有工程，或当前工程不需要保存时，新建工程后界面内容为空，弹出提示框。
是否保存窗口。
关闭工程：关闭当前工程，并清空界面显示内容，工程存在修改且未保存，会弹出是否保存窗口。打开工程：打开现有的工程文件（文件后缀.aivs）保存：当前是新建的工程，会弹出保存窗口，用户选择要保存的路径及文件名称。当前工程已创建，则保存功能对工程文件的修改部分进行保存，并覆盖原来的工程文件。另存为：对工程文件的修改进行保存，不会覆盖原文件，会弹出另存为窗口。退出：关闭软件，当前工程已修改且未保存，会弹出是否保存窗口。
编辑全局变量：弹出全局变量窗口，详细介绍请参看全局变量页面
视图布局选择：可以显示/隐藏左侧边栏、运行列表、输出列表
主题选择：切换明暗两种主题色，方便适应强光和弱光的环境。
设置系统参数：弹出系统参数窗口。通用参数
运行模式：正常-所有模块全部执行；极速-图像显示栏不再刷新，其余模块正常执行。调试：选择启用调试模式后，软件log文件中会保存调试相关信息，方便问题排查。寄存器长度：控制调试输出栏中寄存器列表的显示长度，范围30-70。
主题参数
背景：选择软件的背景颜色，同设置菜单中的主题选择功能。
图像参数
渲染模式：采样-降低点云图像显示的点数，渲染速度更快；精细-显示原始点云的点数，渲染效果更好。
配方管理：弹出配方管理窗口，详细介绍请参看配方管理页面
工程HMI编辑器：打开HMI编辑器，详细介绍请参看HMI编辑器
调试全部运行：按程序运行栏的工具顺序，将整个程序运行一次。程序中存在断点，则程序运行到断点停止；程序中有禁用工具，则程序跳过该工具继续运行单步运行：按程序运行栏的工具表顺序向下运行一步。当前工具为程序的最后一个，则单步运行后运行标签回到第一个工具；当前工具为判断或跳转工具，则单步运行后运行标签跳转到相应的逻辑位置。循环运行：循环运行程序运行栏的程序，程序中存在断点，则程序运行到断点停止；程序中有禁用工具，则程序跳过该工具继续运行暂停：程序已在运行，暂停正在运行的程序，并且当前运行标签回到程序的第一行。程序没有运行，该功能呈禁用状态。清除记录：清除运行输出的结果，包括：程序运行栏的运行状态，图像显示栏的图像内容，调试输出栏的列表内容
语言中文：切换到中文语言。English：切换到英文语言。
帮助帮助文档：打开帮助文档。
关于AI-Vision-Studio：弹出关于窗口。
工具栏
工具栏中的功能，均可在菜单栏中找到。
新建工程：同菜单栏->文件->新建工程
打开工程：同菜单栏->文件->打开工程
打开案例：同菜单栏->文件->参考案例
保存：同菜单栏->文件->保存
另存为：同菜单栏->文件->另存为
全部运行：同菜单栏->调试->全部运行，在程序运行状态时，该按钮为禁用状态
单步运行：同菜单栏->调试->全部运行，在程序运行状态时，该按钮为禁用状态
循环运行：同菜单栏->调试->全部运行，在程序运行状态时，该按钮为禁用状态
暂停：同菜单栏->调试->全部运行，在程序未运行状态时，该按钮为禁用状态
清除记录：同菜单栏->调试->全部运行
全局变量：同菜单栏->编辑->全局变量，详细介绍请参看全局变量页面
配方管理：同菜单栏->设置->配方管理，详细介绍请参看配方管理页面
设备管理：同菜单栏->设置->设备管理，详细介绍请参看设备配置页面
工程列表
工程列表：显示当前AI-Vision处理的工程，默认显示工程名，点击工程名后下拉弹出程序列表。
新建程序：右键单击工程名，显示新建程序，选择会弹出新建程序窗口，同菜单栏->文件->新建程序。
切换程序：左键双击程序名，或右键单击程序名->打开，切换到该程序，程序运行栏会显示当前程序的内容。
重命名程序：右键单击程序名，程序名会切换为可编辑状态，输入新的名字后，鼠标单击框外即可完成重命名。
工具列表
工具列表：按照工具类型分为五类：3D算子、相机取图、通信、逻辑、脚本。工具详细介绍请参看工具介绍
3D算子工具：文件：加载和保存点云预处理：点云处理，包括滤波、位置变换、点云运算等几何：几何计算集成：针对特定场景的处理算子目标：几何特征查找
通信工具：I/O：IO板卡的通信，读/写/等待IO信号ModBus：ModBus TCP协议，支持位读/写、寄存器读/写PLC：读/写PLCTCP/UDP：字符串收/发
逻辑工具延时：延时等待判断：判断上一个工具的执行结果，执行相应操作跳转：程序执行跳转到相应标记处标记：作为一个程序标签，供跳转工具选择切换配方：切换程序配方，结合业务场景使用
脚本工具Lua脚本：支持Lua语言，详细介绍请参看Lua脚本页面
工具查找
根据工具的中文名称进行查找，可输入局部名称查询
程序运行栏
程序运行栏：用于设计图像处理流程，可结合工具栏的运行按钮进行程序的运行调试，可结合图像显示栏对工具输出图像结果进行查看；可结合调试输出栏对工具输出结果进行查看。
添加工具
添加工具分3种方式：
1.鼠标右键工具，在弹出菜单中点添加；
2.双击工具；
3.鼠标左键单击拖动工具到程序运行栏。工具行
运行标签：
空-该行未运行；
蓝色-程序运行到这一行，但还没执行；
绿色-该行运行成功；
红色-该行运行失败；
黄色-该行运行有警告行号：当前程序运行栏的所有工具按照从上到下顺序排列后的行号，行号从0开始断点：运行打断标记，启用断点后，全部运行和循环运行到此行会停止禁用：工具禁用标志，禁用后，该行工具不执行图标：该行工具的图标注释：该行工具的注释，用户可自定义，默认为算子名称执行结果：该行工具执行后的结果，绿色：该行运行成功；红色：该行运行失败；黄色：该行运行有警告运行时间：该行工具执行一次耗费的时间
分组行
展开箭头：展开或合上该分组分组名称：该分组的名字，可修改，默认为group运行时间：该分组内所有工具运行的总时间工具数量：该分组内包含的工具数量
右键菜单：普通工具的右键和分组的右键菜单内容并不完全一致，文字相同的则功能相同
编辑：弹出工具编辑窗口，修改该工具的参数，详细内容请参看工具编辑页面复制：复制该行工具，包括所有参数，不包含状态(断点、禁用)粘贴：粘贴该工具到指定工具的上方一行，可重复粘贴，该行后面工具的行号自动重新排序
剪切：剪切该工具，该行所在行号的工具消失，该行后面工具的行号自动重新排序删除：删除该工具注释：修改该行工具的注释，点击后弹出修改注释窗口合并(分组功能)：将选中的工具合并为一个分组，可结合Ctrl键或者shift键进行多选，不影响工具行号拆分(分组功能)：将分组内容拆开成单个工具，不影响工具行号
重命名(分组功能)：修改分组名称，默认为group
- 拖动
改变工具或分组在程序中的位置，拖动后的工具或分组行号会自动更新.
图像显示栏
程序显示栏分五个部分：
图像工具：适用与所有图像的显示和操作
图像渲染：
颜色：点云显示的颜色，从左到右分别为彩色，纯色，灰度（按高度进行贵都渲染）。仅在点云模式下可改
渲染模式：分为：点云-以点的形式显示；网格-将相邻点以三角形连接成网格的方式显示；网面-将网格以面的形式显示
渲染值：设置网格和网面模式下的渲染参数，点云点距小时，该值设置小，点云点距大时，该值设置大。仅在网格和网面模式下可改
外接矩形开: 在IM上显示整个点云的外接矩形
外接矩形关: 关闭在IM上整个点云的外接矩形
居中: 将点云缩放还原到适应窗口大小且位置居中
保存点云: 将当前IM中的点云保存到本地文件夹，默认为pcd格式
坐标显示：鼠标在点云上移动时，显示当前鼠标所指点的坐标值
IM选择：在程序运行栏的图像算子中可以设置图像显示的IM编号，选择不同的IM，可查看对应的图像内容。V1.0.0版本支持最大9个IM
点云显示：没有点云时，显示区域为坐标轴，坐标轴原点为(0,0,0)点；有点云时，即显示当前点云。鼠标左键：控制点云的查看视角鼠标右键：拖动点云鼠标滚轮：点云放大/缩小
坐标轴：指示点云当前显示的视角
调试输出栏
调试输出栏分三个部分：寄存器列表(调试输出)、全局变量列表(全局变量)、已连设备列表(设备状态)
显示工具输出的数据，详细内容请参看
显示全局变量，详细内容请参看
显示当前工程配置的设备状态，彩色为设备已连接，灰色为设备未连接状态栏
状态栏分四个部分：
工程地址：显示当前工程在电脑磁盘上的绝对地址运行时间：点击全部运行后程序执行一次的总时间，（到断点或程序执行结束）系统信息：后台状态：后台程序运行的状态CPU：系统CPU利用率的实时百分比数值系统内存：系统所有进程消耗的总内存/系统总内存
授权信息：倒计时：没有使用AI-Vision授权，软件仍可以试用的时间已授权：使用AI-Vision授权，软件可长久使用未授权：没有使用AI-Vision授权，软件试用时间结束
工具编辑页面
以3D方形探针算子为例： 
工具编辑页面共分为五个部分：
标题栏：显示当前工具的名称，并控制该页面的关闭和最大化参数编辑栏：修改该工具的参数输入图像：当前工具执行时，所依赖的图像源，与主页面->图像显示框中的IM编号一一对应区域：即ROI设置手动：选中时，用户需要手动选中ROI区域，工具根据ROI框选区域来运行窗口：方形WINDOW，用于不考虑Z方向点云的ROI框选盒子：立方体BOX，用于三维ROI框选
寄存器：手动未选中时，工具根据寄存器的编号来运行，与主页面->调试输出栏->调试输出中的序号一一对应，
输出图像：当前工具执行完，将结果图像输出到主页面->图像显示框中相同的IM编号中其他参数：每个工具的参数都不同，详细介绍请参看工具介绍
测试栏result：OK-运行成功，NG-运行失败，WARN-存在异常，但不影响运行测试时间：当前工具执行一次花费的时间测试：点击后工具运行，如果是执行时间较长的工具，则点击测试后，整个工具编辑界面会弹出等待中字样
保存：保存当前工具的所有参数，点击保存按钮后，会关闭工具编辑页面关闭：关闭工具编辑页面，不保存修改的参数
图像栏移动(W)：窗口中的ROI区域可以通过鼠标移动位置，快捷键为W缩放(E)：窗口中的ROI区域可以通过鼠标改变尺寸，快捷键为E
精细渲染/极速渲染：切换窗口中点云图像的渲染模式，精细渲染-显示点多，图像效果好，渲染速度慢；极速渲染-显示点少，渲染速度快位置：鼠标在点云图上移动时，指示的点的实际坐标坐标轴：点云图的视角和坐标方向
结果栏：同主页面->调试输出栏->调试输出，详细介绍请参看寄存器页面
全局变量页面
全局变量以表格的形式显示，按照列的顺序，依次为： 序号：该变量在表格中的行号，从0开始名称：变量名称，为用户手动创建时定义，或在脚本中创建时定义类型：变量的类型，分为Number(数字，可为整数或小数)，String(字符串)，Array(数组，可为Number或String数组)，Boolean(布尔，可为true或false)值：变量当前的数值创建者：Lua-Lua脚本创建，Custom-用户在全局变量界面中创建，空-工具执行完创建保留：布尔状态的属性，true-保存工程时该变量值会被记录，下次打开工程会使用该记录值，false-保存工程时该变量值不会被保存操作：编辑：进入变量编辑界面，用户可以修改变量的值和是否保留，
提交：保存修改后的值重置：将变量值的内容清零关闭：退出编辑，已经编辑过的内容不会被保存
删除：删除该变量，
添加变量操作
设备配置页面
设备配置页面分为四个部分： 标题栏：显示当前页面的名称和最大化、关闭按钮设备支持列表：设备的详细介绍请参看设备配置页面添加：通过双击设备名称，或点击设备后面的"+"，添加设备支持：灰色的设备为在特定条件下才能使用的设备，详细信息请参看设备配置页面
设备选中列表：序号：设备在列表中的顺序，从0开始图标：设备图标设备名称：用户设置设备的名称，可以在工具中选择相应设备进行操作状态：绿色-设备已连接；红色-设备未连接启用使能：打开-设备可用，能在工具中选择；关闭-设备禁用，工具中将不再列出该设备编辑：修改设备参数，具体参数信息请参看设备配置页面
在配置页完成操作后，点击保存即可。删除：删除该设备，
操作栏：刷新：刷新一次设备状态，设备参数修改，可点击刷新查看设备最新的状态关闭：关闭设备配置页面，不会保存修改的内容
连接相机取图举例
配方管理页面
配方管理页面分为四个部分： 标题栏：显示当前页面的名称和最大化、关闭按钮配方列表：当前选中：当前程序中执行的配方，序号：当前列表中配方的顺序，从0开始配方名称：用户可自定义名称，在配方切换工具中选择相应的配方名称路径：配方文件在磁盘上的位置，可以是绝对路径或相对路径(.\)
配方表格：序号：表格中的行号，从0开始编辑：修改配方参数
提交：保存修改的参数，点击后编辑页面关闭取消：不保存参数，直接关闭页面
删除：删除该行数据，其余字段：配方中定义的各字段名称，以及该字段对应的值
操作栏：保存：保存当前修改后的配方内容，点击后关闭配方表格取消：不保存配方内容，点击后关闭配方表格关闭：不保存任何内容，直接关闭配方管理页面
当鼠标在配方列表的配方名称上右键时，有四个可以操作的内容：
打开：打开选中的配方，配方内容在右侧配方表格中显示
创建：通过界面操作的方式新建一个配方。
添加：添加一个已有的配方到当前列表，该配方可以是任何人创建的，只要满足Json格式即可。
删除：删除选中的配方
Lua脚本页面
Lua脚本页面包含六个部分： 标题栏：显示当前页面的名称和最大化、关闭按钮代码编辑窗口：提供用户进行脚本编辑，显示行号及语法错误提示结果输出窗口：显示用户在代码编辑窗口中使用print、println方法打印的调试信息，以及语法错误的提示信息
语法错误提示格式说明：
举例：
[string "println('Hello AI-Vision!')..."]:3: unexpected symbol near '+'
含义：在代码的第3行，存在异常的符号:"+"脚本帮助窗口帮助说明窗口：当脚本帮助窗口选择为函数列表时：选中函数的详细信息，包含：函数介绍、输入参数、返回值当脚本帮助窗口选择为脚本示例时：选中示例的完整详细介绍，包含：注释，用法
测试栏：result：OK-运行成功，NG-运行失败，WARN-存在异常，但不影响运行测试时间：当前代码执行一次花费的时间运行：运行脚本编辑窗口中的代码保存：保存脚本编辑窗口中的代码，并关闭Lua脚本页面取消：并关闭Lua脚本页面，不保存编辑的代码
智能提示功能： 
用户在代码编辑窗口输入一个字符时，软件会根据已有函数进行判断，弹出包含该字符的函数列表，该列表中包含四类函数：
AI-Vision：AI-Vision封装出来的函数，主要用于寄存器操作、文件读写、数据库写入、几何处理等，具体用法可参看定制函数keyboard：Lua语言自带的系统函数，具体用法可参看常用函数snippet：可以自动补全的方法local：已经在代码编辑窗口中写过的变量
自动补全功能： 
快捷键
AI-Vision还提供了快捷键来简化操作，以下为主要功能的快捷键详解，
菜单栏 | |
|---|---|
| Alt + F | 文件菜单 |
| Alt + B | 开始菜单 |
| Alt + E | 编辑菜单 |
| Alt + V | 视图菜单 |
| Alt + S | 设置菜单 |
| Alt + P | 工程菜单 |
| Alt + L | 语言菜单 |
| Alt + M | 管理菜单 |
| Alt + H | 帮助菜单 |
工具栏 | |
| Ctrl + N | 创建新工程 |
| Ctrl + O | 打开已有工程 |
| Ctrl + E | 打开案例选择 |
| Ctrl + S | 保存工程 |
| Ctrl + Shift +S | 另存为工程 |
| Ctrl + F1 | 运行列表完整运行一次 |
| Ctrl + F2 | 运行列表按顺序运行下一个 |
| Ctrl + F3 | 运行列表循环运行 |
| Ctrl + F4 | 暂停运行 |
| Ctrl + F6 | 清空状态 |
| Ctrl + F7 | 打开全局变量配置页面 |
| Ctrl + F8 | 打开设备配置页面 |
| Ctrl + F9 | 打开配方管理页面 |
其他快捷键 | |
| Esc | 关闭当前弹窗 |