文档手册

Scale 缩放

将数值映射为组件尺寸，适用于数据条、液位填充和尺寸变化图标。

几何文档修订：2026-10-21

几何: Scale 缩放

将数值映射为组件尺寸，适用于数据条、液位填充和尺寸变化图标。

功能说明

在 Behavior Browser → Geometry 中将 Scale 拖到组件，以数值驱动缩放。

使用方法：编辑器控件逐项说明

当前 Scale 编辑器将 Source value 限制在 Limit minimum / Limit maximum 内，再按该区间映射到 At limit minimum / At limit maximum。输出为缩放因子，1 表示原尺寸。Source minimum / Source maximum 可通过 ValueMin / ValueMax 别名供限制字段引用；单独修改源范围不会自动改变两个限制值。

Behavior name：可编辑；Component name：只读。
Quality override / Override border by quality：按数据质量配置 Good、Bad 边框，与工艺数值超限分别处理。
JS functions...：向当前聚焦的表达式字段插入方法。
Source value：数值表达式，例如 ReadTagDouble("PLC_LINE01.TANK01.LEVEL", 0)。Condition 返回布尔值；false 表示跳过当前行为，不表示隐藏组件。
Source minimum / Source maximum：默认 0 / 100，对应表达式别名 ValueMin / ValueMax。
At limit minimum / At limit maximum：输入限制端点对应的缩放因子，新建 Scale 行为默认 0.5 / 1.5；液位填充示例需改为 0 / 1。Capture 按当前组件几何计算对应端点。
Limit minimum / Limit maximum：默认独立数值 0 / 100，是实际参与夹取和归一化的范围。需要跟随源范围时分别填写 ValueMin、ValueMax。
Moving edge：选 Top 时顶边移动、底边固定；选 Right 时右边移动、左边固定。
Save / Ctrl+S 校验并保存；Cancel / Esc 放弃本次修改。

// Source value
ReadTagDouble("PLC_LINE01.TANK01.LEVEL", 0)

// Source minimum / maximum: 0 / 100
// Limit minimum / maximum: ValueMin / ValueMax
// At limit minimum / maximum: 0 / 1
// Moving edge: Top

Capture 按钮使用方法

编辑器记录组件原始尺寸。在 PowerPoint 中调整同一组件后，点击对应端点的 Capture；编辑器按 Moving edge 计算“目标尺寸 / 原始尺寸”，写入缩放因子，再尝试恢复原始几何。

先选 Moving edge，因为它决定用宽还是高、用哪条边来计算目标尺寸。
Top / Bottom 使用高度计算：Top 用原始底边减当前顶边，Bottom 用当前底边减原始顶边。
Left / Right 使用宽度计算：Left 用原始右边减当前左边，Right 用当前右边减原始左边。
原始宽高为 0、目标尺寸为负数、或当前选中的不是同一组件时，Capture 会警告并拒绝写入。
Capture 写入的是 0.### 格式的比例值；如果需要固定表达式，仍然可以手工覆盖 At limit minimum / At limit maximum。

适用场景

用于以尺寸表达数值，例如：

液位填充：水箱里的填充块随液位百分比往上长，Moving edge 选 Top（底边固定）。
条形涨落：产量/负荷条随数值从一端生长，Moving edge 选生长方向那条边。
图标响应：图标尺寸随某个量值在 At limit minimum~At limit maximum 之间放大缩小，作为强弱提示。

限制与常见问题

使用 Scale 时需要注意以下事项：

Moving edge 是“会动的边”，不是固定边：选 Top 表示顶边动、底边固定；选 Left 表示左边动、右边固定。要让某条边保持不动，就选它的对边。
At limit minimum / At limit maximum 填的是缩放因子，不是百分比：原尺寸是 1.0，不要填 100。
一个 Moving edge 只对应一个方向：选了 Right 就不要指望它同时向两侧缩放，固定边那侧不动。
当前 Scale 没有超限隐藏选项。Condition 为 false 只跳过缩放；需要隐藏时，应另配 State Color 或 Script Color 的 Visibility。
输入量程改变时同步核对 Limit minimum / Limit maximum；也可填写 ValueMin / ValueMax，让有效范围跟随源范围。

Scale 缩放行为编辑器 — **图示 1: Scale 编辑器**
把数值映射成缩放因子，用 Moving edge 决定哪条边动、哪条边固定。