1. 项目概述为什么我们需要在Godot4中实现多窗口显示同一个场景在游戏开发、模拟器、数字孪生或者需要多视角监控的应用中一个非常常见的需求是将同一个游戏世界或3D场景同时显示在多个独立的窗口里。想象一下你正在开发一个赛车游戏主窗口是第一人称驾驶视角而第二个窗口可以是一个俯瞰整个赛道的“上帝视角”地图或者是一个显示车辆后视镜画面的小窗口。又或者你正在制作一个策略游戏主窗口是战场另一个窗口是详细的单位属性面板但这个面板需要实时渲染3D模型。这就是“多窗口显示同场景”要解决的核心问题。它不仅仅是简单的画面复制而是允许你从不同的摄像机、以不同的渲染设置如分辨率、抗锯齿、后期效果去观察和交互同一个物理世界。在Godot 4之前实现这种效果需要一些“黑魔法”比如手动复制视口纹理、处理复杂的渲染管线同步。Godot 4对窗口系统和渲染架构进行了重大重构特别是引入了更强大的Window节点和SubViewport节点使得多窗口渲染变得更加清晰和可控。简单来说这个项目就是探索如何在Godot 4引擎中高效、稳定地创建多个原生或嵌入式窗口并让它们共享并渲染同一个核心游戏场景同时保持性能开销在可接受范围内。这对于提升应用的沉浸感、信息展示效率以及开发调试的便利性都大有裨益。2. 核心思路与架构设计理解Godot 4的窗口与视口系统在动手之前我们必须先理清Godot 4中几个关键概念的关系这是整个方案的基石。2.1 核心节点Window、Viewport与SubViewportWindow节点这是Godot 4中全新的、重量级的节点。它代表了一个操作系统级别的窗口或嵌入到主窗口中的一个子窗口区域。每个Window节点都自带一个根Viewport。你可以像操作普通节点一样在场景树中创建、显示、隐藏、移动Window节点。这是实现多窗口功能的核心载体。Viewport视口它是渲染发生的画布。每个Window节点都包含一个根Viewport。Viewport决定了哪些节点会被渲染以及如何被渲染比如大小、HDR、MSAA等。我们通常说的“场景”就是被某个Viewport所渲染的节点子树。SubViewport节点这是一个可以放置在场景树中任意位置的节点它本身也是一个独立的Viewport。它的独特之处在于其渲染结果可以作为一个Texture2D资源被其他节点如Sprite2D、MeshInstance3D的材质使用。这是我们实现“同场景”的关键桥梁。2.2 实现方案选型两种主流路径基于以上概念我们可以设计出两种主流实现方案方案A主从视口 Window节点复制这是最直观、逻辑最清晰的方法。核心场景我们创建一个包含所有游戏逻辑、3D模型、物理世界的“主场景”。这个场景被添加到一个SubViewport节点下。这个SubViewport不直接显示它只负责“计算”和“渲染”世界状态到一张纹理上。显示窗口我们创建多个Window节点或使用主窗口。在每个Window的根Viewport下我们放置一个Camera3D节点和一个SubViewportContainer节点用于承载和显示SubViewport的纹理。纹理共享将同一个SubViewport的texture属性分别赋值给每个显示窗口中的Sprite3D用于3D场景或TextureRect用于2D UI的材质。这样所有窗口显示的都是SubViewport中渲染的同一帧画面。方案B场景实例化 独立渲染这种方法更传统每个窗口独立渲染一个场景实例。场景打包将核心游戏场景包含世界、角色等保存为一个PackedScene资源。窗口实例化为每个Window节点在运行时动态实例化instantiate()一份这个PackedScene并将其添加为该Window的子节点。状态同步由于每个窗口拥有独立的场景实例它们的游戏逻辑如物体位置、动画状态是隔离的。因此必须建立一个中心化的状态管理机制例如一个Autoload单例由它来驱动所有实例的状态同步。主逻辑更新中心状态每个窗口的场景实例在每一帧读取并应用这些状态。方案对比与选择特性方案A (主从视口)方案B (场景实例化)性能更优。场景只被渲染一次在SubViewport中多个窗口只是显示同一张纹理GPU开销低。较差。每个窗口都需要独立渲染整个场景GPU负载随窗口数量线性增长。内存较低。只有一份场景数据。较高。每个窗口都有一份完整的场景实例及其资源。实现复杂度中等。关键在于正确设置SubViewport和纹理传递。较高。需要精心设计状态同步逻辑避免不同步和竞争条件。灵活性较高。可以轻松为不同窗口设置不同的后期处理、抗锯齿等在显示窗口的Viewport上设置。但所有窗口的“世界内容”必须一致。极高。每个窗口可以完全独立渲染不同的内容例如一个窗口渲染3D另一个只渲染UI只要它们逻辑上需要同步的状态被管理起来。适用场景需要多个窗口观看同一视角或不同视角但共享同一世界状态的应用。如监控大屏、多视角观察、画中画。需要多个窗口独立运行完整游戏逻辑但共享核心规则和数据的应用。如分屏合作游戏每个玩家一个窗口、服务器-客户端观察模式。对于标题“多窗口显示同场景”其隐含需求通常是“观看同一个世界”而非“运行多份独立逻辑”。因此方案A主从视口在绝大多数情况下是更优、更高效的选择。下文将主要围绕方案A展开。注意事项选择方案A时一个常见的误解是认为输入如鼠标点击也需要在SubViewport中处理。实际上输入应该由显示窗口的根Viewport接收然后通过脚本逻辑映射到SubViewport内的虚拟坐标再传递给SubViewport中的场景。Godot的输入事件默认是发送到当前聚焦的Window的根Viewport。3. 方案A实战一步步构建主从视口多窗口系统让我们开始动手实现。我们将创建一个主窗口和至少一个子窗口共同显示一个3D场景。3.1 项目结构与场景设置创建主场景 (Main.tscn)根节点是一个Node命名为Main。添加一个SubViewport节点作为子节点命名为WorldViewport。这个节点将承载我们的游戏世界。在WorldViewport下添加一个Node3D作为根节点然后搭建你的3D场景。例如添加一个Camera3D命名为MainCamera、一个DirectionalLight3D和一个MeshInstance3D比如一个默认立方体。关键配置WorldViewportSize: 设置为你希望渲染的内部分辨率例如(1920, 1080)。这决定了渲染纹理的清晰度。Render Target - Update Mode: 设置为Always。确保每一帧都更新。Transparent Bg: 根据需求勾选。如果你希望背景透明用于画中画可以开启。MSAA: 可以在这里设置抗锯齿这只会影响SubViewport内部的渲染。创建显示窗口场景 (DisplayWindow.tscn)根节点是一个Window命名为DisplayWindow。设置其Title为“观察窗口”Initial Size为(800, 600)。在Window节点下Godot会自动创建一个根Viewport。在这个Viewport下添加一个Camera3D节点命名为DisplayCamera。这个相机只用于控制本窗口的观察视角不参与WorldViewport的渲染。你可以通过脚本控制它围绕场景旋转实现与主窗口不同的视角。添加一个SubViewportContainer节点命名为Container。将其Stretch属性设为true使其填满整个窗口。在Container下添加一个SubViewport节点命名为FinalViewport。这个视口用于最终合成。在FinalViewport下添加一个Node3D然后添加一个Sprite3D节点。我们将把WorldViewport的纹理贴到这个Sprite3D上使其像一个“屏幕”一样显示主世界。3.2 核心脚本连接纹理与处理窗口生命周期编写主场景脚本 (Main.gd) 这个脚本负责初始化子窗口并将WorldViewport的纹理传递出去。extends Node # 预加载显示窗口场景 export var display_window_scene: PackedScene # 存储创建的窗口实例防止被自动释放 var display_windows: Array[Window] [] func _ready(): # 等待一帧确保所有节点都已就绪 await get_tree().process_frame # 获取世界视口的纹理 var world_texture: ViewportTexture $WorldViewport.get_texture() # 创建第一个显示窗口 create_display_window(world_texture, Vector2i(100, 100)) # 可以创建更多窗口 # create_display_window(world_texture, Vector2i(950, 100)) func create_display_window(texture: ViewportTexture, position: Vector2i): if not display_window_scene: push_error(Display window scene is not assigned!) return var new_window: Window display_window_scene.instantiate() # 重要将新窗口添加为当前场景的子节点Godot会自动管理其生命周期 add_child(new_window) # 设置窗口位置 new_window.position position # 显示窗口 new_window.show() # 将世界纹理传递给新窗口 # 我们需要等待一帧确保新窗口内的节点树已构建完成 await get_tree().process_frame # 查找新窗口中的Sprite3D节点并设置纹理 var target_sprite: Sprite3D new_window.find_child(Sprite3D) if target_sprite: # 创建一个新的StandardMaterial3D并设置纹理 var material : StandardMaterial3D.new() material.albedo_texture texture # 对于Sprite3D通常需要关闭双面显示并设置正确的渲染优先级 material.cull_mode BaseMaterial3D.CULL_BACK material.render_priority 1 target_sprite.material_override material else: push_error(Could not find Sprite3D in the display window.) # 存储引用 display_windows.append(new_window) # 连接关闭请求信号以便在窗口关闭时清理资源 new_window.close_requested.connect(_on_display_window_close_requested.bind(new_window)) func _on_display_window_close_requested(window: Window): # 从数组中移除 display_windows.erase(window) # 销毁窗口节点 window.queue_free()编写显示窗口脚本 (DisplayWindow.gd) 这个脚本附在DisplayWindow.tscn的根Window节点上主要用于处理本窗口的视角控制。extends Window # 本窗口的相机用于控制观察视角 onready var display_camera: Camera3D $Viewport/DisplayCamera # 鼠标控制参数 var rotation_speed: float 0.005 var is_rotating: bool false var last_mouse_pos: Vector2 func _ready(): # 窗口获得焦点时可以捕获鼠标可选用于第一人称控制 # 这里我们实现一个简单的拖拽旋转 pass func _input(event: InputEvent): # 处理本窗口的输入事件控制本窗口的相机 if event is InputEventMouseButton: if event.button_index MOUSE_BUTTON_RIGHT: is_rotating event.pressed if event.pressed: last_mouse_pos event.position # 可选隐藏鼠标并锁定到窗口 # Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED) else: # Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE) pass elif event is InputEventMouseMotion and is_rotating: var delta event.position - last_mouse_pos last_mouse_pos event.position # 绕Y轴左右和X轴上下旋转相机 display_camera.rotate_y(-delta.x * rotation_speed) display_camera.rotate_object_local(Vector3.RIGHT, -delta.y * rotation_speed) # 限制上下旋转角度避免翻转 var current_rotation display_camera.rotation_degrees current_rotation.x clamp(current_rotation.x, -80, 80) display_camera.rotation_degrees current_rotation func _process(delta): # 可以在这里添加相机自动动画或其他逻辑 # 例如让相机缓慢环绕 # display_camera.rotate_y(delta * 0.1) pass3.3 关键配置与材质设置Sprite3D的设置在DisplayWindow.tscn中选中Sprite3D节点。Texture: 留空因为我们会通过脚本动态设置。Centered: 取消勾选使其中心位于原点。Offset: 设置为(0, 0, 0)。Billboard: 设置为Disabled。Pixel Size: 调整这个值来控制Sprite3D在3D空间中的大小。例如设置为0.01意味着纹理的一个像素对应世界空间的0.01单位。你需要根据WorldViewport的分辨率和期望的屏幕大小来调整。Transparent: 如果WorldViewport启用了透明背景这里需要勾选Alpha。DisplayCamera的设置将其Position设置为(0, 0, 5)使其在Sprite3D的前方。调整Near和Far裁剪平面以确保Sprite3D在视野内。FinalViewport的设置这个SubViewport的Size应该与Sprite3D的像素尺寸和WorldViewport的纹理尺寸相匹配以避免不必要的缩放失真。一个简单的做法是将其Size设置为与父Window的初始大小一致或按比例缩放。3.4 运行与测试在Main.tscn的Main节点上将Display Window Scene属性设置为DisplayWindow.tscn。运行主场景Main.tscn。你应该能看到主窗口可能只有游戏视图和一个弹出的子窗口。子窗口中显示着主世界的3D场景。在子窗口中右键拖拽可以旋转DisplayCamera从不同角度观察那个“屏幕”上的场景。而主窗口中的MainCamera视角是独立的。实操心得SubViewport的纹理更新存在一帧的延迟。如果你在WorldViewport中的场景有快速变化的逻辑比如物理模拟可能会在主窗口和子窗口之间观察到细微的延迟。对于大多数应用这无关紧要但如果需要绝对同步可以考虑使用RenderingServer帧同步机制但这属于高级话题。4. 方案B补充场景实例化与状态同步的实现要点虽然方案A是推荐方案但理解方案B有助于应对更复杂的需求。其核心挑战在于状态同步。4.1 创建中心化状态管理器 (GameState.gd)将其设置为Autoload自动加载单例这样所有场景实例都能访问。# GameState.gd (Autoload) extends Node # 定义需要同步的数据结构 var player_position: Vector3 Vector3.ZERO var player_rotation: float 0.0 var game_time: float 0.0 var score: int 0 # 使用信号来通知状态变化避免轮询 signal player_position_updated(new_position: Vector3) signal score_updated(new_score: int) func update_player_position(pos: Vector3): player_position pos player_position_updated.emit(pos) func update_score(delta: int): score delta score_updated.emit(score)4.2 修改主场景和窗口场景主场景不再使用SubViewport而是直接包含游戏世界节点。它的脚本负责更新GameState。# Main.gd extends Node3D onready var player: CharacterBody3D $Player func _process(delta): GameState.game_time delta GameState.update_player_position(player.global_position) # ... 其他逻辑更新GameState显示窗口场景每个Window的根下实例化一份完整的游戏场景PackedScene。# DisplayWindow.gd extends Window export var game_scene: PackedScene var game_instance: Node3D func _ready(): if game_scene: game_instance game_scene.instantiate() $Viewport.add_child(game_instance) # 连接状态同步信号 GameState.player_position_updated.connect(_on_player_position_updated) func _on_player_position_updated(new_pos: Vector3): # 找到本窗口实例中的玩家节点并更新其位置 var local_player game_instance.find_child(Player) as CharacterBody3D if local_player: local_player.global_position new_pos方案B的致命缺点除了性能问题物理模拟、粒子系统、随机数生成等具有副作用的操作在多个实例中会产生不一致的结果。你必须确保所有非确定性的逻辑都由GameState驱动或者使用MultiplayerSynchronizer类似的网络同步思路但这大大增加了复杂度。5. 高级技巧、优化与常见问题排查5.1 性能优化策略降低SubViewport分辨率如果子窗口很小没必要用1920x1080渲染WorldViewport。根据显示窗口的实际大小动态调整WorldViewport.size可以显著节省GPU资源。控制渲染频率如果某个观察窗口不需要60FPS可以将其SubViewport的Update Mode设置为When Visible或Once并在需要时手动调用$SubViewport.render_target_update_mode SubViewport.UPDATE_ONCE和$SubViewport.get_texture().update()。使用MultiMeshInstance3D进行合批如果WorldViewport中有大量重复的静态物体如树木、草丛使用MultiMeshInstance3D可以极大减少绘制调用。禁用不需要的渲染特性在WorldViewport或显示窗口的Viewport中根据需求禁用Disable 3D、MSAA、Screen Space AA、SSAO、Glow等后期处理效果。5.2 输入处理与坐标映射子窗口接收的输入事件如鼠标点击坐标是相对于该窗口的。如果你想点击子窗口中的物体来与WorldViewport中的场景交互需要进行坐标转换。# 在DisplayWindow.gd的_input函数中处理点击 func _input(event): if event is InputEventMouseButton and event.pressed and event.button_index MOUSE_BUTTON_LEFT: # 1. 将窗口坐标转换到FinalViewport的坐标 var viewport_local_pos $Viewport/Container/FinalViewport.get_final_transform().affine_inverse() * event.position # 2. 假设Sprite3D是1:1显示且位于原点我们可以将视口坐标视为UV坐标 var uv viewport_local_pos / $Viewport/Container/FinalViewport.size # 3. 将UV坐标映射到WorldViewport的纹理空间也是其内部2D坐标 var world_viewport_pos uv * $WorldViewport.size # 这里需要获取对WorldViewport的引用 # 4. 现在你可以用world_viewport_pos向主场景发送一个自定义信号或RPC # 让主场景在WorldViewport中处理这个点击例如发射一条射线。 GlobalSignals.emit_signal(world_clicked, world_viewport_pos)5.3 常见问题与解决方案速查表问题现象可能原因解决方案子窗口黑屏/不显示1.SubViewport的Update Mode不是Always。2. 纹理没有正确传递给Sprite3D的材质。3.Sprite3D不在DisplayCamera的视野内或缩放不对。4.WorldViewport内没有激活的相机。1. 检查并设置Update Mode。2. 打印get_texture()的返回值检查材质是否创建并赋值。3. 调整DisplayCamera的位置和Sprite3D的Pixel Size。4. 确保WorldViewport内有一个Camera3D且Current属性为真。子窗口画面模糊Sprite3D的Pixel Size与WorldViewport的Size和窗口显示尺寸不匹配导致纹理被拉伸过滤。计算合适的Pixel Size。公式Sprite3D世界尺寸 ≈ (WorldViewport.size*pixel_size)。或使用ViewportTexture的update_mode属性。输入无效或错乱输入事件被错误的Viewport处理或坐标映射错误。确认_input函数写在正确的Window或Control节点上。使用get_viewport().get_mouse_position()获取正确坐标并仔细进行坐标转换。内存泄漏窗口关闭不释放创建的Window实例没有被正确引用和管理。确保将创建的Window添加为场景树的子节点add_child()并在close_requested信号中调用queue_free()。主窗口和子窗口内容不同步方案A中WorldViewport的纹理更新有延迟。方案B中状态同步逻辑有bug。方案A这是正常的一帧延迟对于非竞技类应用可接受。如需减少可尝试使用RenderingServer的同步机制。方案B检查GameState的信号是否正确连接和发射确保数据流是单向和确定的。多窗口拖动卡顿每个窗口都在独立渲染GPU负载过高。采用方案A。优化WorldViewport的渲染负载。降低非焦点窗口的渲染帧率。5.4 一个实用的调试技巧显示视口边框在开发时为每个SubViewport和SubViewportContainer添加一个带有颜色边框的ColorRect作为子节点可以直观地看到它们的范围和层级关系对于排查渲染问题非常有帮助。# 创建一个简单的调试函数 func add_debug_border_to_viewport(viewport_node: SubViewport, color: Color): var rect ColorRect.new() rect.color color rect.mouse_filter Control.MOUSE_FILTER_IGNORE # 设置锚点充满父节点 rect.set_anchors_preset(Control.PRESET_FULL_RECT) # 设置边距让边框可见 rect.set_offsets_preset(Control.PRESET_FULL_RECT, Control.PRESET_MODE_KEEP_SIZE, 2) viewport_node.add_child(rect)实现Godot 4的多窗口同场景显示方案A以其高性能和清晰的架构成为首选。关键在于理解SubViewport作为“渲染服务器”ViewportTexture作为“视频流”而多个Window节点则是“客户端显示器”这一模型。通过精细控制纹理传递、视口配置和输入映射你可以构建出从简单的监控视图到复杂的多屏模拟驾驶舱等各种应用。
1. 项目概述为什么我们需要在Godot4中实现多窗口显示同一个场景在游戏开发、模拟器、数字孪生或者需要多视角监控的应用中一个非常常见的需求是将同一个游戏世界或3D场景同时显示在多个独立的窗口里。想象一下你正在开发一个赛车游戏主窗口是第一人称驾驶视角而第二个窗口可以是一个俯瞰整个赛道的“上帝视角”地图或者是一个显示车辆后视镜画面的小窗口。又或者你正在制作一个策略游戏主窗口是战场另一个窗口是详细的单位属性面板但这个面板需要实时渲染3D模型。这就是“多窗口显示同场景”要解决的核心问题。它不仅仅是简单的画面复制而是允许你从不同的摄像机、以不同的渲染设置如分辨率、抗锯齿、后期效果去观察和交互同一个物理世界。在Godot 4之前实现这种效果需要一些“黑魔法”比如手动复制视口纹理、处理复杂的渲染管线同步。Godot 4对窗口系统和渲染架构进行了重大重构特别是引入了更强大的Window节点和SubViewport节点使得多窗口渲染变得更加清晰和可控。简单来说这个项目就是探索如何在Godot 4引擎中高效、稳定地创建多个原生或嵌入式窗口并让它们共享并渲染同一个核心游戏场景同时保持性能开销在可接受范围内。这对于提升应用的沉浸感、信息展示效率以及开发调试的便利性都大有裨益。2. 核心思路与架构设计理解Godot 4的窗口与视口系统在动手之前我们必须先理清Godot 4中几个关键概念的关系这是整个方案的基石。2.1 核心节点Window、Viewport与SubViewportWindow节点这是Godot 4中全新的、重量级的节点。它代表了一个操作系统级别的窗口或嵌入到主窗口中的一个子窗口区域。每个Window节点都自带一个根Viewport。你可以像操作普通节点一样在场景树中创建、显示、隐藏、移动Window节点。这是实现多窗口功能的核心载体。Viewport视口它是渲染发生的画布。每个Window节点都包含一个根Viewport。Viewport决定了哪些节点会被渲染以及如何被渲染比如大小、HDR、MSAA等。我们通常说的“场景”就是被某个Viewport所渲染的节点子树。SubViewport节点这是一个可以放置在场景树中任意位置的节点它本身也是一个独立的Viewport。它的独特之处在于其渲染结果可以作为一个Texture2D资源被其他节点如Sprite2D、MeshInstance3D的材质使用。这是我们实现“同场景”的关键桥梁。2.2 实现方案选型两种主流路径基于以上概念我们可以设计出两种主流实现方案方案A主从视口 Window节点复制这是最直观、逻辑最清晰的方法。核心场景我们创建一个包含所有游戏逻辑、3D模型、物理世界的“主场景”。这个场景被添加到一个SubViewport节点下。这个SubViewport不直接显示它只负责“计算”和“渲染”世界状态到一张纹理上。显示窗口我们创建多个Window节点或使用主窗口。在每个Window的根Viewport下我们放置一个Camera3D节点和一个SubViewportContainer节点用于承载和显示SubViewport的纹理。纹理共享将同一个SubViewport的texture属性分别赋值给每个显示窗口中的Sprite3D用于3D场景或TextureRect用于2D UI的材质。这样所有窗口显示的都是SubViewport中渲染的同一帧画面。方案B场景实例化 独立渲染这种方法更传统每个窗口独立渲染一个场景实例。场景打包将核心游戏场景包含世界、角色等保存为一个PackedScene资源。窗口实例化为每个Window节点在运行时动态实例化instantiate()一份这个PackedScene并将其添加为该Window的子节点。状态同步由于每个窗口拥有独立的场景实例它们的游戏逻辑如物体位置、动画状态是隔离的。因此必须建立一个中心化的状态管理机制例如一个Autoload单例由它来驱动所有实例的状态同步。主逻辑更新中心状态每个窗口的场景实例在每一帧读取并应用这些状态。方案对比与选择特性方案A (主从视口)方案B (场景实例化)性能更优。场景只被渲染一次在SubViewport中多个窗口只是显示同一张纹理GPU开销低。较差。每个窗口都需要独立渲染整个场景GPU负载随窗口数量线性增长。内存较低。只有一份场景数据。较高。每个窗口都有一份完整的场景实例及其资源。实现复杂度中等。关键在于正确设置SubViewport和纹理传递。较高。需要精心设计状态同步逻辑避免不同步和竞争条件。灵活性较高。可以轻松为不同窗口设置不同的后期处理、抗锯齿等在显示窗口的Viewport上设置。但所有窗口的“世界内容”必须一致。极高。每个窗口可以完全独立渲染不同的内容例如一个窗口渲染3D另一个只渲染UI只要它们逻辑上需要同步的状态被管理起来。适用场景需要多个窗口观看同一视角或不同视角但共享同一世界状态的应用。如监控大屏、多视角观察、画中画。需要多个窗口独立运行完整游戏逻辑但共享核心规则和数据的应用。如分屏合作游戏每个玩家一个窗口、服务器-客户端观察模式。对于标题“多窗口显示同场景”其隐含需求通常是“观看同一个世界”而非“运行多份独立逻辑”。因此方案A主从视口在绝大多数情况下是更优、更高效的选择。下文将主要围绕方案A展开。注意事项选择方案A时一个常见的误解是认为输入如鼠标点击也需要在SubViewport中处理。实际上输入应该由显示窗口的根Viewport接收然后通过脚本逻辑映射到SubViewport内的虚拟坐标再传递给SubViewport中的场景。Godot的输入事件默认是发送到当前聚焦的Window的根Viewport。3. 方案A实战一步步构建主从视口多窗口系统让我们开始动手实现。我们将创建一个主窗口和至少一个子窗口共同显示一个3D场景。3.1 项目结构与场景设置创建主场景 (Main.tscn)根节点是一个Node命名为Main。添加一个SubViewport节点作为子节点命名为WorldViewport。这个节点将承载我们的游戏世界。在WorldViewport下添加一个Node3D作为根节点然后搭建你的3D场景。例如添加一个Camera3D命名为MainCamera、一个DirectionalLight3D和一个MeshInstance3D比如一个默认立方体。关键配置WorldViewportSize: 设置为你希望渲染的内部分辨率例如(1920, 1080)。这决定了渲染纹理的清晰度。Render Target - Update Mode: 设置为Always。确保每一帧都更新。Transparent Bg: 根据需求勾选。如果你希望背景透明用于画中画可以开启。MSAA: 可以在这里设置抗锯齿这只会影响SubViewport内部的渲染。创建显示窗口场景 (DisplayWindow.tscn)根节点是一个Window命名为DisplayWindow。设置其Title为“观察窗口”Initial Size为(800, 600)。在Window节点下Godot会自动创建一个根Viewport。在这个Viewport下添加一个Camera3D节点命名为DisplayCamera。这个相机只用于控制本窗口的观察视角不参与WorldViewport的渲染。你可以通过脚本控制它围绕场景旋转实现与主窗口不同的视角。添加一个SubViewportContainer节点命名为Container。将其Stretch属性设为true使其填满整个窗口。在Container下添加一个SubViewport节点命名为FinalViewport。这个视口用于最终合成。在FinalViewport下添加一个Node3D然后添加一个Sprite3D节点。我们将把WorldViewport的纹理贴到这个Sprite3D上使其像一个“屏幕”一样显示主世界。3.2 核心脚本连接纹理与处理窗口生命周期编写主场景脚本 (Main.gd) 这个脚本负责初始化子窗口并将WorldViewport的纹理传递出去。extends Node # 预加载显示窗口场景 export var display_window_scene: PackedScene # 存储创建的窗口实例防止被自动释放 var display_windows: Array[Window] [] func _ready(): # 等待一帧确保所有节点都已就绪 await get_tree().process_frame # 获取世界视口的纹理 var world_texture: ViewportTexture $WorldViewport.get_texture() # 创建第一个显示窗口 create_display_window(world_texture, Vector2i(100, 100)) # 可以创建更多窗口 # create_display_window(world_texture, Vector2i(950, 100)) func create_display_window(texture: ViewportTexture, position: Vector2i): if not display_window_scene: push_error(Display window scene is not assigned!) return var new_window: Window display_window_scene.instantiate() # 重要将新窗口添加为当前场景的子节点Godot会自动管理其生命周期 add_child(new_window) # 设置窗口位置 new_window.position position # 显示窗口 new_window.show() # 将世界纹理传递给新窗口 # 我们需要等待一帧确保新窗口内的节点树已构建完成 await get_tree().process_frame # 查找新窗口中的Sprite3D节点并设置纹理 var target_sprite: Sprite3D new_window.find_child(Sprite3D) if target_sprite: # 创建一个新的StandardMaterial3D并设置纹理 var material : StandardMaterial3D.new() material.albedo_texture texture # 对于Sprite3D通常需要关闭双面显示并设置正确的渲染优先级 material.cull_mode BaseMaterial3D.CULL_BACK material.render_priority 1 target_sprite.material_override material else: push_error(Could not find Sprite3D in the display window.) # 存储引用 display_windows.append(new_window) # 连接关闭请求信号以便在窗口关闭时清理资源 new_window.close_requested.connect(_on_display_window_close_requested.bind(new_window)) func _on_display_window_close_requested(window: Window): # 从数组中移除 display_windows.erase(window) # 销毁窗口节点 window.queue_free()编写显示窗口脚本 (DisplayWindow.gd) 这个脚本附在DisplayWindow.tscn的根Window节点上主要用于处理本窗口的视角控制。extends Window # 本窗口的相机用于控制观察视角 onready var display_camera: Camera3D $Viewport/DisplayCamera # 鼠标控制参数 var rotation_speed: float 0.005 var is_rotating: bool false var last_mouse_pos: Vector2 func _ready(): # 窗口获得焦点时可以捕获鼠标可选用于第一人称控制 # 这里我们实现一个简单的拖拽旋转 pass func _input(event: InputEvent): # 处理本窗口的输入事件控制本窗口的相机 if event is InputEventMouseButton: if event.button_index MOUSE_BUTTON_RIGHT: is_rotating event.pressed if event.pressed: last_mouse_pos event.position # 可选隐藏鼠标并锁定到窗口 # Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED) else: # Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE) pass elif event is InputEventMouseMotion and is_rotating: var delta event.position - last_mouse_pos last_mouse_pos event.position # 绕Y轴左右和X轴上下旋转相机 display_camera.rotate_y(-delta.x * rotation_speed) display_camera.rotate_object_local(Vector3.RIGHT, -delta.y * rotation_speed) # 限制上下旋转角度避免翻转 var current_rotation display_camera.rotation_degrees current_rotation.x clamp(current_rotation.x, -80, 80) display_camera.rotation_degrees current_rotation func _process(delta): # 可以在这里添加相机自动动画或其他逻辑 # 例如让相机缓慢环绕 # display_camera.rotate_y(delta * 0.1) pass3.3 关键配置与材质设置Sprite3D的设置在DisplayWindow.tscn中选中Sprite3D节点。Texture: 留空因为我们会通过脚本动态设置。Centered: 取消勾选使其中心位于原点。Offset: 设置为(0, 0, 0)。Billboard: 设置为Disabled。Pixel Size: 调整这个值来控制Sprite3D在3D空间中的大小。例如设置为0.01意味着纹理的一个像素对应世界空间的0.01单位。你需要根据WorldViewport的分辨率和期望的屏幕大小来调整。Transparent: 如果WorldViewport启用了透明背景这里需要勾选Alpha。DisplayCamera的设置将其Position设置为(0, 0, 5)使其在Sprite3D的前方。调整Near和Far裁剪平面以确保Sprite3D在视野内。FinalViewport的设置这个SubViewport的Size应该与Sprite3D的像素尺寸和WorldViewport的纹理尺寸相匹配以避免不必要的缩放失真。一个简单的做法是将其Size设置为与父Window的初始大小一致或按比例缩放。3.4 运行与测试在Main.tscn的Main节点上将Display Window Scene属性设置为DisplayWindow.tscn。运行主场景Main.tscn。你应该能看到主窗口可能只有游戏视图和一个弹出的子窗口。子窗口中显示着主世界的3D场景。在子窗口中右键拖拽可以旋转DisplayCamera从不同角度观察那个“屏幕”上的场景。而主窗口中的MainCamera视角是独立的。实操心得SubViewport的纹理更新存在一帧的延迟。如果你在WorldViewport中的场景有快速变化的逻辑比如物理模拟可能会在主窗口和子窗口之间观察到细微的延迟。对于大多数应用这无关紧要但如果需要绝对同步可以考虑使用RenderingServer帧同步机制但这属于高级话题。4. 方案B补充场景实例化与状态同步的实现要点虽然方案A是推荐方案但理解方案B有助于应对更复杂的需求。其核心挑战在于状态同步。4.1 创建中心化状态管理器 (GameState.gd)将其设置为Autoload自动加载单例这样所有场景实例都能访问。# GameState.gd (Autoload) extends Node # 定义需要同步的数据结构 var player_position: Vector3 Vector3.ZERO var player_rotation: float 0.0 var game_time: float 0.0 var score: int 0 # 使用信号来通知状态变化避免轮询 signal player_position_updated(new_position: Vector3) signal score_updated(new_score: int) func update_player_position(pos: Vector3): player_position pos player_position_updated.emit(pos) func update_score(delta: int): score delta score_updated.emit(score)4.2 修改主场景和窗口场景主场景不再使用SubViewport而是直接包含游戏世界节点。它的脚本负责更新GameState。# Main.gd extends Node3D onready var player: CharacterBody3D $Player func _process(delta): GameState.game_time delta GameState.update_player_position(player.global_position) # ... 其他逻辑更新GameState显示窗口场景每个Window的根下实例化一份完整的游戏场景PackedScene。# DisplayWindow.gd extends Window export var game_scene: PackedScene var game_instance: Node3D func _ready(): if game_scene: game_instance game_scene.instantiate() $Viewport.add_child(game_instance) # 连接状态同步信号 GameState.player_position_updated.connect(_on_player_position_updated) func _on_player_position_updated(new_pos: Vector3): # 找到本窗口实例中的玩家节点并更新其位置 var local_player game_instance.find_child(Player) as CharacterBody3D if local_player: local_player.global_position new_pos方案B的致命缺点除了性能问题物理模拟、粒子系统、随机数生成等具有副作用的操作在多个实例中会产生不一致的结果。你必须确保所有非确定性的逻辑都由GameState驱动或者使用MultiplayerSynchronizer类似的网络同步思路但这大大增加了复杂度。5. 高级技巧、优化与常见问题排查5.1 性能优化策略降低SubViewport分辨率如果子窗口很小没必要用1920x1080渲染WorldViewport。根据显示窗口的实际大小动态调整WorldViewport.size可以显著节省GPU资源。控制渲染频率如果某个观察窗口不需要60FPS可以将其SubViewport的Update Mode设置为When Visible或Once并在需要时手动调用$SubViewport.render_target_update_mode SubViewport.UPDATE_ONCE和$SubViewport.get_texture().update()。使用MultiMeshInstance3D进行合批如果WorldViewport中有大量重复的静态物体如树木、草丛使用MultiMeshInstance3D可以极大减少绘制调用。禁用不需要的渲染特性在WorldViewport或显示窗口的Viewport中根据需求禁用Disable 3D、MSAA、Screen Space AA、SSAO、Glow等后期处理效果。5.2 输入处理与坐标映射子窗口接收的输入事件如鼠标点击坐标是相对于该窗口的。如果你想点击子窗口中的物体来与WorldViewport中的场景交互需要进行坐标转换。# 在DisplayWindow.gd的_input函数中处理点击 func _input(event): if event is InputEventMouseButton and event.pressed and event.button_index MOUSE_BUTTON_LEFT: # 1. 将窗口坐标转换到FinalViewport的坐标 var viewport_local_pos $Viewport/Container/FinalViewport.get_final_transform().affine_inverse() * event.position # 2. 假设Sprite3D是1:1显示且位于原点我们可以将视口坐标视为UV坐标 var uv viewport_local_pos / $Viewport/Container/FinalViewport.size # 3. 将UV坐标映射到WorldViewport的纹理空间也是其内部2D坐标 var world_viewport_pos uv * $WorldViewport.size # 这里需要获取对WorldViewport的引用 # 4. 现在你可以用world_viewport_pos向主场景发送一个自定义信号或RPC # 让主场景在WorldViewport中处理这个点击例如发射一条射线。 GlobalSignals.emit_signal(world_clicked, world_viewport_pos)5.3 常见问题与解决方案速查表问题现象可能原因解决方案子窗口黑屏/不显示1.SubViewport的Update Mode不是Always。2. 纹理没有正确传递给Sprite3D的材质。3.Sprite3D不在DisplayCamera的视野内或缩放不对。4.WorldViewport内没有激活的相机。1. 检查并设置Update Mode。2. 打印get_texture()的返回值检查材质是否创建并赋值。3. 调整DisplayCamera的位置和Sprite3D的Pixel Size。4. 确保WorldViewport内有一个Camera3D且Current属性为真。子窗口画面模糊Sprite3D的Pixel Size与WorldViewport的Size和窗口显示尺寸不匹配导致纹理被拉伸过滤。计算合适的Pixel Size。公式Sprite3D世界尺寸 ≈ (WorldViewport.size*pixel_size)。或使用ViewportTexture的update_mode属性。输入无效或错乱输入事件被错误的Viewport处理或坐标映射错误。确认_input函数写在正确的Window或Control节点上。使用get_viewport().get_mouse_position()获取正确坐标并仔细进行坐标转换。内存泄漏窗口关闭不释放创建的Window实例没有被正确引用和管理。确保将创建的Window添加为场景树的子节点add_child()并在close_requested信号中调用queue_free()。主窗口和子窗口内容不同步方案A中WorldViewport的纹理更新有延迟。方案B中状态同步逻辑有bug。方案A这是正常的一帧延迟对于非竞技类应用可接受。如需减少可尝试使用RenderingServer的同步机制。方案B检查GameState的信号是否正确连接和发射确保数据流是单向和确定的。多窗口拖动卡顿每个窗口都在独立渲染GPU负载过高。采用方案A。优化WorldViewport的渲染负载。降低非焦点窗口的渲染帧率。5.4 一个实用的调试技巧显示视口边框在开发时为每个SubViewport和SubViewportContainer添加一个带有颜色边框的ColorRect作为子节点可以直观地看到它们的范围和层级关系对于排查渲染问题非常有帮助。# 创建一个简单的调试函数 func add_debug_border_to_viewport(viewport_node: SubViewport, color: Color): var rect ColorRect.new() rect.color color rect.mouse_filter Control.MOUSE_FILTER_IGNORE # 设置锚点充满父节点 rect.set_anchors_preset(Control.PRESET_FULL_RECT) # 设置边距让边框可见 rect.set_offsets_preset(Control.PRESET_FULL_RECT, Control.PRESET_MODE_KEEP_SIZE, 2) viewport_node.add_child(rect)实现Godot 4的多窗口同场景显示方案A以其高性能和清晰的架构成为首选。关键在于理解SubViewport作为“渲染服务器”ViewportTexture作为“视频流”而多个Window节点则是“客户端显示器”这一模型。通过精细控制纹理传递、视口配置和输入映射你可以构建出从简单的监控视图到复杂的多屏模拟驾驶舱等各种应用。
![[C++]内存管理：串顺序存储的内存回收](http://pic.xiahunao.cn/yaotu/[C++]内存管理：串顺序存储的内存回收)
