ue57-camera-transform

UE 相机变换操作

安全地操作 UE 编辑器视口相机和 CameraActor 的位置与旋转。

⚠️ 仅适用于 Unreal Engine — 通过 run_ue_python 执行

---

⚠️ 关键陷阱：Rotator 参数顺序

这是相机总是转偏的根本原因。

unreal.Rotator 的位置参数顺序是 (roll, pitch, yaw)，而不是直觉上的 (pitch, yaw, roll)：

# ❌ 错误！位置参数顺序是 (roll, pitch, yaw)
r = unreal.Rotator(-15, 180, 0)
# 实际结果: pitch=180, yaw=0, roll=-15  ← 完全错位！

# ✅ 正确！始终使用关键字参数
r = unreal.Rotator(pitch=-15, yaw=180, roll=0)
# 实际结果: pitch=-15, yaw=180, roll=0  ← 符合预期

强制规则

1. 永远使用关键字参数 构造 unreal.Rotator：unreal.Rotator(pitch=, yaw=, roll=)
2. 永远不用位置参数 构造 Rotator（位置参数顺序是 roll, pitch, yaw，极易出错）
3. unreal.Vector 位置参数顺序 (x, y, z) 是正常的，可以用位置参数，但推荐关键字参数以保持一致性

Rotator 含义

分量	含义	轴	正方向
pitch	俯仰角（上下看）	Y轴	正=抬头，负=低头
yaw	偏航角（左右看）	Z轴	正=右转
roll	翻滚角（倾斜）	X轴	正=右倾

视口相机的 roll 通常应为 0，除非有特殊需求。如果读取到的 roll 不为 0，可能是之前的错误操作遗留。

---

基础操作

获取当前视口相机

import unreal

ues = unreal.UnrealEditorSubsystem()
location, rotation = ues.get_level_viewport_camera_info()

print(f"位置: x={location.x:.1f}, y={location.y:.1f}, z={location.z:.1f}")
print(f"旋转: pitch={rotation.pitch:.1f}, yaw={rotation.yaw:.1f}, roll={rotation.roll:.1f}")

设置视口相机位置和旋转

import unreal

ues = unreal.UnrealEditorSubsystem()

# 始终使用关键字参数！
new_location = unreal.Vector(x=0, y=0, z=500)
new_rotation = unreal.Rotator(pitch=-30, yaw=0, roll=0)

ues.set_level_viewport_camera_info(new_location, new_rotation)

仅移动视口相机（保持当前旋转）

import unreal

ues = unreal.UnrealEditorSubsystem()
_, current_rotation = ues.get_level_viewport_camera_info()

new_location = unreal.Vector(x=100, y=200, z=300)
ues.set_level_viewport_camera_info(new_location, current_rotation)

仅旋转视口相机（保持当前位置）

import unreal

ues = unreal.UnrealEditorSubsystem()
current_location, _ = ues.get_level_viewport_camera_info()

new_rotation = unreal.Rotator(pitch=-15, yaw=90, roll=0)
ues.set_level_viewport_camera_info(current_location, new_rotation)