控件功能介绍

图像

图像控件可订阅流程中模块输出的图像，并做显示。

参数具体如下：

• 颜色：可设置十字辅助线的线条颜色。

• 厚度：可设置十字辅助线的线条粗细。

• 自适应：可设置运行界面实际使用中，最大化窗口时，图像窗口是否等比例放大。

• 水平偏移/垂直偏移：可分别设置十字辅助线中竖线/横线距离中心的偏移量。其中水平偏移的正数对应向右偏移，负数对应向左偏移；垂直偏移的正数对应向下偏移，负数对应向上偏移。

• 保留上一次结果：可设置当前流程执行结束时若订阅结果无图像数据输出，是否保留上一次渲染结果显示。

• 数据源：可订阅显示图像的来源，点击后选择模块输出的图像即可。

• 叠加图层1/2/3：可基于数据源订阅的图像数据，叠加显示其他图像。操作方法和数据源相同，但只能从数据源订阅的流程中选择模块输出的图像。

  说明：

  设置该参数前，需先完成数据源的设置。

• 图形配置：可勾选需在数据源基础上叠加显示的图形。

  说明：

  设置该参数前，需先完成数据源的设置，可从加载的流程中选择多个模块的图形。否则，显示为空。

• 显示辅助线：可设置是否显示十字辅助线。

• 显示状态栏：可设置是否显示右下角的状态信息。信息主要为图像分辨率、鼠标当前所在位置的坐标信息和RGB分量或灰度值。

• 显示工具栏：可设置是否开放左上角的工具。工具对应功能分别为放大、缩小、1:1、全屏和锁定。

  说明：

  1:1功能主要用于在图像放大、缩小或移动后，快速恢复为在图像窗口自适应居中显示。

• 尺寸：可调整图像窗口的大小，也可通过预览及编辑区实时调整。

• 背景：可设置图像窗口背景的颜色。

• 边框颜色：可设置图像窗口边框的颜色。

• 边距：可调整图像窗口的位置，也可通过预览及编辑区实时调整。

多图像

多图像控件功能与图像控件相同，但可订阅并显示多个图像。

参数具体如下：

• 数据源：点击后对各个画面的名称、图像源、叠加图层、厚度、水平偏移、垂直偏移、显示辅助线等进行设置。操作方式和图像控件大同小异，此处不再赘述。

  说明：

  推荐先完成画面数量设置。

• 颜色：可设置十字辅助线的线条颜色。

• 自适应：可设置运行界面实际使用中，最大化窗口时，多图像窗口是否等比例放大。

• 画面数量：可设置多图像窗口显示的画面数量和画面的位置关系。

• 尺寸：可调整多图像窗口的大小，也可通过预览及编辑区实时调整。

• 边框颜色：可设置多图像窗口边框的颜色。

• 边框颜色：可设置多图像窗口边框的颜色。

• 边距：可调整多图像窗口的位置，也可通过预览及编辑区实时调整。

运行控制

运行控制控件可控制全部流程或单一流程的运行方式。

参数具体如下：

• 按钮颜色：可设置按钮的填充色。

• 控制类型：可选OnlyRunOnce、OnlyContinueAndStop和Both。

  • OnlyRunOnce：只生成单次执行的按钮。

  • OnlyContinueAndStop：只生成连续执行的按钮。

  • Both：同时生成以上两个按钮。

• 数据源：可订阅当前软件加载方案中的流程或AllProcess。AllProcess代表整个方案。

• 自适应：可设置运行界面实际使用中，最大化窗口时，按钮是否等比例放大。

• 图标颜色：可设置按钮中图标的颜色。

• 尺寸：可调整按钮的大小，也可通过预览及编辑区实时调整。

• 边框颜色：可设置按钮边框的颜色。

• 边距：可调整按钮的位置，也可通过预览及编辑区实时调整。

运行状态

运行状态控件可显示全部流程或单一流程的运行状态。忙碌时图标显示为“运行中”，空闲时显示为“停止运行”。

参数具体如下：

• 忙碌-背景色/忙碌-前景色：可设置图标忙碌状态各部分的颜色。

  说明：

  空闲-背景色和空闲-背景色功能及设置方法大同小异，不再赘述。

• 圆角半径：可设置图标四个角的圆角半径，控制图标形状。

• 数据源：可订阅当前软件加载方案中的流程或AllProcess。AllProcess代表整个方案。

• 自适应：可设置运行界面实际使用中，最大化窗口时，控件是否等比例放大。

• 尺寸：可调整控件的大小，也可通过预览及编辑区实时调整。

• 边距：可调整控件的位置，也可通过预览及编辑区实时调整。

OK/NG

OK/NG控件可根据订阅的数据判断显示为OK或NG，0代表NG，1代表OK。

参数具体如下：

• 数据源：可订阅方案中各模块的int型模块结果。推荐订阅各模块的模块状态或条件检测模块的结果(INT)。

• 圆角半径：可设置图标四个角的圆角半径，控制图标形状。

• 自适应：可设置运行界面实际使用中，最大化窗口时，控件是否等比例放大。

• NG-背景色/NG-边框颜色/NG-字体色：可设置图标NG时各部分的颜色。

• NG-内容：可设置图标NG时显示的文字内容。

• NG-字体：可设置图标NG时使用的字体、大小及字形。

• NG-边框厚度：可设置图标NG时控件的边框厚度。

  说明：

  以上NG相关参数，对应还需设置OK时的相关参数。功能及设置方法大同小异，不再赘述。

• 尺寸：可调整控件的大小，也可通过预览及编辑区实时调整。

• 边距：可调整控件的位置，也可通过预览及编辑区实时调整。

文本框

文本框控件可在运行界面显示定义的文本信息。可自定义文本内容，可以订阅方案中的不同类型的数据显示。

参数具体如下：

• 数据类型：可设置文本框中显示数据的类型，可选stringType（字符串类型）、intType（整数型）和floatType（浮点型）。

• 数据源：可订阅方案中各模块的模块结果、全局变量或方案路径在文本框中显示。选择不同的数据类型，可订阅的数据有所差别。

  说明：

  选择不同的数据类型，可订阅的数据有所差别。其中方案路径仅在数据类型为stringType时可以订阅。

• 数据绑定：绑定数据源后自动加载，显示为“订阅数据的描述：<订阅的数据>”。其中“订阅数据的描述：”可自定义修改；“<订阅的数据>”为格式化语法内容，选择不同的数据，语法内容有所差别。

  • 数据类型选择stringType时，格式化语法内容对应为“%s”。

  • 数据类型选择intType时，格式化语法内容对应为“%0d”。

  • 数据类型选择floatType时，格式化语法内容对应为“%1.3f”。此时小数点后保留3位有效数字，可自定义修改。例如%1.6f对应为小数点后保留6位有效数字。

  说明：

  设置该参数时，需了解格式化语法相关要求。若不了解相关内容且需做修改，请联系技术同事。

• 字符信息：订阅数据源时，此处显示订阅后的信息；不订阅数据源时，可通过该参数设置文本框显示的信息。

• 字体：可设置文本框中使用的字体、大小及字形。

• 字体颜色：可设置文本框中字体的颜色。

• 边距：可调整文本框的位置，也可通过预览及编辑区实时调整。

表格

表格控件可订阅需要呈现的数据，使订阅的数据按列滚动呈现最新数据。数据按照执行次数，倒叙呈现订阅历史结果。一般在需要同时查看多个流程的运行结果时使用。

参数具体如下：

• 数据源：可设置每一列的列名、列宽、数据类型、数据源、和颜色编辑

  • 数据类型：可选string、int或float。

  • 数据源：可订阅各模块或全局变量中符合数据类型要求的数据。

  • 颜色编辑：可设置订阅的数据源满足条件和比较值要求时，表格中对应数据的颜色。

    说明：

    • 条件包括= =（等于）、< >（不等于）、 >、<、 > =、< =。其中string型数据仅支持= =和< >。

    • 同一个数据满足多个颜色编辑设置的条件时，根据设置的条件的顺序执行第一个。

• 列数/行数：可分别设置表格的列数和行数。

• 字体：可设置表格中使用的字体、大小及字形。

• 行抬头：可设置表格左上角第一个单元格显示的内容。

• 尺寸：可调整表格的大小，也可通过预览及编辑区实时调整。

• 背景/边框颜色/字体颜色：可分别设置表格中背景、边框以及字体的颜色。

• 边距：可调整表格的位置，也可通过预览及编辑区实时调整。

按钮

若运行界面需要对软件部分功能进行设置或重置等操作，可使用按钮控件实现。

参数具体如下：

• 触发命令类型：可设置按钮的类型，可选ParamterConfiguration或ParamterReset。

• 数据源：选择不同的触发命令类型，可订阅的信息有所差别。

  • 选择ParamterConfiguration时，可订阅各流程或各模块的参数配置、相机管理、通信管理、光源管理、全局变量或日志。运行界面点击该按钮后，可在弹出的对应功能窗口中进行设置。

  • 选择ParamterReset时，可订阅单个变量计算的参数重置、所有变量计算、所有数据队列、保存方案。

    • 订阅单个变量计算的参数重置时，使用按钮可将该变量计算模块的变量初始化。

    • 订阅所有变量计算时，使用按钮可将方案中所有变量计算模块的变量初始化。

    • 订阅所有数据队列时，使用按钮可将所有数据队列的数据初始化。

    • 订阅保存方案时，使用按钮可实时保存方案。

• 显示文本：可设置该按钮显示的文本信息。

• 圆角半径：可设置按钮四个角的圆角半径，控制按钮形状。

• 自适应：可设置运行界面实际使用中，最大化窗口时，按钮是否等比例放大。

• 字体：可设置按钮文字使用的字体、大小及字形。

• 尺寸：可调整表格的大小，也可通过预览及编辑区实时调整。

• 背景/边框颜色/字体颜色：可分别设置表格中背景、边框以及字体的颜色。

• 边距：可调整表格的位置，也可通过预览及编辑区实时调整。

开关控制

开关控制控件可订阅模块中bool型参数，从而通过运行界面运行方案时控制该参数是否启用。

参数具体如下：

• 数据源：可订阅各模块中的bool型参数。

• 自适应：可设置运行界面实际使用中，最大化窗口时，开关是否等比例放大。

• 尺寸：可调整开关的大小，也可通过预览及编辑区实时调整。

• 边距：可调整开关的位置，也可通过预览及编辑区实时调整。

参数设置

参数设置控件可订阅模块中int或float型参数，从而通过运行界面运行方案时也可设置该参数。

参数具体如下：

• 参数类型：可选择订阅的数据类型，可选intType或floatType。

• 数据源：可订阅各模块及全局变量中的int或float型参数。订阅的参数类型，与参数类型有关。

• 自适应：可设置运行界面实际使用中，最大化窗口时，参数控件是否等比例放大。

• 字体：可设置参数控件文字使用的字体、大小及字形。

• 宽度：可调整参数控件的宽度，也可通过预览及编辑区实时调整。

• 背景/字体颜色：可分别设置参数控件背景以及字体的颜色。

• 边距：可调整参数控件的位置，也可通过预览及编辑区实时调整。

设置变量

设置变量控件可订阅变量计算模块中添加的变量，订阅表达式时会标红显示。运行界面可实时显示该数值，并支持修改。

参数具体如下：

• 数据源：可订阅变量计算模块中添加的变量。

• 自适应：可设置运行界面实际使用中，最大化窗口时，变量控件是否等比例放大。

• 字体：可设置变量控件文字使用的字体、大小及字形。

• 宽度：可调整变量控件的宽度，也可通过预览及编辑区实时调整。

• 背景/字体颜色：可分别设置变量控件背景以及字体的颜色。

• 边距：可调整变量控件的位置，也可通过预览及编辑区实时调整。

字符设置

字符设置控件可将订阅的字符串信息在控件中显示。

参数具体如下：

• 数据源：可订阅全局变量中string型的变量及各模块中string型的参数。

• 自适应：可设置运行界面实际使用中，最大化窗口时，字符控件是否等比例放大。

• 字体：可设置字符控件文字使用的字体、大小及字形。

• 宽度：可调整字符控件的宽度，也可通过预览及编辑区实时调整。

• 背景/字体颜色：可分别设置字符控件背景以及字体的颜色。

• 边距：可调整字符控件的位置，也可通过预览及编辑区实时调整。

信号灯

信号灯控件可实时显示模块状态。

信号灯控件可根据订阅的模块状态判断控件显示为绿色或红色，0显示为红色，1显示为绿色。

参数具体如下：

• 数据源：可订阅各模块的模块状态。

• 信号灯内容：可自定义信号灯控件显示的内容。

• 尺寸：可调整信号灯的大小，也可通过预览及编辑区实时调整。

• 边距：可调整信号灯的位置，也可通过预览及编辑区实时调整。

条件信号灯

信号灯控件可根据订阅的数据以及设置的条件，判断控件显示何种颜色。

参数具体如下：

• 参数类型：可选择订阅的数据类型，可选intType或floatType。

• 数据源：可订阅各模块或全局变量的int或float型参数。订阅的参数类型，与参数类型有关。

• 圆角半径：可设置条件信号灯四个角的圆角半径，控制控件形状。

• 默认值边框颜色/默认值背景颜色：可分别设置订阅的数值为默认值时条件信号灯的边框/背景颜色。

  说明：

  ＞值以及＜值时也需设置对应的边框和背景颜色，功能和参数方法大同小异，此处不再赘述。

• ＞值阈值/＜值阈值：需分别大于和小于对应的判断数值。

  说明：

  默认值无需设置，对应为同时不符合＞值以及＜值要求的数值。

• 自适应：可设置运行界面实际使用中，最大化窗口时，条件信号灯是否等比例放大。

• 尺寸：可调整条件信号灯的大小，也可通过预览及编辑区实时调整。

• 边距：可调整条件信号灯的位置，也可通过预览及编辑区实时调整。

图片

图片控件可添加本地图片在运行界面上显示。

参数具体如下：

• 自适应：可设置运行界面实际使用中，最大化窗口时，图片是否等比例放大。

• 图像：可加载本地图像，在运行界面显示。

• 尺寸：可调整条件信号灯的大小，也可通过预览及编辑区实时调整。

• 拉伸模式：可设置图片在控件中的显示，可选None、Fill、Uniform和UniformToFill。

• 背景/边框颜色：可分别设置图片背景和边框的颜色。

• 边框厚度：可设置图片的边框厚度。

• 边距：可调整条件信号灯的位置，也可通过预览及编辑区实时调整。

组合框

当运行界面有较多控件时，可使用组合框控件将多个控件组合到一起。

将控件移入组合框的操作方法：鼠标选中某个控件并拖拽到组合框控件所在区域，当组合框左上角出现“Press "Alt" to Enter Container”的提示时，鼠标保持不动的同时按住Alt键，将控件放置到合适位置时松开鼠标和Alt键即可。

其他需设置参数具体如下：

• 自适应：可设置运行界面实际使用中，最大化窗口时，组合框控件是否等比例放大。

• 字体：可设置组合框控件文字使用的字体、大小及字形。

• 尺寸：可调整组合框控件的大小，也可通过预览及编辑区实时调整。

• 背景/边框颜色/字体颜色：可分别设置组合框控件背景、边框以及字体的颜色。

• 标题：可自定义设置组合框控件左上角的标题名称。

• 边距：可调整组合框控件的位置，也可通过预览及编辑区实时调整。

子界面

子界面控件可在运行界面中新增一个运行界面作为子界面呈现。点击子界面控件后弹出新的运行界面窗口。子界面中各个控件的使用与运行界面完全一致。此处不再赘述。

参数具体如下：

• 圆角半径：可设置在运行界面中子界面控件的圆角半径，控制控件形状。

• 编辑子界面：点击后，预览及编辑区域切换为对子界面的设置。可通过预览及编辑区域上方对当前编辑的界面进行切换。

• 自适应：可设置运行界面实际使用中，最大化窗口时，子界面控件是否等比例放大。

• 字体：可设置子界面控件文字使用的字体、大小及字形。

• 显示图标：可设置子界面控件的字符信息前面是否显示。

• 尺寸：可调整子界面控件的大小，也可通过预览及编辑区实时调整。

• 密码：可设置打开子界面是否需要密码，以及具体的密码设置。默认无需密码。

• 字符信息：可自定义子界面控件的名称。

• 背景/字体颜色：可分别设置参数控件背景以及字体的颜色。

• 边距：可调整子界面控件的位置，也可通过预览及编辑区实时调整。

Tab页

Tab页控件可理解为多个组合框控件的组合，一个组合框对应一个Tab页。

其他需设置参数具体如下：

• Tab页数量：可设置Tab页数量。

• 数据源：点击后可自定义设置每个Tab页的名称。

• 自适应：可设置运行界面实际使用中，最大化窗口时，Tab页控件是否等比例放大。

• 字体：可设置Tab页控件文字使用的字体、大小及字形。

• 尺寸：可调整Tab页控件的大小，也可通过预览及编辑区实时调整。

• 边距：可调整Tab页控件的位置，也可通过预览及编辑区实时调整。

Root

运行界面的Root虽不是可添加的控件，但每个运行界面都存在。

参数具体如下：

• 窗口置顶：可设置运行界面打开时是否默认将窗口置顶。

• 窗口拖动：可设置运行界面打开时是否默认可以拖动窗口。

• 最大化隐藏任务栏：可设置运行界面最大化显示时，是否隐藏Windows系统桌面的任务栏。

• 标题：可自定义运行界面窗口左上角名称。

• 标题栏颜色/背景：可分别设置运行界面标题栏以及背景的颜色。

• 尺寸：可调整背景的大小，也可通过预览及编辑区实时调整。