diff --git a/docs/en/interface/viewport.mdx b/docs/en/interface/viewport.mdx index 3927d8b974..437dd0bfea 100644 --- a/docs/en/interface/viewport.mdx +++ b/docs/en/interface/viewport.mdx @@ -10,7 +10,7 @@ label: Basics/Interface The view window is an interactive interface used for selecting, positioning, and changing various types of entities and components in the current scene. - + ## Browsing the Scene @@ -21,7 +21,7 @@ There are two ways to browse the scene: standard mode and flying mode. Standard | **Standard** | Orbit rotation | `alt` + Left Mouse Button | | | Panning | `alt` + `command` + Left Mouse Button, or press the mouse wheel | | | Zooming | `alt` + `control` + Left Mouse Button, or scroll mouse wheel, or swipe with two fingers on a trackpad | -| **Flying** | Look around camera | `alt` + Right Mouse Button | +| **Flying** | Look around camera | alt + Right Mouse Button | | | Move forward | Up Arrow or Right Mouse Button + `W` | | | Move backward | Down Arrow or Right Mouse Button + `S` | | | Strafe left | Left Arrow or Right Mouse Button + `A` | @@ -34,32 +34,33 @@ There are two ways to browse the scene: standard mode and flying mode. Standard The toolbar is located at the top of the view window. Hovering the mouse over each item will show the shortcut keys or description. -image-20240131181207870 +image-20240131181207870 | Icon | Name | Description | Shortcut | | --- | --- | --- | --- | -| | Drag | Drag the screen | | -|

| Move
Rotate
Scale | Transform the selected entity | `W`
`E`
`R` | +| | Drag | Drag the screen | | +|

| Move
Rotate
Scale | Transform the selected entity | `W`
`E`
`R` | +| | Rect Edit Tool | Drag and scale sprites, GUI elements | | |
| Center Anchor/Hub Anchor | Switch the anchor point of the selected entity | | -|
| Local/World Coordinates | Switch the coordinates of the selected entity | | -| | Focus | Focus the scene camera on the selected entity | `F` | -| | Scene Camera | The scene camera menu contains options for configuring the scene camera, mainly to solve issues where objects are not visible because the clipping plane is too far or too near. These adjustments do not affect settings of entities with camera components in the scene. | | +|
| Local/World Coordinates | Switch the coordinates of the selected entity | | +| | Focus | Focus the scene camera on the selected entity | `F` | +| | Scene Camera | The scene camera menu contains options for configuring the scene camera, mainly to solve issues where objects are not visible because the clipping plane is too far or too near. These adjustments do not affect settings of entities with camera components in the scene. | | | | Settings | The settings menu contains options to adjust view auxiliary displays, including grids, auxiliary icons (graphics associated with specific components in the scene, including camera, direct light, point light, spotlight), and auxiliary wireframes. | | |
| Scene Camera Type | Switch between perspective/orthographic camera | | |
| Mode | Conveniently switch between 2D/3D scene modes. In 2D mode, navigation components, and perspective/orthographic toggle are disabled, and orbit rotation in navigation is no longer effective. | | -| | Fullscreen/Restore | Maximize the view window, minimize hierarchy, assets, inspector | | -| | Play | Play all particles and animations in the scene | -| | Screenshot | Take a snapshot of the current scene. Only user-created entities in the scene are shown, and a series of auxiliary tools like icons, grids, gizmo won't be included. After taking a screenshot, the snapshot will be used as the project thumbnail on the homepage. | +| | Fullscreen/Restore | Maximize the view window, minimize hierarchy, assets, inspector | | +| | Play | Play all particles and animations in the scene || +| | Screenshot | Take a snapshot of the current scene. Only user-created entities in the scene are shown, and a series of auxiliary tools like icons, grids, gizmo won't be included. After taking a screenshot, the snapshot will be used as the project thumbnail on the homepage. || ### Auxiliary Element Settings Interface - + | Property | Description | | --- | --- | | Grid | Whether the grid is displayed in the view | | 3D Icons | Whether auxiliary icons scale based on their distance from the camera | -| Navigation Gizmo | Used to display the current direction of the scene camera and can be quickly modified by mouse operation to adjust the view and projection mode (orthographic/perspective). It will appear at the bottom right corner of the screen when open.
image-20240131184405058 | +| Navigation Gizmo | Used to display the current direction of the scene camera and can be quickly modified by mouse operation to adjust the view and projection mode (orthographic/perspective). It will appear at the bottom right corner of the screen when open.
| | Outline | Whether outlines are displayed when an entity is selected. The outline of the selected entity is orange, and child nodes are blue. | | Camera | Display the selected camera component as a cone | | Light | Display light source components | @@ -69,7 +70,7 @@ The toolbar is located at the top of the view window. Hovering the mouse over ea ### Scene Camera Settings Interface - + | Property | Description | Default Value | | :----------------------------- | :----------------------------------------------------- | :------------------- | @@ -86,7 +87,7 @@ The toolbar is located at the top of the view window. Hovering the mouse over ea When an entity with a camera component is selected, the real-time preview of that camera will be displayed at the bottom left of the view window. This helps users adjust the camera and scene position in real-time. The preview window can be dragged, locked, and switched between different device proportions. -image-20240131190013320 + | Property | Description | | :----------- | :-------------------------------- | @@ -97,4 +98,4 @@ When an entity with a camera component is selected, the real-time preview of tha Objects containing camera components in the hierarchy tree can directly sync the scene camera's attributes, making position and view adjustments convenient. - \ No newline at end of file + diff --git a/docs/zh/interface/viewport.mdx b/docs/zh/interface/viewport.mdx index 3e2a21a2ad..0f2da50f58 100644 --- a/docs/zh/interface/viewport.mdx +++ b/docs/zh/interface/viewport.mdx @@ -10,7 +10,7 @@ label: Basics/Interface 视图窗口是用于选择、定位、更改当前场景中各种类型实体及组件的交互式界面。 - + ## 浏览场景 @@ -34,32 +34,33 @@ label: Basics/Interface 工具栏位于视图窗口中上,鼠标停留会出现每一项的快捷键,或者内容说明。 -image-20240131181207870 +image-20240131181207870 | 图标 | 名称 | 解释 | 快捷键 | | --- | --- | --- | --- | -| | 拖动 | 拖动画面 | | -|

| 移动
旋转
缩放 | 对选中实体进行变换操作 | `W`
`E`
`R` | +| | 拖动 | 拖动画面 | | +|

| 移动
旋转
缩放 | 对选中实体进行变换操作 | `W`
`E`
`R` | +| | 矩形编辑工具 | 拖拽和缩放精灵、GUI 元素 | | |
| 中心锚点/枢纽锚点 | 切换选中实体的锚点 | | -|
| 本地坐标/世界坐标 | 切换选中实体的坐标 | | -| | 聚焦 | 场景相机聚焦到的选中实体 | `F` | -| | 场景相机 | 场景相机菜单包含用于配置场景相机的选项,主要用来解决搭建场景时,裁剪面太远或者太近导致看不到物体的问题。这些调整不会影响场景中带有相机组件的实体的设置。 | | +|
| 本地坐标/世界坐标 | 切换选中实体的坐标 | | +| | 聚焦 | 场景相机聚焦到的选中实体 | `F` | +| | 场景相机 | 场景相机菜单包含用于配置场景相机的选项,主要用来解决搭建场景时,裁剪面太远或者太近导致看不到物体的问题。这些调整不会影响场景中带有相机组件的实体的设置。 | | | | 设置 | 设置菜单包含用于调整视图辅助显示的选项,包括网格、辅助图标(与场景中特定组件相关联的图形,包括相机、直射光、点光源、聚光灯)、 辅助线框 | | |
| 场景相机类型 | 切换透视/正交相机 | | |
| 模式 | 方便在 2D/3D 场景模式间进行点击切换。2D 模式下,导航部件、正交/透视切换关闭,导航中的环绕轨道不再生效。 | | -| | 全屏/复原 | 最大化视图窗口,最小化层级、资产、检查器 | | -| | 播放 | 播放场景中所有粒子、动画 | -| | 截屏 | 对当前场景进行快照。仅显示场景内用户创建实体,辅助显示的一系列工具,如图标、网格、gizmo 不会被计入其中。进行截屏后,该快照会在首页作为该项目缩略图。 | +| | 全屏/复原 | 最大化视图窗口,最小化层级、资产、检查器 | | +| | 播放 | 播放场景中所有粒子、动画 || +| | 截屏 | 对当前场景进行快照。仅显示场景内用户创建实体,辅助显示的一系列工具,如图标、网格、gizmo 不会被计入其中。进行截屏后,该快照会在首页作为该项目缩略图。 || ### 辅助元素设置界面 - + | 属性 | 内容 | | --- | --- | | 网格(Grid) | 视图中的网格是否显示 | | 3D 图标(3D Icons) | 辅助图标是否根据组件与摄像机的距离进行缩放 | -| 导航 Gimzo | 用于显示场景相机的当前方向,并且可以通过鼠标操作快速修改视角和投影模式(正交/透视)。打开后会在画面右下角显示。
image-20240131184405058 | +| 导航 Gimzo | 用于显示场景相机的当前方向,并且可以通过鼠标操作快速修改视角和投影模式(正交/透视)。打开后会在画面右下角显示。
| | 轮廓显示(Outline) | 选中某个实体时是否显示轮廓,选中的实体轮廓颜色为橙色,子节点轮廓为蓝色 | | 相机(Camera) | 以锥体显示选中相机组件 | | 光源(Light) | 显示光源组件 | @@ -69,7 +70,7 @@ label: Basics/Interface ### 场景相机设置界面 - + | 属性 | 内容 | 默认值 | | :--------------------------- | :----------------------------------------------------------- | :------------------- | @@ -86,7 +87,7 @@ label: Basics/Interface 选中带有相机组件的实体时,会在视图窗口左下角显示该相机的实时预览。帮助用户实时调整相机、场景位置。预览窗口可以拖动、锁定,并且切换不同设备比例的窗口。 -image-20240131190013320 + | 属性 | 内容 | | :------- | :--------------------------- | @@ -97,4 +98,4 @@ label: Basics/Interface 在层级树中包含相机组件的物体,可以直接同步视图的场景相机的相关属性,方便进行位置和视角的调整。 - +