当前位置：首页 > article >正文

【Godot】Viewpoint

article 2025/3/18 23:41:41

（参考自deepseek回答）
在 Godot 引擎中，Viewport 是一个非常重要的类，用于管理渲染内容和场景的显示。它充当一个独立的渲染容器，可以包含 2D 或 3D 场景，并将其渲染到屏幕或纹理上。Viewport 是 Godot 中实现分屏、画中画、渲染到纹理等高级功能的核心组件。

1. Viewport 的定义

Viewport 继承自 Node，是一个独立的渲染容器。
它可以包含一个场景（2D 或 3D），并将其渲染到屏幕或纹理上。
Viewport 可以嵌套在其他 Viewport 中，形成复杂的渲染管线。

2. Viewport 的核心功能

渲染场景：
- Viewport 可以包含一个场景（通过 scene 属性设置），并将其渲染到屏幕或纹理上。
- 它支持 2D 和 3D 渲染。
渲染目标：
- Viewport 可以将渲染结果输出到：
  - 屏幕（作为主视口）。
  - 纹理（用于后期处理、画中画等效果）。
分辨率控制：
- Viewport 可以设置独立的分辨率（size 属性），与主窗口分辨率无关。
- 通过 render_target_v_flip 属性可以控制纹理的垂直翻转。
后期处理：
- Viewport 支持自定义着色器（Shader），用于实现后期处理效果（如模糊、色彩校正等）。
多视口支持：
- Godot 支持多个 Viewport，用于实现分屏、画中画等效果。

3. Viewport 的常见用途

分屏游戏：
- 使用多个 Viewport 实现分屏效果（如双人游戏）。
画中画：
- 将一个小场景渲染到纹理，并显示在主场景中。
渲染到纹理：
- 将场景渲染到纹理，用于实现镜子、监控屏幕等效果。
后期处理：
- 使用 Viewport 和着色器实现屏幕特效（如模糊、像素化等）。
UI 分离：
- 将 UI 渲染到单独的 Viewport，避免与游戏场景混合。

4. Viewport 的常用属性和方法

属性/方法	说明
`size`	`Viewport` 的分辨率（宽度和高度）。
`scene`	设置要渲染的场景。
`render_target_v_flip`	控制渲染到纹理时的垂直翻转。
`render_target_update_mode`	控制渲染目标的更新模式（如总是更新、手动更新等）。
`msaa`	设置多重采样抗锯齿（MSAA）级别。
`use_hdr`	是否启用高动态范围（HDR）渲染。
`get_texture()`	获取渲染目标的纹理（用于渲染到纹理）。
`set_size_override()`	设置 `Viewport` 的覆盖大小。

5. Viewport 的使用示例

示例 1：创建一个简单的 Viewport

extends Node2D

func _ready():
    var viewport = Viewport.new()
    viewport.size = Vector2(400, 300)
    add_child(viewport)
    
    var scene = load("res://MyScene.tscn").instance()
    viewport.add_child(scene)

示例 2：渲染到纹理并显示

extends Node2D

func _ready():
    var viewport = Viewport.new()
    viewport.size = Vector2(400, 300)
    viewport.render_target_v_flip = true
    add_child(viewport)
    
    var scene = load("res://MyScene.tscn").instance()
    viewport.add_child(scene)
    
    var texture_rect = TextureRect.new()
    texture_rect.texture = viewport.get_texture()
    texture_rect.rect_min_size = Vector2(400, 300)
    add_child(texture_rect)

示例 3：分屏游戏

extends Node

func _ready():
    var viewport1 = Viewport.new()
    viewport1.size = Vector2(400, 300)
    viewport1.render_target_v_flip = true
    add_child(viewport1)
    
    var scene1 = load("res://Player1Scene.tscn").instance()
    viewport1.add_child(scene1)
    
    var viewport2 = Viewport.new()
    viewport2.size = Vector2(400, 300)
    viewport2.render_target_v_flip = true
    add_child(viewport2)
    
    var scene2 = load("res://Player2Scene.tscn").instance()
    viewport2.add_child(scene2)
    
    var texture_rect1 = TextureRect.new()
    texture_rect1.texture = viewport1.get_texture()
    texture_rect1.rect_position = Vector2(0, 0)
    texture_rect1.rect_min_size = Vector2(400, 300)
    add_child(texture_rect1)
    
    var texture_rect2 = TextureRect.new()
    texture_rect2.texture = viewport2.get_texture()
    texture_rect2.rect_position = Vector2(400, 0)
    texture_rect2.rect_min_size = Vector2(400, 300)
    add_child(texture_rect2)