Godot：Control 节点的 Pivot、全局位置与对齐记录
Godot：Control 节点的 Pivot、全局位置与对齐记录
在做 UI 动画、旋转、缩放，或者让一个Control的“视觉中心”去贴另一个控件时，经常会碰到一个问题：
Control 的position代表的是左上角，不是 Pivot。
而rotation、scale又是围绕 Pivot 生效的，所以如果不先把 Pivot 的概念捋清楚，后面很容易在全局位置计算上绕晕。
这篇做一个完整记录。
Control 节点的 Pivot Offset 介绍
Control.pivot_offset表示这个控件的轴心点偏移。
默认情况下，Control的 Pivot 在左上角，也就是Vector2(0, 0)。
Godot 官方文档说明：
- 默认 Pivot 是左上角
rotation和scale都围绕这个 Pivot 生效- 如果把
pivot_offset设为size / 2，那么旋转和缩放就会围绕控件中心进行 ([Godot Engine documentation][1])
例如：
control.PivotOffset=control.Size/2;这样就相当于把 Pivot 放到了控件中心。
要特别注意：
position依然表示控件矩形左上角的位置，不会因为pivot_offset改变而变成“中心点位置”。官方文档明确写了，position对应的是矩形左上角，并且不受pivot_offset影响。([Godot Engine documentation][1])
Control 节点的 Pivot Offset Ratio 介绍
除了pivot_offset，Godot 还提供了pivot_offset_ratio。
它和pivot_offset表达的是同一件事，只不过：
pivot_offset是绝对像素偏移pivot_offset_ratio是相对比例
官方文档里说得很清楚：
Vector2(0, 0)表示左上角Vector2(1, 1)表示右下角Vector2(0.5, 0.5)表示中心点- 实际 Pivot 是
pivot_offset和pivot_offset_ratio的组合结果 ([Godot Engine documentation][1])
例如：
control.PivotOffsetRatio=newVector2(0.5f,0.5f);这表示将 Pivot 放到控件中心。
什么时候用 Ratio 更方便？
当控件尺寸会变化时，pivot_offset_ratio往往更自然。
例如：
- 想永远保持中心旋转：
(0.5, 0.5) - 想围绕底部中心缩放：
(0.5, 1.0) - 想围绕右上角旋转：
(1.0, 0.0)
这样不需要手动写size / 2或跟着尺寸变化重新计算像素值。
怎么以 Pivot 为位置中心移动
很多时候我们真正想做的不是“移动左上角”，而是：
让某个
Control的 Pivot 移动到目标位置。
但Control.GlobalPosition对应的仍然是矩形左上角，因此如果要“以 Pivot 为中心移动”，核心思路就是：
- 先算出当前 Pivot 的全局位置
- 再算出目标 Pivot 的全局位置
- 用它们的差值去修正
GlobalPosition
获取 Pivot 全局位置
如果你想拿到一个Control的 Pivot 在世界空间中的位置，可以这样写：
usingGodot;publicstaticclassControlExtend{publicstaticVector2GetGlobalPivotPosition(thisControlcontrol){returncontrol.GetGlobalTransform()*control.GetCombinedPivotOffset();}}这个写法的关键点是：
GetGlobalTransform()：拿到控件的全局变换GetCombinedPivotOffset()：拿到最终生效的 Pivot 偏移- 用全局变换去变换这个局部点，就能得到 Pivot 的全局位置
这个思路是对的，因为GetCombinedPivotOffset()表示的是：
“Pivot 在当前控件局部空间中的坐标”
而global_transform * 某个局部点的含义是：
“把这个局部点转换到全局空间”
所以：
control.GetGlobalTransform()*control.GetCombinedPivotOffset()得到的正是这个控件 Pivot 的全局位置。
将指定 Control 的 Pivot 贴近另一个 Control 的 Pivot
当你想让一个控件的 Pivot 与另一个控件的 Pivot 重合时，可以直接基于上面的函数做位移补偿：
usingGodot;publicstaticclassControlExtend{publicstaticvoidSetGlobalPivotTo(thisControlcontrol,Controlother){control.GlobalPosition+=other.GetGlobalPivotPosition()-control.GetGlobalPivotPosition();}publicstaticVector2GetGlobalPivotPosition(thisControlcontrol){returncontrol.GetGlobalTransform()*control.GetCombinedPivotOffset();}}思路很简单：
目标Pivot全局位置-当前Pivot全局位置得到一个差值向量，然后把这个差值加到GlobalPosition上。
这样修正的是控件左上角的位置，但结果是：
控件的 Pivot 会准确移动到目标 Pivot 上。
这在下面这些场景里很实用：
- UI 元素围绕中心吸附
- 两个控件做旋转中心对齐
- 装饰节点精确贴合按钮中心
- 拖拽时按 Pivot 对齐，而不是按左上角对齐
误区
global_transform * position != global_position
这是一个非常容易踩的坑。
很多人看到：
position是一个Vector2global_transform也是变换矩阵
就会下意识写出：
globalTransform*position并以为这会得到global_position。
其实通常不对。
为什么不对？
因为对于Control而言，position本身表示的是：
当前控件相对父节点的左上角偏移
而这个偏移，已经体现在当前控件自己的变换里了。
官方文档也明确说了：position表示的是控件矩形左上角相对父节点的位置。([Godot Engine documentation][1])
所以如果你再做：
global_transform*position意思就变成了：
把“当前控件局部空间中的某个点
position”再次转换到全局空间
这相当于又把本地偏移算了一遍，因此会出现“自己的平移被重复叠加一次”的问题。
也就是说：
global_transform * position不是“当前节点的全局位置”，而是“当前节点局部点position的全局位置”。
这两件事不是一回事。
正确理解方式
1）global_position表示什么？
global_position表示的是：
当前控件矩形左上角在全局空间中的位置
2）global_transform * local_point表示什么？
它表示的是：
当前控件局部空间中的某个点
local_point，转换到全局空间后的位置
所以：
global_transform*Vector2.Zero表示的是当前控件的局部原点的全局位置。
而：
global_transform*position表示的是把“局部点(position.x, position.y)”再转一次到全局空间。
这当然不等于global_position。
一个直观理解
假设某个Control：
- 本地
position = (100, 50) - 没有旋转
- 没有缩放
那么它的global_position可能就是(100, 50)（假设父节点没有额外变换）。
但此时：
global_transform*position就会变成类似：
(100,50)+(100,50)=(200,100)本质上是又加了一次自己的本地偏移。
所以一定要记住：
global_transform * 局部点
不是global_transform * 节点的position
这里的“局部点”应该是你想变换的那个点，比如：
Vector2.Zero：局部原点GetCombinedPivotOffset()：局部 Pivot 点size / 2：局部中心点（仅当 Pivot 正好也是中心时才相同）
最后总结
对于Control节点，可以记住这几条：
1.position代表的是矩形左上角
不是 Pivot，也不会因为修改pivot_offset而变化。([Godot Engine documentation][1])
2.rotation和scale围绕 Pivot 生效
默认 Pivot 在左上角，可以通过pivot_offset或pivot_offset_ratio调整。([Godot Engine documentation][1])
3.pivot_offset_ratio更适合做相对布局
例如Vector2(0.5, 0.5)可以稳定表示中心 Pivot。([Godot Engine documentation][1])
4. 获取 Pivot 全局位置的可靠方法
control.GetGlobalTransform()*control.GetCombinedPivotOffset()5. 想按 Pivot 对齐两个控件
不要直接对齐GlobalPosition，而要对齐两者的全局 Pivot 位置。
6. 一个重要误区
global_transform*position!=global_position因为这样会把节点自己的本地平移重复算一次。