Files
godot-demo-projects/viewport/dynamic_split_screen/camera_controller.gd
Benjamin Navarro fe1ccaea77 [3.x] Add a 2D version of the dynamic split screen demo (#762)
* add a 2D version of the dynamic split screen demo

* refactor the dynamic split screen demo

 - both 2D and 3D scenes have the exact same hierarchy
 - a single camera_controller.gd script instead of one per mode
 - the third viewport for 2D mode has been removed
2025-10-02 17:03:12 -07:00

133 lines
5.0 KiB
GDScript

extends Node
# Handle the motion of both player cameras as well as communication with the
# SplitScreen shader to achieve the dynamic split screen effet
#
# Cameras are placed on the segment joining the two players, either in the middle
# if players are close enough or at a fixed distance from them if they are not.
# In the first case, both cameras being at the same location, only the view of
# the first one is used for the entire screen thus allowing the players to play
# on an unsplit screen.
# In the second case, the screen is split in two with a line perpendicular to the
# segment joining the two players.
#
# The points of customization are:
# max_separation: the distance between players at which the view starts to split
# split_line_thickness: the thickness of the split line in pixels
# split_line_color: color of the split line
# adaptive_split_line_thickness: if true, the split line thickness will vary
# depending on the distance between players, with a maximum of
# split_line_thickness. If false, the thickness will be constant and equal
# to split_line_thickness.
enum Mode {
Mode2D,
Mode3D
}
export(float) var max_separation = 20.0
export(float) var split_line_thickness = 3.0
export(Color, RGBA) var split_line_color = Color.black
export(bool) var adaptive_split_line_thickness = true
onready var main_viewport = $Main
onready var secondary_viewport = $Secondary
onready var level = main_viewport.get_node(@"Level")
onready var player1 = level.get_node(@"Player1")
onready var player2 = level.get_node(@"Player2")
onready var view = $View
onready var camera1 = main_viewport.get_node(@"Camera")
onready var camera2 = secondary_viewport.get_node(@"Camera")
onready var mode = Mode.Mode2D if camera1 is Camera2D else Mode.Mode3D
func _ready():
secondary_viewport.world_2d = main_viewport.world_2d
_on_size_changed()
_update_splitscreen()
get_viewport().connect("size_changed", self, "_on_size_changed")
view.material.set_shader_param("viewport1", main_viewport.get_texture())
view.material.set_shader_param("viewport2", secondary_viewport.get_texture())
func _process(_delta):
_move_cameras()
_update_splitscreen()
func _move_cameras():
var position_difference = _compute_position_difference_in_world()
var distance = clamp(_compute_horizontal_length(position_difference), 0, max_separation)
position_difference = position_difference.normalized() * distance
match mode:
Mode.Mode2D:
camera1.position = player1.position + position_difference / 2.0
camera2.position = player2.position - position_difference / 2.0
Mode.Mode3D:
camera1.translation.x = player1.translation.x + position_difference.x / 2.0
camera1.translation.z = player1.translation.z + position_difference.z / 2.0
camera2.translation.x = player2.translation.x - position_difference.x / 2.0
camera2.translation.z = player2.translation.z - position_difference.z / 2.0
func _update_splitscreen():
var screen_size = get_viewport().get_visible_rect().size
var player1_position
var player2_position
match mode:
Mode.Mode2D:
player1_position = (player1.position - camera1.position) / (camera1.zoom * screen_size) + Vector2(0.5, 0.5)
player2_position = (player2.position - camera2.position) / (camera2.zoom * screen_size) + Vector2(0.5, 0.5)
Mode.Mode3D:
player1_position = camera1.unproject_position(player1.translation) / screen_size
player2_position = camera2.unproject_position(player2.translation) / screen_size
var thickness
if adaptive_split_line_thickness:
var position_difference = _compute_position_difference_in_world()
var distance = _compute_horizontal_length(position_difference)
thickness = lerp(0, split_line_thickness, (distance - max_separation) / max_separation)
if thickness > 0:
thickness = clamp(thickness, 1, split_line_thickness)
else:
thickness = split_line_thickness
view.material.set_shader_param("split_active", _get_split_state())
view.material.set_shader_param("player1_position", player1_position)
view.material.set_shader_param("player2_position", player2_position)
view.material.set_shader_param("split_line_thickness", thickness)
view.material.set_shader_param("split_line_color", split_line_color)
# Split screen is active if players are too far apart from each other.
# Only the horizontal components (x/z in 3D, x/y in 2D) are used for distance computation
func _get_split_state():
var position_difference = _compute_position_difference_in_world()
var separation_distance = _compute_horizontal_length(position_difference)
return separation_distance > max_separation
func _on_size_changed():
var screen_size = get_viewport().get_visible_rect().size
main_viewport.size = screen_size
secondary_viewport.size = screen_size
view.material.set_shader_param("viewport_size", screen_size)
func _compute_position_difference_in_world():
return player2.position - player1.position if mode == Mode.Mode2D else player2.translation - player1.translation
func _compute_horizontal_length(vec):
return Vector2(vec.x, vec.y).length() if mode == Mode.Mode2D else Vector2(vec.x, vec.z).length()