Skip to content

构建单元概述

构建单元在 Virtools 中被称为 Building Block,社区简称 BB

BB 是脚本中的最小单元之一,它代表了一个 功能,并且能够提供多种执行方式,以及参数的输入输出。

输入输出

一个 BB 可以对应着四种输入输出:

  • 逻辑输入(位于左侧,一定有)
  • 逻辑输出(位于右侧,不一定有)
  • 值输入(上方三角形,不一定有)
  • 值输出(下方三角形,不一定有,另:上图中没有值输出)

当 BB 左侧的 任意输入口 被激活时,BB 会从其上方的 值输入口 读取参数,然后执行对应的功能(一般一个输入口对应一个具体的功能)。执行完毕后,将执行得到的结果放在下方的 值输出口(如果有),然后激活右侧的 逻辑输出口(如果有)。

注意

输入输出口并不是完全一对一地对应激活。虽然在下文的例子中,On 对应激活 Exit OnOff 对应激活 Exit Off,但不代表所有 BB 都有这样的对应关系。应根据输入输出口的名称与文档(如果有)进行脚本编写。

示例

例如下图是一个名为 Text Display 的 BB 的文档以及示意图,它的作用是在屏幕上显示文本:

bb_example

在这个例子中,若左侧 On 被激活,则 BB 会从上方读取参数,将文字显示在屏幕上。

参数共有 5 个,和图中的值输入口一一对应,具体如下表所示:

参数名称类型解释默认值
OffsetVector 2D位置(0, 0)
ColorColor颜色(255, 255, 255, 255)
Alignment-对齐方式Left
SizeInteger字体大小10
TextString要显示的文本

执行完毕后,右侧的 Exit On 口会被激活。如果它连接到了下一个 BB,那么下一个 BB 对应的输入口就会被激活。

Released under the MIT License.