xuanchi/XCEngine
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add scene viewport interaction helper docs

Browse Source
This commit is contained in:
ssdfasd
2026-04-04 01:24:16 +08:00
parent b7523db30d
commit c3680258e0
33 changed files with 1336 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
docs/api/XCEngine/Editor/Viewport/Viewport.md
View File

@@ -21,12 +21,16 @@
当前宿主实现，持有 editor camera、render target 与 Scene View overlay 缓存。
- [SceneViewportCameraController](SceneViewportCameraController/SceneViewportCameraController.md)
维护 Scene View 相机的焦点、距离、朝向和飞行速度，并把结果写回隐藏相机变换。
- [SceneViewportMath](SceneViewportMath/SceneViewportMath.md)
提供投影、屏幕方向、拖拽平面和距离计算等几何 helper，供 gizmo / overlay / picker 共用。
- [SceneViewportPicker](SceneViewportPicker/SceneViewportPicker.md)
提供 CPU 射线选取 helper，当前更多用于辅助 gizmo 命中和保留的几何拾取路径。
- [ViewportObjectIdPicker](ViewportObjectIdPicker/ViewportObjectIdPicker.md)
封装 Scene View object-id 读回请求构建、像素坐标映射与颜色解码，是当前主点击选取链路的底层 helper。
- [SceneViewportHudOverlay](SceneViewportHudOverlay/SceneViewportHudOverlay.md)
负责前端 HUD / orientation gizmo 的构造、绘制和命中。
- [SceneViewportOrientationGizmo](SceneViewportOrientationGizmo/SceneViewportOrientationGizmo.md)
提供右上角朝向 gizmo 的绘制和点击命中，供 HUD overlay 复用。
- [SceneViewportInteractionResolver](SceneViewportInteractionResolver/SceneViewportInteractionResolver.md)
把 HUD 命中与 overlay handle 命中合并成统一交互结果。
- [SceneViewportInteractionActions](SceneViewportInteractionActions/SceneViewportInteractionActions.md)
@@ -55,6 +59,9 @@
- [Editor](../Editor.md)
- [SceneViewPanel](../panels/SceneViewPanel/SceneViewPanel.md)
- [SceneViewportCameraController](SceneViewportCameraController/SceneViewportCameraController.md)
- [SceneViewportMath](SceneViewportMath/SceneViewportMath.md)
- [SceneViewportPicker](SceneViewportPicker/SceneViewportPicker.md)
- [ViewportObjectIdPicker](ViewportObjectIdPicker/ViewportObjectIdPicker.md)
- [SceneViewportHudOverlay](SceneViewportHudOverlay/SceneViewportHudOverlay.md)
- [SceneViewportOrientationGizmo](SceneViewportOrientationGizmo/SceneViewportOrientationGizmo.md)
- [SceneView Interaction And Gizmo Model](../../../_guides/Editor/SceneView-Interaction-And-Gizmo-Model.md)