所属产品: Mingcedar Studio DESIGNER

Scale 缩放 | Mingcedar Studio

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

首次发布 2026-10-25T12:48:42.58057972Z 最近更新 2026-10-25T12:48:42.580578778Z

<div class="manual-doc-article manual-doc-article-section"><h2 id="geometry-scale">几何: Scale 缩放</h2>

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

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

</article>

<h3 id="geometry-scale-item-2">使用方法：编辑器控件逐项说明</h3>

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

<ul>

<li>Behavior name：可编辑；Component name：只读。</li>

<li>Quality override / Override border by quality：按数据质量配置 Good、Bad 边框，与工艺数值超限分别处理。</li>

<li>JS functions...：向当前聚焦的表达式字段插入方法。</li>

<li>Source value：数值表达式，例如 ReadTagDouble("PLC_LINE01.TANK01.LEVEL", 0)。Condition 返回布尔值；false 表示跳过当前行为，不表示隐藏组件。</li>

<li>Source minimum / Source maximum：默认 0 / 100，对应表达式别名 ValueMin / ValueMax。</li>

<li>At limit minimum / At limit maximum：输入限制端点对应的缩放因子，新建 Scale 行为默认 0.5 / 1.5；液位填充示例需改为 0 / 1。Capture 按当前组件几何计算对应端点。</li>

<li>Limit minimum / Limit maximum：默认独立数值 0 / 100，是实际参与夹取和归一化的范围。需要跟随源范围时分别填写 ValueMin、ValueMax。</li>

<li>Moving edge：选 Top 时顶边移动、底边固定；选 Right 时右边移动、左边固定。</li>

<li>Save / Ctrl+S 校验并保存；Cancel / Esc 放弃本次修改。</li>

</ul>

<div class="manual-code" data-code-language="text"><div class="manual-code-toolbar"><span>Text</span><span class="manual-code-tools"><small>Text</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: Text">复制代码</button><span class="manual-code-status" role="status"></span></span></div><pre tabindex="0" class="docs-code-block shiki github-light" style="background-color:#fff;color:#24292e" tabindex="0"><code><span class="line"><span>// Source value</span></span>

<span class="line"><span>ReadTagDouble("PLC_LINE01.TANK01.LEVEL", 0)</span></span>

<span class="line"><span>// Source minimum / maximum: 0 / 100</span></span>

<span class="line"><span>// Limit minimum / maximum: ValueMin / ValueMax</span></span>

<span class="line"><span>// At limit minimum / maximum: 0 / 1</span></span>

<span class="line"><span>// Moving edge: Top</span></span></code></pre></div>

</article>

<h3 id="geometry-scale-item-3">Capture 按钮使用方法</h3>

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

<ul>

<li>先选 Moving edge，因为它决定用宽还是高、用哪条边来计算目标尺寸。</li>

<li>Top / Bottom 使用高度计算：Top 用原始底边减当前顶边，Bottom 用当前底边减原始顶边。</li>

<li>Left / Right 使用宽度计算：Left 用原始右边减当前左边，Right 用当前右边减原始左边。</li>

<li>原始宽高为 0、目标尺寸为负数、或当前选中的不是同一组件时，Capture 会警告并拒绝写入。</li>

<li>Capture 写入的是 0.### 格式的比例值；如果需要固定表达式，仍然可以手工覆盖 At limit minimum / At limit maximum。</li>

</ul>

</article>

<p>用于以尺寸表达数值，例如：</p>

<ul>

<li>液位填充：水箱里的填充块随液位百分比往上长，Moving edge 选 Top（底边固定）。</li>

<li>条形涨落：产量/负荷条随数值从一端生长，Moving edge 选生长方向那条边。</li>

<li>图标响应：图标尺寸随某个量值在 At limit minimum~At limit maximum 之间放大缩小，作为强弱提示。</li>

</ul>

</article>

<h3 id="geometry-scale-item-5">限制与常见问题</h3>

<p>使用 Scale 时需要注意以下事项：</p>

<ul>

<li>Moving edge 是“会动的边”，不是固定边：选 Top 表示顶边动、底边固定；选 Left 表示左边动、右边固定。要让某条边保持不动，就选它的对边。</li>

<li>At limit minimum / At limit maximum 填的是缩放因子，不是百分比：原尺寸是 1.0，不要填 100。</li>

<li>一个 Moving edge 只对应一个方向：选了 Right 就不要指望它同时向两侧缩放，固定边那侧不动。</li>

<li>当前 Scale 没有超限隐藏选项。Condition 为 false 只跳过缩放；需要隐藏时，应另配 State Color 或 Script Color 的 Visibility。</li>

<li>输入量程改变时同步核对 Limit minimum / Limit maximum；也可填写 ValueMin / ValueMax，让有效范围跟随源范围。</li>

</ul>

</article>

</div>

<strong>图示 1: Scale 编辑器</strong>

<p>把数值映射成缩放因子，用 Moving edge 决定哪条边动、哪条边固定。</p>

</figcaption>

</figure>

</div>