175 lines
8.2 KiB
GDScript
175 lines
8.2 KiB
GDScript
extends SceneTree
|
|
|
|
## Headless M02 camera state, scene wiring and collision-policy regression.
|
|
|
|
const PLAYER_CONTROLLER_PATH := "res://src/scenes/player/third_person_wow_controller.gd"
|
|
const CAMERA_RIG_PATH := "res://src/scenes/player/third_person_camera_rig.gd"
|
|
const NO_COLLISION_POLICY_PATH := "res://src/scenes/player/no_camera_collision_policy.gd"
|
|
const REGRESSION_SCENE_PATH := "res://src/tests/scenes/player_input_regression.tscn"
|
|
const RUNTIME_SCENE_PATHS: Array[String] = [
|
|
"res://src/scenes/streaming/eastern_kingdoms_streaming.tscn",
|
|
"res://src/scenes/streaming/kalimdor_streaming.tscn",
|
|
]
|
|
|
|
|
|
class FixedDistanceCameraCollisionPolicy extends CameraCollisionPolicy:
|
|
var _fixed_distance_units: float
|
|
|
|
func _init(fixed_distance_units: float) -> void:
|
|
_fixed_distance_units = fixed_distance_units
|
|
|
|
func resolve_camera_distance(
|
|
_camera_pivot: Node3D,
|
|
_requested_distance_units: float
|
|
) -> float:
|
|
return _fixed_distance_units
|
|
|
|
|
|
func _initialize() -> void:
|
|
_run_verification.call_deferred()
|
|
|
|
|
|
func _run_verification() -> void:
|
|
var failures: Array[String] = []
|
|
var player := _instantiate_regression_player(failures)
|
|
if player != null:
|
|
_verify_initial_state(player, failures)
|
|
_verify_zoom_clamps(player, failures)
|
|
_verify_orbit_and_capture(player, failures)
|
|
_verify_collision_policy(player, failures)
|
|
player.free()
|
|
_verify_source_boundaries(failures)
|
|
_verify_scene_wiring(failures)
|
|
|
|
if not failures.is_empty():
|
|
for failure in failures:
|
|
push_error("THIRD_PERSON_CAMERA: %s" % failure)
|
|
quit(1)
|
|
return
|
|
|
|
print("THIRD_PERSON_CAMERA PASS state_cases=12 policy_cases=3 scenes=3 player_boundary=1")
|
|
quit(0)
|
|
|
|
|
|
func _instantiate_regression_player(failures: Array[String]) -> CharacterBody3D:
|
|
var packed_scene := load(REGRESSION_SCENE_PATH) as PackedScene
|
|
_expect_true(packed_scene != null, "regression scene loads", failures)
|
|
if packed_scene == null:
|
|
return null
|
|
var player := packed_scene.instantiate() as CharacterBody3D
|
|
_expect_true(player != null, "regression player instantiates", failures)
|
|
if player == null:
|
|
return null
|
|
root.add_child(player)
|
|
player.set_physics_process(false)
|
|
var camera_rig := player.get_node("CameraPivot") as ThirdPersonCameraRig
|
|
camera_rig.set_physics_process(false)
|
|
return player
|
|
|
|
|
|
func _verify_initial_state(player: CharacterBody3D, failures: Array[String]) -> void:
|
|
var camera_rig := player.get_node("CameraPivot") as ThirdPersonCameraRig
|
|
var camera := camera_rig.get_node("Camera3D") as Camera3D
|
|
_expect_near(camera_rig.yaw_radians, 0.0, "initial yaw", failures)
|
|
_expect_near(camera_rig.pitch_radians, deg_to_rad(-18.0), "initial pitch", failures)
|
|
_expect_near(camera_rig.requested_distance_units, 8.0, "initial requested distance", failures)
|
|
_expect_near(camera_rig.resolved_distance_units, 8.0, "initial resolved distance", failures)
|
|
_expect_near(camera_rig.position.y, 1.7, "initial pivot height", failures)
|
|
_expect_near(camera.position.z, 8.0, "initial camera local Z", failures)
|
|
_expect_near(camera.far, 50000.0, "camera far plane", failures)
|
|
_expect_true(camera_rig.godot_world_flight_movement_basis().is_equal_approx(camera_rig.global_basis), "flight basis is pivot basis", failures)
|
|
|
|
|
|
func _verify_zoom_clamps(player: CharacterBody3D, failures: Array[String]) -> void:
|
|
var camera_rig := player.get_node("CameraPivot") as ThirdPersonCameraRig
|
|
var zoom_in_event := _action_event(PlayerInputActions.CAMERA_ZOOM_IN, true)
|
|
for _step in range(20):
|
|
camera_rig.handle_camera_input(zoom_in_event)
|
|
_expect_near(camera_rig.requested_distance_units, 2.0, "minimum zoom clamp", failures)
|
|
for _step in range(30):
|
|
camera_rig.handle_camera_input(_action_event(PlayerInputActions.CAMERA_ZOOM_OUT, true))
|
|
_expect_near(camera_rig.requested_distance_units, 18.0, "maximum zoom clamp", failures)
|
|
|
|
|
|
func _verify_orbit_and_capture(player: CharacterBody3D, failures: Array[String]) -> void:
|
|
var camera_rig := player.get_node("CameraPivot") as ThirdPersonCameraRig
|
|
_expect_true(camera_rig.handle_camera_input(_action_event(PlayerInputActions.CAMERA_ROTATE, true)), "capture action consumed", failures)
|
|
_expect_true(camera_rig.is_mouse_captured, "mouse capture state", failures)
|
|
|
|
var mouse_motion := InputEventMouseMotion.new()
|
|
mouse_motion.relative = Vector2(100.0, -50.0)
|
|
_expect_true(camera_rig.handle_camera_input(mouse_motion), "captured mouse motion consumed", failures)
|
|
_expect_near(camera_rig.yaw_radians, -0.3, "orbit yaw", failures)
|
|
_expect_near(camera_rig.pitch_radians, deg_to_rad(-18.0) + 0.15, "orbit pitch", failures)
|
|
_expect_near(player.rotation.y, -0.3, "character follows orbit yaw", failures)
|
|
|
|
var clamp_up_motion := InputEventMouseMotion.new()
|
|
clamp_up_motion.relative = Vector2(0.0, -100000.0)
|
|
camera_rig.handle_camera_input(clamp_up_motion)
|
|
_expect_near(camera_rig.pitch_radians, deg_to_rad(35.0), "maximum pitch clamp", failures)
|
|
var clamp_down_motion := InputEventMouseMotion.new()
|
|
clamp_down_motion.relative = Vector2(0.0, 100000.0)
|
|
camera_rig.handle_camera_input(clamp_down_motion)
|
|
_expect_near(camera_rig.pitch_radians, deg_to_rad(-65.0), "minimum pitch clamp", failures)
|
|
|
|
camera_rig.handle_camera_input(_action_event(PlayerInputActions.CAMERA_ROTATE, false))
|
|
_expect_true(not camera_rig.is_mouse_captured, "mouse release state", failures)
|
|
|
|
|
|
func _verify_collision_policy(player: CharacterBody3D, failures: Array[String]) -> void:
|
|
var camera_rig := player.get_node("CameraPivot") as ThirdPersonCameraRig
|
|
var camera := camera_rig.get_node("Camera3D") as Camera3D
|
|
camera_rig.set_collision_policy(FixedDistanceCameraCollisionPolicy.new(3.0))
|
|
_expect_near(camera_rig.resolved_distance_units, 3.0, "fixed policy distance", failures)
|
|
_expect_near(camera.position.z, 3.0, "fixed policy camera transform", failures)
|
|
camera_rig.set_collision_policy(NoCameraCollisionPolicy.new())
|
|
_expect_near(camera_rig.resolved_distance_units, 18.0, "identity policy restores request", failures)
|
|
|
|
|
|
func _verify_source_boundaries(failures: Array[String]) -> void:
|
|
var player_source := _read_text(PLAYER_CONTROLLER_PATH, failures)
|
|
for forbidden_text in ["var _captured", "var _yaw", "var _pitch", "func _apply_camera_transform", "camera_distance"]:
|
|
_expect_true(not player_source.contains(forbidden_text), "player omits %s" % forbidden_text, failures)
|
|
_expect_true(player_source.contains("_camera_rig.handle_camera_input"), "player delegates camera input", failures)
|
|
|
|
var rig_source := _read_text(CAMERA_RIG_PATH, failures)
|
|
_expect_true(rig_source.contains("extends Node3D"), "camera rig owns pivot Node3D", failures)
|
|
for forbidden_text in ["ADTLoader", "TerrainQuery", "MoveIntent", "AnimationPlayer"]:
|
|
_expect_true(not rig_source.contains(forbidden_text), "camera rig omits %s" % forbidden_text, failures)
|
|
|
|
var no_collision_source := _read_text(NO_COLLISION_POLICY_PATH, failures)
|
|
for forbidden_text in ["intersect_ray", "direct_space_state", "PhysicsRayQueryParameters3D"]:
|
|
_expect_true(not no_collision_source.contains(forbidden_text), "baseline policy omits %s" % forbidden_text, failures)
|
|
|
|
|
|
func _verify_scene_wiring(failures: Array[String]) -> void:
|
|
for scene_path in RUNTIME_SCENE_PATHS + [REGRESSION_SCENE_PATH]:
|
|
var scene_source := _read_text(scene_path, failures)
|
|
_expect_true(scene_source.contains("third_person_camera_rig.gd"), "%s references camera rig" % scene_path, failures)
|
|
_expect_true(scene_source.contains('script = ExtResource("4_camera_rig")') or scene_source.contains('script = ExtResource("2_camera_rig")'), "%s wires CameraPivot script" % scene_path, failures)
|
|
|
|
|
|
func _action_event(action_name: StringName, is_pressed: bool) -> InputEventAction:
|
|
var input_event := InputEventAction.new()
|
|
input_event.action = action_name
|
|
input_event.pressed = is_pressed
|
|
return input_event
|
|
|
|
|
|
func _read_text(path: String, failures: Array[String]) -> String:
|
|
var file := FileAccess.open(path, FileAccess.READ)
|
|
if file == null:
|
|
failures.append("cannot open %s" % path)
|
|
return ""
|
|
return file.get_as_text()
|
|
|
|
|
|
func _expect_near(actual_value: float, expected_value: float, label: String, failures: Array[String]) -> void:
|
|
if absf(actual_value - expected_value) > 0.000001:
|
|
failures.append("%s expected %.6f, got %.6f" % [label, expected_value, actual_value])
|
|
|
|
|
|
func _expect_true(actual_value: bool, label: String, failures: Array[String]) -> void:
|
|
if not actual_value:
|
|
failures.append("%s expected true" % label)
|