# update 0.6.2.1

更新了蓝图组件相关的用法。
This commit is contained in:
2026-07-15 10:36:16 +08:00
parent 155641f2ef
commit 7f3a12cae0
25 changed files with 1102 additions and 877 deletions
@@ -4,103 +4,88 @@ namespace XericLibrary.Runtime.Blueprint.Canvas
{
/// <summary>
/// 屏幕空间蓝图画布实现,基于 UGUI Canvas。
/// <code>
/// 使用 RectTransformUtility 处理屏幕坐标和画布坐标之间的转换。
/// <para>
/// 所有坐标转换统一通过 <see cref="RectTransformUtility"/> 完成,
/// 以 <see cref="_renderRoot"/> RectTransform 为坐标基准,
/// 不依赖蓝图自身的 RectTransform 是否撑满全屏。
/// </para>
/// <para>
/// 支持 ScreenSpaceOverlay / ScreenSpaceCamera / WorldSpace 三种渲染模式。
/// 由外层的 Mask(__Bp_GridBackground)裁剪,确保蓝图节点不溢出视图区域。
/// 缩放范围:0.1x ~ 3x。
/// </code>
/// </para>
/// </summary>
public class ScreenSpaceBlueprintCanvas : BlueprintCanvasBase
{
private readonly UnityEngine.Canvas _unityCanvas;
private readonly RectTransform _rectTransform;
private readonly RectTransform _renderRoot;
/// <summary>动态获取摄像机引用(不缓存),
/// 自动适应 Canvas.renderMode 运行时的变化。</summary>
private Camera WorldCamera => _unityCanvas != null ? _unityCanvas.worldCamera : null;
/// <summary>
/// 构造屏幕空间蓝图画布
/// </summary>
/// <param name="unityCanvas">Unity UGUI Canvas 组件</param>
public ScreenSpaceBlueprintCanvas(UnityEngine.Canvas unityCanvas)
/// <param name="unityCanvas">所属的 Unity UGUI Canvas 组件</param>
/// <param name="renderRoot">蓝图渲染根 RectTransform,所有蓝图层容器和背景挂载于此</param>
public ScreenSpaceBlueprintCanvas(UnityEngine.Canvas unityCanvas, RectTransform renderRoot)
{
_unityCanvas = unityCanvas;
_rectTransform = unityCanvas.GetComponent<RectTransform>();
_renderRoot = renderRoot;
}
/// <summary>
/// 将屏幕坐标转换为画布坐标
/// 将屏幕坐标转换为画布坐标。
/// 通过 <see cref="RectTransformUtility.ScreenPointToLocalPointInRectangle"/>
/// 以 <see cref="_renderRoot"/> 为参照转换,
/// 自动处理 Canvas 渲染模式和 RenderRoot 的偏移。
/// </summary>
/// <param name="screenPoint">屏幕空间的坐标点</param>
/// <returns>画布空间的坐标点</returns>
public override Vector2 ScreenToCanvas(Vector2 screenPoint)
{
RectTransformUtility.ScreenPointToLocalPointInRectangle(
_rectTransform, screenPoint, _unityCanvas.worldCamera, out Vector2 localPoint);
_renderRoot, screenPoint, WorldCamera, out Vector2 localPoint);
return (localPoint - _panOffset) / _zoomLevel;
}
/// <summary>
/// 将画布坐标转换为屏幕坐标
/// 将画布坐标转换为屏幕坐标。
/// 先计算 RenderRoot 本地空间位置,再通过 RectTransformUtility 转换为屏幕坐标。
/// </summary>
/// <param name="canvasPoint">画布空间的坐标点</param>
/// <returns>屏幕空间的坐标点</returns>
public override Vector2 CanvasToScreen(Vector2 canvasPoint)
{
Vector2 local = canvasPoint * _zoomLevel + _panOffset;
Vector3 world = _rectTransform.TransformPoint(local);
if (_unityCanvas.worldCamera != null)
{
return _unityCanvas.worldCamera.WorldToScreenPoint(world);
}
return world;
Vector3 world = _renderRoot.TransformPoint(local);
return RectTransformUtility.WorldToScreenPoint(WorldCamera, world);
}
/// <summary>
/// 将画布坐标转换为世界坐标
/// <code>
/// 屏幕空间画布的世界空间转换依赖于 Canvas 的渲染模式:
/// Screen Space - Overlay 时直接使用 localPoint 作为屏幕坐标;
/// Screen Space - Camera 时通过 camera 进行坐标转换。
/// </code>
/// 将画布坐标转换为世界坐标。
/// </summary>
/// <param name="canvasPoint">画布空间的坐标点</param>
/// <returns>世界空间的坐标点</returns>
public override Vector3 CanvasToWorld(Vector2 canvasPoint)
{
Vector2 local = canvasPoint * _zoomLevel + _panOffset;
Vector3 world = _rectTransform.TransformPoint(local);
if (_unityCanvas.worldCamera != null)
{
Vector3 screenPoint = _unityCanvas.worldCamera.WorldToScreenPoint(world);
return _unityCanvas.worldCamera.ScreenToWorldPoint(screenPoint);
}
return world;
return _renderRoot.TransformPoint(local);
}
/// <summary>
/// 将世界坐标转换为画布坐标
/// 将世界坐标转换为画布坐标。
/// 先转换为屏幕坐标,再通过 RectTransformUtility 转换为 RenderRoot 本地坐标。
/// </summary>
/// <param name="worldPoint">世界空间的坐标点</param>
/// <returns>画布空间的坐标点</returns>
public override Vector2 WorldToCanvas(Vector3 worldPoint)
{
if (_unityCanvas.worldCamera != null)
{
Vector3 screenPoint = _unityCanvas.worldCamera.WorldToScreenPoint(worldPoint);
RectTransformUtility.ScreenPointToLocalPointInRectangle(
_rectTransform, screenPoint, _unityCanvas.worldCamera, out Vector2 localPoint);
return (localPoint - _panOffset) / _zoomLevel;
}
Vector3 local = _rectTransform.InverseTransformPoint(worldPoint);
return (new Vector2(local.x, local.y) - _panOffset) / _zoomLevel;
Vector3 screenPoint = RectTransformUtility.WorldToScreenPoint(WorldCamera, worldPoint);
RectTransformUtility.ScreenPointToLocalPointInRectangle(
_renderRoot, screenPoint, WorldCamera, out Vector2 localPoint);
return (localPoint - _panOffset) / _zoomLevel;
}
/// <summary>
/// 获取渲染根 Transform(UGUI Canvas 的 RectTransform)
/// 获取渲染根 Transform(蓝图层容器和背景的父级)
/// </summary>
public override Transform GetRootTransform()
{
return _rectTransform;
return _renderRoot;
}
/// <summary>
@@ -110,5 +95,10 @@ namespace XericLibrary.Runtime.Blueprint.Canvas
{
get { return _unityCanvas; }
}
/// <summary>
/// Canvas 组件未被销毁,画布可正常使用。
/// </summary>
public override bool IsAlive => _unityCanvas != null;
}
}
@@ -100,5 +100,10 @@ namespace XericLibrary.Runtime.Blueprint.Canvas
{
return _canvasTransform;
}
/// <summary>
/// Transform 组件未被销毁,画布可正常使用。
/// </summary>
public override bool IsAlive => _canvasTransform != null;
}
}