Mingcedar

所属产品: Mingcedar Studio DESIGNER

Move：用数值映射对象位移 | Mingcedar Studio

Move 把一个输入值换算成一个方向上的位移。它适合对象整体移动，不适合对象自身变长或缩短。

首次发布 最近更新

<section id="move-detail" class="docs-block docs-block-intro docs-block-current"> <span class="section-kicker">Move</span> <h2>Move：用数值映射对象位移</h2> <p>Move 把一个输入值换算成一个方向上的位移。它适合对象整体移动，不适合对象自身变长或缩短。</p> <div class="docs-detail-list"> <article id="move-detail-item-1" class="docs-detail-row"> <strong>功能是什么</strong> <p>Move 读取一个数值，把这个数值按输入范围换算成百分比，再把百分比映射到 At limit minimum 和 At limit maximum 之间，最终让对象沿水平或垂直方向移动。</p> <ul> <li>0% 对应 At limit minimum</li><li>100% 对应 At limit maximum</li><li>中间值按比例移动</li> </ul> </article><article id="move-detail-item-2" class="docs-detail-row"> <strong>关键字段</strong> <p>Source value 返回数值；Limit minimum / Limit maximum 是实际换算范围；MOVEMENT OUTPUT 中的 At limit minimum / At limit maximum 为位移；Move axis 指定方向。</p> <ul> <li>Source value：数值表达式</li><li>Source minimum / Source maximum：源范围及别名</li><li>Limit minimum / Limit maximum：实际夹取和归一化范围</li><li>At limit minimum / At limit maximum：端点位移</li><li>Move axis：Horizontal 或 Vertical</li> </ul> </article><article id="move-detail-item-3" class="docs-detail-row"> <strong>源范围与输入限制</strong> <p>源范围仅提供 ValueMin / ValueMax 别名；输入限制默认独立为 0、100。要跟随源范围，分别将 Limit minimum / Limit maximum 设为 ValueMin / ValueMax。</p> <ul> <li>实际映射以 Limit minimum / Limit maximum 为准</li><li>未启用隐藏时，超限输入限制在端点</li><li>Hide outside input limits 控制超限时隐藏</li> </ul> </article><article id="move-detail-item-4" class="docs-detail-row"> <strong>支持写法</strong> <p>Offset 不是百分比，而是画布距离。可以写固定数字，也可以使用当前对象尺寸。</p> <ul> <li>向右移动一个对象宽度：shape.width</li><li>向左移动一个对象宽度：-shape.width</li><li>向下移动半个对象高度：shape.height * 0.5</li><li>向上移动两个对象高度：-shape.height * 2</li> </ul> <pre class="docs-code-block"><code>Source value = ReadTagDouble(&quot;&lt;PLC&gt;.&lt;POSITION_TAG&gt;&quot;, 0)

Source minimum = 0

Source maximum = 100

At limit minimum = 0

At limit maximum = shape.width

Move axis = Horizontal</code></pre> </article><article id="move-detail-item-5" class="docs-detail-row"> <strong>配置顺序</strong> <p>先确定来源 Tag 和量程，再确定移动方向，最后填写 Offset。配置完成后，再决定是否开启超限隐藏和质量边框。</p> <ul> <li>第一步：确认输入值和量程</li><li>第二步：选择 Horizontal 或 Vertical</li><li>第三步：填写 At limit minimum / At limit maximum</li><li>第四步：按需要开启 Hide outside input limits</li><li>第五步：按需要开启 Quality Border</li> </ul> </article><article id="move-detail-item-6" class="docs-detail-row"> <strong>适用和边界</strong> <p>滑块、行程、位置指示适合 Move。液位柱、进度条和填充条通常不应使用 Move，因为它们表达的是长度变化，应使用 Scale。</p> </article> </div> </section>