几何与高阶用法 | HQ VISU Designer

Input Value 是当前输入；Input Min / Input Max 是原始输入范围；Clamp Min / Clamp Max 是真正用于归一化的有效输入范围；Offset Min / Offset Max 是最终位移距离；Direction 负责决定走水平还是垂直方向。

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

如果“一个身位”指对象自身一个宽度或一个高度，最直接的写法就是把 Offset Max 写成 shape.width 或 shape.height。这样即使对象尺寸后来变了，位移规则仍然跟着对象自身尺寸走。

• 水平一个身位：shape.width
• 垂直一个身位：shape.height
• 向左或向上移动时加负号

Offset Min = 0
Offset Max = shape.width
Direction = Horizontal

如果要让对象最多移动两个自身宽度，可将 Offset Max 设置为 shape.width * 2。向左两个身位使用 -shape.width * 2；垂直两个身位对应 shape.height * 2。这种写法能随对象尺寸变化保持一致，维护成本较低。

• 向右两个身位：shape.width * 2
• 向左两个身位：-shape.width * 2
• 向下两个身位：shape.height * 2
• 向上两个身位：-shape.height * 2

Offset Min = 0
Offset Max = shape.width * 2
Direction = Horizontal

Move 不只支持整身位。可使用 -shape.width、shape.width * 0.5、shape.height * 1.5 这类表达式。一身位、两身位、半身位、反向两身位，本质上都属于表达式配置问题。

Move、Rotate、Scale 这类几何字段按 JavaScript 表达式规则填写。模板变量用于字符串时必须加引号；用于数值、布尔或计算表达式时，替换后的内容也必须符合该字段的结果类型。未加引号的 `<变量>` 不作为正式写法。

• 字符串值：'<TITLE>' 或 "<TITLE>"
• 数值表达式：120、shape.width * 2
• 布尔表达式：running === true
• 不要把字符串模板变量填入需要数值结果的字段

如果输入值超出有效范围后，这个对象应该直接消失，就打开 Hide if value exceeds limits；如果超限后对象仍应停在边界位置，只是描边提示异常，则不要简单隐藏，而是更适合结合 Quality Border 或后置脚本提示。

Current Angle 决定当前实际角度，Max Rotation 决定允许的最大旋转范围。推荐先确认源数据已经是角度值，还是需要换算后再使用。如果源数据本身就是角度值，不应再重复乘以角度系数。

Pivot 决定对象绕哪个点转。中心旋转最适合风机、马达类；顶部或底部旋转更适合指针、杆件；左侧或右侧旋转更适合铰接对象。看起来“旋转轨迹不对”的问题，往往优先不是角度错，而是 pivot 选错。

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

如果超出 Max Rotation 后就不应该再显示，可以打开 Hide if value exceeds limits；如果超限后仍想保留对象，但用边框提示异常，就更适合打开 Quality Border 并配好好坏颜色。

Scale Min / Scale Max 决定对象在输入最小值和最大值时的缩放系数。例如 0.5 表示缩到原来的一半，1.0 表示原样，1.5 表示放大到 1.5 倍。它不是像 Move 那样直接填距离，而是填比例。

如果 Anchor Edge = Right，表示右边固定、对象朝左边或远离右边的方向变化；如果 Anchor Edge = Bottom，表示底边固定、对象朝上或远离底边方向变化。这个思路特别适合液位条和增长条。

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

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

当对象尺寸本身也要被脚本感知时，Scale 很适合配合 Post Operations 使用。运行时会暴露 scaleFactor、width、height 等后置变量，用于在缩放之后做轻量样式跟进。

适合做轻量跟进，例如根据最终位置改变一个颜色、记录一次当前缩放值、根据当前角度切换一个状态类名。这类逻辑属于“几何完成后再补一点点”。

不适合在 Post Operations 里再手工做第二次 Move、Rotate 或 Scale。也不适合把主要业务计算都塞到这里。它应该是后置补充，不应该取代主几何规则。

当前运行时会给后置脚本准备一些别名，例如 pivotX、pivotY、scaleFactor、offsetX、offsetY、currentAngle、maxAngle。后置脚本可以拿到本次几何行为已经算出的关键结果。

主逻辑尽量写在几何行为主字段中，后置脚本只做补充。这样后续维护人员可以先从主字段理解位移、旋转或缩放的来源。

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

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

先取当前组件数据，再按业务规则计算新位置，最后回写需要调整的字段。这样脚本逻辑更容易理解。

var data = qtedit.getComponentData("Rectangle 1");
if (data) {
  qtedit.setComponentLayout("Rectangle 1", {
    x: data.x + data.width * 2,
    y: data.y,
    angle: data.rotation || 0
  });
}