126 lines
2.9 KiB
GDScript
126 lines
2.9 KiB
GDScript
'''全局的相机管理器
|
||
|
||
======= 外部调用函数 =======
|
||
|
||
'''
|
||
extends Node
|
||
|
||
var _cached_player_camera: GlobalCamera
|
||
var _cached_anchors: Array[CameraAnchor] = []
|
||
var _current_anchor: CameraAnchor
|
||
var _switch_tween: Tween
|
||
|
||
## 玩家关卡内静态相机
|
||
const PLAYER_CAMERA_SCENE:= preload("res://_shared/camera/PlayerStaticCamera.tscn")
|
||
|
||
## 注册玩家相机
|
||
func register_player_camera(owner: Node) -> GlobalCamera:
|
||
if not _cached_player_camera:
|
||
_cached_player_camera = PLAYER_CAMERA_SCENE.instantiate() as GlobalCamera
|
||
|
||
if _cached_player_camera:
|
||
owner.add_child(_cached_player_camera)
|
||
|
||
return _cached_player_camera
|
||
|
||
## 外部获取玩家全局相机
|
||
func get_cached_camera() -> GlobalCamera:
|
||
return _cached_player_camera
|
||
|
||
|
||
## 注册一个相机锚点
|
||
func register_anchor(anchor: CameraAnchor) -> void:
|
||
if anchor in _cached_anchors:
|
||
return
|
||
_cached_anchors.append(anchor)
|
||
anchor.on_priority_change.connect(on_anchor_priority_changed)
|
||
_sort_anchors()
|
||
_try_auto_switch()
|
||
|
||
## 当相机锚点的权重改变时，向管理器触发事件
|
||
func on_anchor_priority_changed(priority:int, anchor: CameraAnchor) -> void:
|
||
if _current_anchor:
|
||
if _current_anchor._priority < priority:
|
||
_sort_anchors()
|
||
_try_auto_switch()
|
||
|
||
## 注销一个相机锚点
|
||
func unregister_anchor(anchor: CameraAnchor) -> void:
|
||
_cached_anchors.erase(anchor)
|
||
if _current_anchor == anchor:
|
||
_current_anchor = null
|
||
_try_auto_switch()
|
||
|
||
## 排序已有的锚点
|
||
func _sort_anchors() -> void:
|
||
_cached_anchors.sort_custom(func(a, b):
|
||
return a._priority > b._priority
|
||
)
|
||
|
||
## 尝试自切换
|
||
func _try_auto_switch() -> void:
|
||
for a in _cached_anchors:
|
||
if a.enabled:
|
||
switch_anchor(a)
|
||
_current_anchor = a
|
||
return
|
||
|
||
## 重置所有的Camera的_priority
|
||
func reset_all_camera_priority() -> void:
|
||
for a in _cached_anchors:
|
||
a._priority = 0
|
||
|
||
## 切换相机
|
||
func switch_anchor(target_anchor: CameraAnchor) -> void:
|
||
if target_anchor == null:
|
||
return
|
||
if target_anchor == _current_anchor:
|
||
return
|
||
if not is_instance_valid(_cached_player_camera):
|
||
return
|
||
|
||
# 中断旧 Tween
|
||
if _switch_tween and _switch_tween.is_running():
|
||
_switch_tween.kill()
|
||
_switch_tween = null
|
||
|
||
var camera := _cached_player_camera
|
||
var blend_time : float = max(target_anchor.blend_time, 0.001)
|
||
|
||
# 创建 Tween（关键：ignore time scale）
|
||
_switch_tween = get_tree().create_tween()
|
||
_switch_tween.set_ignore_time_scale(true)
|
||
_switch_tween.set_trans(Tween.TRANS_SINE)
|
||
_switch_tween.set_ease(Tween.EASE_OUT)
|
||
|
||
# ===== 位置 =====
|
||
_switch_tween.tween_property(
|
||
camera,
|
||
"global_position",
|
||
target_anchor.global_position,
|
||
blend_time
|
||
)
|
||
|
||
# ===== Zoom =====
|
||
_switch_tween.tween_property(
|
||
camera,
|
||
"zoom",
|
||
target_anchor.zoom,
|
||
blend_time
|
||
)
|
||
|
||
# ===== Offset =====
|
||
_switch_tween.tween_property(
|
||
camera,
|
||
"offset",
|
||
target_anchor.offset,
|
||
blend_time
|
||
)
|
||
|
||
# 完成回调
|
||
_switch_tween.finished.connect(func():
|
||
_current_anchor = target_anchor
|
||
)
|
||
|
||
_current_anchor = target_anchor
|