### Godot 中 SubViewport 和 Viewport 节点的区别及用法 #### 1. 定义与基本功能 `Viewport` 是一种特殊的渲染容器，能够捕获其内部的内容并将其作为纹理输出。它既可以用于2D也可以用于3D场景中的自定义渲染目标[^5]。而 `SubViewport` 实际上是一个不直接可见的辅助类，通常由 `SubViewportContainer` 使用来管理嵌套的视口逻辑。 - **Viewport**: 主要作用是提供一个独立的渲染上下文，可以包含自己的摄像机、灯光和其他任何类型的节点。它的典型用途包括但不限于制作迷你地图、后期处理特效以及将2D内容投射到3D空间中。 - **SubViewport (通过 SubViewportContainer)**: 更像是一个轻量级版本的 Viewport，主要用于简化复杂布局设计时多个相互隔离区域间的协作问题。当我们需要动态调整某个局部画面大小而不影响全局比例设定的时候就会考虑运用此类对象[^6]。 #### 2. 关键特性对比 | 特性 | Viewport | SubViewport via SubViewportContainer | |-------------------------|------------------------------------|-------------------------------------------| | 显示方式 | 可以被当作 Texture 输出 | 不会自动绘制；需借助父级 Container | | 摄像支持 | 支持内置 Camera | 同样支持 | | 更新模式控制 | 提供多种更新策略选项 | 继承自标准 Viewport | | GUI 层次管理能力 | 较强 | 相对有限 | #### 3. 示例代码片段 ##### 创建普通的 Viewport 场景 ```gdscript # 初始化一个新的 Viewport var vp = Viewport.new() vp.size = Vector2(256, 256) # 添加基础相机配置 var cam = Camera.new() cam.current = true vp.add_child(cam) self.add_child(vp) ``` ##### 构建基于 SubViewportContainer 的结构 ```gdscript # 新增一个 SubViewportContainer var svc = SubViewportContainer.new() svc.rect_size = Vector2(400, 300) # 获取关联的 SubViewport 并定制化设置 var svp = svc.get_sub_viewport() svp.size = svc.rect_size.copy() let cam2d = Camera2D.new(); cam2d.current=true; svp.root.add_child(cam2d); self.add_child(svc) ``` #### 4. 应用场景举例 - 当构建虚拟现实(VR)/增强现实(AR)应用程序时，可能要用到双目立体视觉效果，这时就可以分别针对左右眼分配不同的 Viewports 来达成目的。 - 在游戏开发过程中如果涉及到HUD（平视显示器）、仪表盘或者其他形式的信息面板，则非常适合采用 SubViewports 结合 Containers 方式来进行高效组织安排[^7]. ---