Display Builder

1) 操作界面编辑器和Runtime

2）在EPICS edd/dm, medm, edm, ...想法上构建

3）与CS-Studio 'BOY'兼容性非常好

4）大约2015年在CS-Stdio/Eclipse中开始，现在在CS-Studio/Phoebus中

5) 从209年以Web Runtime获取。

示例：

SNS加速器

SNS线站

浏览这些示例

1） 启动CSS/Phoebus

2) 你的设置可能有一个菜单条目

3）如果没有，或者如果你想要检查和编辑这些示例：Application/Display/Examples/Install Example Display。

发送PV到其它工具

 环境菜单用PV打开其它工具

在编辑其中打开已有显示窗口

1） 环境菜单可以在编辑器中打开任何显示窗口

 2） 下载远程文件

创建新显示窗口

菜单Application->Display->New Display：输入一个带有.bob扩展名的名称。 

编辑一个显示窗口

 

 推荐用于编辑的设置

1） 选择一个顶层目录，例如在你安装了示例文件的位置。

2） 打开Application->Utility->File Brower

• 设置它为你的顶层目录
• 在File browser标签上，打开环境菜单，"Split Horizontal"，接着"Lock Pane"。

3） 菜单Window->Save Layout As .. "Editding"

4)   菜单Applications->Display->New Display：在你的顶层目录中创建新文件。

保持其简单

1） 添加一个部件

2） 输入标签的文本或者部件的PV名称

3） 结束

运行时，部件将

1） 显示用单位格式化的PV的值。

2） 指示警报，断开

3）显示带有PV名和值的工具提示

4） 从枚举PV读取组合框选项，从数值PV读取滑动条范围。

5） 当'控制'部件没有PV写访问时，被禁用。

扩展第一个显示窗口

1） 从调色板拖动一个"Text Update"到编辑窗口，输入PV名称"sim://ramp(1,10,1)"。注意：PV名称自动补全弹出。

 

 2） 添加一个"Boolean Button"：PV名"loc://test"

3) 添加"LED"：PV名"Ioc://test"。注意在PV历史中的名称。

4） 执行这个显示窗口。工具按钮或环境菜单。

PV名称

1） ca://some_pv_name：EPICS通道访问PV

2）some_pv_name：一般相同，由于"ca://"是默认的。

3） sim://sine：模拟的PV。见自动补全提示。

4）loc://x(4)：本地PV。见自动补全提示。

5）pva://x：EPICS pvAccess。

部件调额板

1） 显示所有可用的部件

• 为"Search"输入名称
• 悬浮鼠标见详细信息。
• 拖拽或者选项&拖动

 2） 类别

• 图形显示静态标签，图片，...
• monitors根据读取PV更新
• 控制读取一个PV以及写入这个PV
• 绘图趋于从一个或多个(waveform)PVs读取
• 结构体组部分，嵌入的子显示窗口

通过从其它Apps拖动/放置创建部件

带有PVs列表的邮件：

• 拖动那个文本到显示窗口编辑器
• 选择部件类型

 可支持：

文本 --> Label

文本 --> PV部件

图像文件 --> 图像部件

*.bob --> 嵌入的窗口显示部件

操作多个部件

显示窗口属性

 在显示窗口背景上点击，不选取部件，用于编辑整个显示窗口属性

1） Name：在标签卡中显示。

2） Macos：被在这个显示窗口中所有部件使用。

3） Grid Size：可以辅助放置部件。

部件属性

选取一个(或多个)部件来编辑它们的(共同)属性。

1） Search：要查找所要的属性。

2）  PV Name：对于大多数部件的最重要属性。

详细情况取决于部件类型。

部件公共属性

默认值一般是合理的：

1） 用PV设置的精度格式化

2） 显示由PV提供的单位

3）警报-敏感边界

4） 从PV获取项目(Combo, ...)

预定义的"named"颜色和字体

在需要时使用。

配置指定名称的颜色和字体

在项目开始时设置较好

部件注意事项

1） Text Entry，Text Update：对于"long string" waveform，设置格式=String。默认将显示数组。

2）LED，Boolean Button, CheckBox：

• Boolean PV
• 数值PV 0或非0(当"Bit"设成默认-1时)。
• 在一个数值PV中Bit(此时"Bit"设置成0，1，2，...）

3）Multi-State LED：

• 枚举或者数值PVs
• 默认为使用状态值0，1，2，3，...

4) Combo Box, Radio Button：

• 最合适枚举PV：输入PV名，完成。
• 另外，取消选取"Items from PV"并且输入项目。

Action Button

1） 添加ActionButton

2) 配置"Actions"属性，并且添加"Open Display"

3) 运行：点击按钮打开“其它”显示窗口。

在原则上，任何部件都由"Actions"。它们出现在这个部件的运行时环境菜单中。但对终端用户不明显，例如一个Label将有一个actions。

屏幕导航

1） Replace：

• 推荐的默认
• 如在web浏览器中允许前进/后退
• 使得打开的窗口最少

2） New Tab

• 用新的标签卡打开
• 允许指定的面板名称

3） New Windows：在新窗口中打开

4） 使用"Replace"，仍然可以使用：

• 环境菜单
• Control用于tab
• shift-control用于window

屏幕导航：标签卡

标签卡：

每个标签卡是在内存中，相同的*.bob

• 在选取时，立即出现
• 隐藏时，使用CPU和内存

导航标签卡：

在选取时，标签卡是从单独的*.bob被装载。

• 可能需要一点时间来装载
• 隐藏时不使用CPU和内存

宏

1）从以下传递宏给显示窗口

• 封闭的组或者标签卡部件
• 显示窗口
• 嵌入的部件容器或者装载这个显示窗口的动作
• Phoebus首选项

2） 要使用：$(NameOfMacro)或者${NameOfMacro}

3） 示例：

• PV Name: $(PV)        其中PV=TheFullPVName
• PV Name: Motor$(N) 其中N=1,2,3,...
• Width:：$(WID)        其中WID=200
• Visble：$(SHOW)     其中SHOW=true

宏的示例

创建一个以下结构的显示窗口层级：

1） 创建显示窗口"sub.bob"

• 添加一个Label部件，其Text属性设置为"Motor $(N)"
• 添加一个TextUpdate部件，其PV Name属性设置为"loc://pos$(N)(10)"
• 添加一个ActionButton部件，其PV Name属性设置为“loc://pos$(N)(10)”，并且Action属性设置为"Write PV"，值为20，其Text属性设置为"Write 20"。
• 复制上一步的按钮，更新设置其值为30，其Test属性设置为"Write 30"。

 2） 创建显示窗口"top.bob"

• ActionButton的Actions的Display Path设置成sub.bob的完整路径，宏名和宏值为N=1。
• 复制粘贴这个按钮，更新N=2.

 3）执行top.bob, 点击按钮。

 

宏

1） 默认值：$(MACRO=default)

允许单独测试，而不需要给这个显示窗口传递值。

2） 为Boolean输入宏

按"$"宏按钮，从下拉菜单选择有效选项或者输入一个宏

宏的使用顺序

当宏没有被定义时，它将使用：

1）部件属性

• 使用属性视图中工具提示中显示的内部属性名。
• 注意：工具提示通常被预设成"$(pv_name)\n$(pv_value)"
• Action Button有PV Name属性，不像在其它部件中直接使用PV name，而是在"Write PV"中时，PV名被预设成$(pv_name).
• Action Button文本被预设成"$(actions)"。

2） Java属性

$(os.name)

3） 环境变量

$(HOME), $(USER)

预定义的宏

1) $(DID)：唯一的显示窗口标识符，对每个显示窗口PVs有用，loc://x$(DID)(10)

2) $(DNAME)：显示窗口名称

组部件

1） 包含其它部件。

2） 可见作用：边界，名称。

3） 实际作用：

• 组可以为包含的组件定义宏。
• 在编辑器中组可以作为一个单元被移动，复制/粘贴。

组属性：

1） Name：在边框中显示。

2） Style："Group Box"用于指定边界。

3） Macros：被传递给被包含部件。

组编辑快捷方式

1） 选择部件

2） 环境菜单"Create Group"

3)  环境菜单"Remove Group"

嵌入的显示窗口

1） 在一个部件内托管一个完整的*.bob文件。

2） 允许从较小显示窗口组成更高级显示窗口。

• 每个设备的*.bob
• 在一个显示窗口中显示多个设备。

嵌入的显示窗口示例

创建如下的窗体结构：

1） 创建显示窗口“sub.bob”（或者使用之前创建的那个）

• 放置Label部件，text属性为"Motor $(N)"
• 放置TextUpdate部件，PV属性为"loc://pos$(N)(10)"

2）创建显示窗口"main.bob"：

• 嵌入的窗口文件，sub.bob, Macros N=1
• 复制/粘贴嵌入的显示窗口，更新N=2

3） 执行main.bob

 

 嵌入的显示窗口尺寸：

a) 嵌入的显示窗口尺寸：

• 将托管这个*.bob的部件的大小
• 由部件宽度和高度属性定义

b) 内容尺寸

• *.bob的尺寸
• 由显示窗口宽度和高度属性定义。

如果那些尺寸不同？

嵌入显示窗口的Resize选项

1） No Resize

2) Size content to filt widget

3) Size widget to fit content

No Resize通常最好。滚动条根据需要显示。

Resizing倒置奇怪的字体大小或者部超出它们的初始尺寸。

嵌入的显示窗口编辑

顶层资源

1） 见帮助，首选项设置

2）用"-settings /path/to/my_settings.ini"：

• 文件系统：使用NFS或"git pull"来发布文件。
• http: 所有用户总是看到相同文件的集合。

很多部件和属性

与更早的EPICS窗口显示工具比较：

1） 组部件替代了线条

2） LED替代了变化颜色的圆圈

3） Tab/Navigation Tabs替代了按钮，本地PVs，条件可见性

显示窗口描述含有：

1） 相关部件的组

2） LED用于二进制PV，不是颜色发生变化的圆圈

规则

1） 理想上，使用部件的内建功能

• 在TestUpdate, LED, ...中显示的PV值
• 通过边界指示的警报

2） 有时对例如隐藏一个部件有用，即是：根据PV改变可见性。

• 规则可以完成这个目标
• 但功能可能对需要维护一个显示窗口的下一个人不明显。

添加一条规则

1） 添加一个TextUpdate部件。

2） 设置PV为sim://ramp(0,10,1)

3) 打开部件的规则

4） 添加规则，命名它为"Hide"

5)  选择“Visible"属性

6） Add PV sim://ramp(0,10,1)

7) 添加布尔表达式"pv0>8"

8) 取消选择值

9) 运行

规则详解

1） 由至少一个PV触发：可以使用更多非触发PVs

2）表达式使用pv0, pv1, ..., pvStr0, pvStr1, ..来访问PVs的值。

3） 规则内部转成成Jython：使用预览来调试

4） ”else:..“设置属性为原来的值。

 脚本

1） 脚本被附加到了一个部件。

2） 由至少一个PV触发：可以使用多个非触发PVs

3） 用以下调用：

• pvs[]：请求的PVs的数组
• widget：部件

4） 脚本可以：

• 读和写接收到的PVs
• 设置部件属性
• 在显示窗口中定位其它部件
• 在产品中调用java代码
• 非常强大
• 导致一个不能维护糟糕情况

5） 每个*.bob文件一个脚本执行器，在后台线程中运行。

• 慢速的脚本不阻塞UI
• 一次每个显示窗口一个脚本：a）很多持续时间短的脚本；2）一个从不退出的脚本

规则 vs 脚本

1） 最终都在终端Jython代码中

2)    都应该是异常。普通显示窗口不需要它们。但是强大的，替代了单独的自定义Java/Python/C/C++程序。

3） 首选规则，因为它们描述含义，维护更容易。

何时使用脚本

1） 简单，容易记录，并且极大提高了UI。

2）会是其中之一，专用的，难以维护，单独的程序。用脚本，至少其集成进了操作UI。

示例：

1） 把标量PVs转成loc://waveform用于XYPlot中的参考

2）用基于config文件examples/template_and_script的50个部件填充显示窗口

3）添加来自web服务的信息到显示窗口

何时不使用脚本

1） 它增加了本应该位于IOC上的逻辑到了显示窗口

显示窗口应该只显示PVs并且允许用户写PVs

显示窗一定不做任何事情

2）你必须请求实现这个脚本的帮助：如果你不能实现它，你也不能维护它。

示例：

1） 当压力太高，打开解压阀。斜坡电源。如果某人关闭这个显示窗口？打开了两个显示窗口怎么办。

2）摆弄显示窗口中的某个东西：它不是视频游戏。

概要

Display Builder是强大的编辑器并且使用很多部件，宏等运行。

保持其简单：

1） 添加部件

2）输入Label的文本或者部件的PV名称。

3） 结束