2D 和 3D 编辑器

概述

Godot 中的 2D 和 3D 编辑器作为专门的编辑器插件实现，它们操作不同类型的节点。2D 编辑器 (CanvasItemEditor) 处理继承自 CanvasItem 类的 2D 对象，而 3D 编辑器 (Node3DEditor) 处理继承自 Node3D 的对象。这两个编辑器共享通用的设计元素，但针对各自的维度进行了专门化。

核心编辑器组件图

来源

2D 编辑器 (CanvasItemEditor)

2D 编辑器能够操作场景中的 2D 对象。它提供了用于选择、移动、缩放和旋转对象的工具，以及用于精确放置的吸附功能。

结构和主要组件

CanvasItemEditor 是作为插件实现的，它扩展了 VBoxContainer 并为编辑 2D 对象提供了统一的界面。它包含用于操作 2D 对象的各种工具和控件、用于可视化场景的视口以及处理输入、选择和变换的系统。

2D 编辑器类结构

来源

工具和模式

2D 编辑器提供了多种操作对象的工具

工具	描述	实现
选择	通过单击选择对象	`_select_click_on_item()`
列表选择	显示光标下的对象列表	`_selection_result_pressed()`
移动	移动选定的对象	拖动操作
缩放	缩放选定的对象	带手柄的拖动操作
旋转	旋转选定的对象	围绕轴心的拖动操作
编辑轴心	更改对象的轴心点	直接操作
平移	移动视口	`_pan_callback()`
标尺	测量距离	使用标尺绘制

来源

吸附系统

2D 编辑器包含一个全面的吸附系统，以帮助精确放置对象

来源

选择和变换

2D 编辑器使用复杂的系统来选择和变换对象

选择通过 _get_canvas_items_at_pos() 和相关方法处理
变换时，原始状态通过 _save_canvas_item_state() 保存
变换后，使用 _commit_canvas_item_state() 提交更改
编辑器支持所有操作的撤销/重做

来源

3D 编辑器 (Node3DEditor)

3D 编辑器提供用于操作场景中 3D 对象的工具，具有多个视口、导航控件和变换 gizmos。

结构和视口

Node3DEditor 管理多个 Node3DEditorViewport 实例，以提供 3D 场景的不同视图（顶视图、前视图、侧视图和透视视图）。每个视口都有自己的相机、导航控件和渲染设置。

3D 编辑器类结构

来源

3D 编辑器提供了多种导航 3D 空间的方式

位置控件：用于移动相机位置
视角控件：用于调整相机方向
旋转控件：用于围绕对象旋转

这些控件作为专门的控件实现，它们响应鼠标和触摸输入来控制相机。

来源

Gizmos 系统

3D 编辑器使用 gizmos 系统来操作对象。Gizmos 为变换操作提供视觉手柄。

Gizmo 架构

来源

视觉着色器编辑器

虽然严格来说不是 2D 或 3D 编辑器，但视觉着色器编辑器是一个用于创建着色器的专用基于图的编辑器，它用于 2D 和 3D 渲染。

结构与组件

视觉着色器编辑器允许用户通过在图界面中连接节点来创建着色器

来源

节点类型和处理

视觉着色器系统支持不同的着色器类型和处理模式，具有广泛的节点类型

着色器类型	描述
顶点	处理顶点
片段	处理片段/像素
细体	处理光照计算
开始	用于粒子开始处理
进程	用于粒子更新处理
碰撞	用于粒子碰撞处理
Sky (天空)	用于天空着色器
Fog (雾)	用于雾效果

来源