几何与高阶用法 | Mingcedar Studio

Source value 是当前数值。Source minimum / Source maximum 提供 ValueMin / ValueMax 别名；Limit minimum / Limit maximum 决定实际归一化范围。MOVEMENT OUTPUT 中的 At limit minimum / At limit maximum 为端点位移；Move axis 选择水平或垂直方向。

• 先确认输入值可能落在哪个区间
• 再确认 0% 和 100% 分别对应移动距离
• 最后确定方向是 Horizontal 还是 Vertical

在 MOVEMENT OUTPUT 的 At limit maximum 中填写 shape.width 或 shape.height，使最大位移等于组件原始宽度或高度。向左或向上移动时使用负值。

• 水平移动一个宽度：shape.width
• 垂直移动一个高度：shape.height
• At limit minimum 通常填 0

At limit minimum: 0
At limit maximum: shape.width
Move axis: Horizontal

At limit maximum 填 shape.width * 2，可在有效输入范围上限处向右移动两个组件宽度。垂直位移使用 shape.height * 2。

• 向右：shape.width * 2
• 向左：-shape.width * 2
• 向下：shape.height * 2
• 向上：-shape.height * 2

At limit minimum: 0
At limit maximum: shape.width * 2
Move axis: Horizontal

位移字段支持数值表达式，例如 -shape.width、shape.width * 0.5 或 shape.height * 1.5。结果单位为画布距离，应与移动轴保持一致。

模板占位符只替换字符串。数值字段用 Number('<LIMIT>') 并校验有限值；布尔参数明确比较字符串。不要使用未加引号的 <变量>。

• 字符串值：'<TITLE>' 或 "<TITLE>"
• 数值参数：Number('<LIMIT>')
• 布尔参数：'<ENABLED>' === 'true'
• 普通表达式：shape.width * 2
• 不要把模板字符串直接作为数值结果

Hide outside input limits 在超出 Limit minimum / Limit maximum 时隐藏组件；未启用则夹取到端点。工艺超限用 Range Color 或 Script Color，Override border by quality 仅表示数据质量。

Rotation input 返回以度为单位的当前角度。Maximum angle 的绝对值定义允许范围：例如 90 对应 -90° 到 +90°。若数据源是百分比，应在 Rotation input 中显式换算为角度。

PIVOT POINT 提供 Center、Top、Bottom、Left、Right。支点应与实际转轴重合；底端固定的指针可选 Bottom，左侧铰接部件可选 Left。

当真实机械中心不在对象几何中心时，就不要默认 Center。比如指针底部固定、末端摆动，就更适合 Bottom；门板左侧铰接，就更适合 Left。

Hide outside angle range 控制超出允许角度时是否隐藏；未启用时角度限制在边界。工艺超限提示应使用独立颜色行为，质量边框仅表示数据质量。

At limit minimum / At limit maximum 为有效输入范围两端的缩放因子。0.5 表示原尺寸的一半，1 表示原尺寸，1.5 表示原尺寸的 1.5 倍。

Moving edge 选择随缩放移动的边，对边保持固定。液位填充向上增长应选 Top，使底边固定；向右增长的进度条应选 Right，使左边固定。

• Top：顶边移动、底边固定
• Bottom：底边移动、顶边固定
• Left：左边移动、右边固定
• Right：右边移动、左边固定

表达“长度变长或变短”时，优先用 Scale；表达“整个对象在页面上平移”时，优先用 Move。很多页面表达不清，是因为本应缩放的对象被配置成平移，或本应平移的对象被配置成缩放。

选择 Moving edge 后，在 PowerPoint 中仅拖动该边到目标尺寸，再点击端点旁的 Capture。编辑器计算比例并尝试恢复原始几何；不要平移整个组件来模拟缩放目标。

Source value、Rotation input 和各端点字段必须同步返回数值。可以直接调用 ReadTagDouble，或调用当前页 Page Script 中定义的换算函数。

同页复用的名称、量程和换算函数放 Page Script。函数若需要实时值，应在行为每次求值时调用读取方法；页面初始化时读取一次不会自动更新。

ValueMin、ValueMax 等几何字段别名只在对应求值上下文内使用。其他组件需要相同的结果时，应复用 Page Script 函数，不依赖另一条行为的局部变量。

文本、颜色和可见性使用相应行为。需要由用户操作调整布局时，可在 Click Script 中调用 setComponentLayout；避免同一组件的布局同时被脚本和几何行为反复覆盖。

当布局变化依赖多个输入、多个模板值或复杂条件组合时，脚本通常比堆叠大量几何参数更清晰。联动多个对象一起变化时，hqVisuDesigner.setComponentLayout() 会更直接。

拖动结果回写、对象成组平移、根据用户输入重新布置面板、根据模板值动态调整弹窗位置，这些都适合脚本方式。

此 Click Script 使用 getComponentData 的 left / top 读取源位置，用 setComponentLayout 的 x / y 设置位置。每次移至源位置右侧两个宽度处，不累计位移。

// Click Script
var data = hqVisuDesigner.getComponentData("GatePositionIndicator");
if (data) {
  hqVisuDesigner.setComponentLayout("GatePositionIndicator", {
    x: data.left + data.width * 2,
    y: data.top,
    angle: data.rotation || 0
  });
}