LiRuochen_WorkFlow/XericUIActionVessel
1
0
Fork 0
Code Issues 4 Pull Requests Actions Packages Projects Releases Wiki Activity

锚点窗口改为了使用集合，一次性可以添加多个窗口

Browse Source
This commit is contained in:
lrss3
2026-06-12 14:28:48 +08:00
parent b2d82a054a
commit 856c395819
5 changed files with 219 additions and 159 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Runtime/VisualForm/AnchorDock.cs
+18 -11
View File
@@ -436,26 +436,33 @@ namespace XericUI.VisualForm
}
/// <summary>
/// 更新指定中间类的屏幕坐标
/// 更新指定中间类中所有窗口条目的屏幕坐标（基础位置 + 条目偏移量）
/// </summary>
private void UpdateStatePosition(WindowState state)
{
if (state.Anchor == null || _worldCamera == null || _canvas == null) return;
var target = state.GetTargetTransform();
if (target == null) return;
if (state.Entries.Count == 0) return;
Vector3 worldPos = state.Anchor.CachedTransform.position;
if (TryWorldToScreenPoint(worldPos, _worldCamera, _uiCamera, _canvas, RectTransform, out Vector2 localPoint))
{
if (target is RectTransform rectTarget)
rectTarget.anchoredPosition = localPoint;
else
target.localPosition = new Vector3(localPoint.x, localPoint.y, target.localPosition.z);
if (!TryWorldToScreenPoint(worldPos, _worldCamera, _uiCamera, _canvas, RectTransform, out Vector2 basePoint))
return;
state.CoordinateDirty = false;
// 为每个窗口条目设置位置：基础坐标 + 条目自身偏移量
foreach (var entry in state.Entries)
{
if (entry.Instance == null) continue;
Vector2 finalPoint = basePoint + entry.ScreenOffset;
var target = entry.Instance.transform;
if (target is RectTransform rectTarget)
rectTarget.anchoredPosition = finalPoint;
else
target.localPosition = new Vector3(finalPoint.x, finalPoint.y, target.localPosition.z);
}
state.CoordinateDirty = false;
}
#endregion
Runtime/VisualForm/AnchorWindow.cs
+47 -72
View File
@@ -1,59 +1,50 @@
using System.Collections.Generic;
using UnityEngine;
namespace XericUI.VisualForm
{
/// <summary>
/// 锚点窗口 - WorldAnchor的子类，持有UI窗口对象的引用。
/// 锚点窗口 - WorldAnchor的子类，持有一组UI窗口条目的引用。
/// 每个条目包含窗口对象、屏幕偏移量和激活状态，支持一个锚点同时生成多个定位窗口。
/// 窗口对象可以是实际的场景对象，也可以是预制体。
/// 如果窗口锚点坞在子项中找不到对应对象，则视为预制体，需要通过实例化方法创建。
/// </summary>
[AddComponentMenu("Xeric UI Vessel/AnchorWindow/AnchorWindow")]
public class AnchorWindow : WorldAnchor
{
[Header("窗口配置")]
[SerializeField, Tooltip("UI窗口对象（可以是子项中的实例或预制体资源）")]
private GameObject m_WindowObject;
[SerializeField, Tooltip("启用UI显示开关")]
private bool m_EnableUI = true;
[Header("窗口条目")]
[SerializeField, Tooltip("窗口对象集合，每个条目可独立配置偏移和启用状态")]
private List<WindowEntry> m_WindowEntries = new List<WindowEntry>();
/// <summary>
/// 窗口对象引用（可以是实例或预制体）
/// 窗口条目列表
/// </summary>
public GameObject WindowObject
{
get => m_WindowObject;
set => m_WindowObject = value;
}
public List<WindowEntry> WindowEntries => m_WindowEntries;
/// <summary>
/// UI启用开关，设为false时窗口实例将被隐藏
/// 当前生效的窗口条目数（过滤掉WindowObject为null的条目）
/// </summary>
public bool EnableUI
public int ValidEntryCount
{
get => m_EnableUI;
set
get
{
if (m_EnableUI == value) return;
m_EnableUI = value;
ApplyUIState();
int count = 0;
foreach (var entry in m_WindowEntries)
if (entry != null && entry.WindowObject != null)
count++;
return count;
}
}
/// <summary>
/// 判断窗口对象是否为预制体（不在锚点坞的子项中则为预制体）
/// 此标记由WindowState在初始化时设置
/// </summary>
[System.NonSerialized]
public bool IsPrefab;
/// <summary>
/// 获取当前有效的窗口Transform（实例或自身）
/// 获取第一个有效窗口对象的Transform（兼容旧API）
/// </summary>
public Transform GetWindowTransform()
{
if (m_WindowObject != null)
return m_WindowObject.transform;
foreach (var entry in m_WindowEntries)
{
if (entry != null && entry.WindowObject != null)
return entry.WindowObject.transform;
}
return transform;
}
@@ -62,52 +53,58 @@ namespace XericUI.VisualForm
/// <summary>
/// 从所属锚点坞获取自己的中间窗口状态类
/// </summary>
/// <returns>WindowState实例，不存在则返回null</returns>
public WindowState GetWindowState()
{
if (TargetDock == null)
return null;
if (TargetDock == null) return null;
return TargetDock.GetWindowState(this);
}
/// <summary>
/// 获取窗口实例对象（预制体实例化后的对象，或子项中已有的对象）
/// 获取第一个有效窗口的实例对象
/// </summary>
/// <returns>窗口GameObject实例</returns>
public GameObject GetWindowInstance()
{
var state = GetWindowState();
return state?.WindowInstance;
if (state == null || state.Entries == null || state.Entries.Count == 0)
return null;
return state.Entries[0].Instance;
}
/// <summary>
/// 获取窗口当前的屏幕坐标（容器内本地坐标）
/// 获取所有窗口实例对象
/// </summary>
public List<GameObject> GetAllWindowInstances()
{
var result = new List<GameObject>();
var state = GetWindowState();
if (state == null || state.Entries == null) return result;
foreach (var e in state.Entries)
if (e.Instance != null)
result.Add(e.Instance);
return result;
}
/// <summary>
/// 获取第一个窗口当前的屏幕坐标（容器内本地坐标）
/// </summary>
/// <returns>屏幕本地坐标</returns>
public Vector2 GetScreenPosition()
{
var state = GetWindowState();
if (state == null) return Vector2.zero;
var instance = state.WindowInstance;
var instance = GetWindowInstance();
if (instance == null) return Vector2.zero;
var rt = instance.transform as RectTransform;
if (rt != null)
return rt.localPosition;
if (rt != null) return rt.localPosition;
return instance.transform.localPosition;
}
/// <summary>
/// 获取锚点当前的世界坐标
/// </summary>
/// <returns>世界坐标</returns>
public Vector3 GetWorldPosition()
{
var state = GetWindowState();
if (state != null)
return state.LastWorldPosition;
if (state != null) return state.LastWorldPosition;
return CachedTransform.position;
}
@@ -117,29 +114,7 @@ namespace XericUI.VisualForm
public bool IsWindowActive()
{
var state = GetWindowState();
if (state == null) return false;
return state.IsEnabled && m_EnableUI;
}
#endregion
#region 内部方法
/// <summary>
/// 将UI开关状态应用到窗口实例
/// </summary>
private void ApplyUIState()
{
var state = GetWindowState();
if (state == null) return;
var instance = state.WindowInstance;
if (instance == null) return;
if (m_EnableUI && state.IsEnabled)
instance.SetActive(true);
else
instance.SetActive(false);
return state != null && state.IsEnabled;
}
#endregion
Runtime/VisualForm/WindowEntry.cs
+63
View File
@@ -0,0 +1,63 @@
using UnityEngine;
namespace XericUI.VisualForm
{
/// <summary>
/// 窗口条目数据 — 锚点窗口上每个窗口对象的配置集合。
/// 包含窗口对象引用、屏幕二维偏移量和激活状态。
/// 支持一个锚点同时生成多个定位窗口。
/// </summary>
[System.Serializable]
public class WindowEntry
{
[SerializeField, Tooltip("窗口对象（可以是子项中的实例或预制体资源）")]
private GameObject m_WindowObject;
[SerializeField, Tooltip("屏幕二维偏移量")]
private Vector2 m_ScreenOffset;
[SerializeField, Tooltip("是否启用此窗口")]
private bool m_Enabled = true;
/// <summary>
/// 窗口对象引用（实例或预制体）
/// </summary>
public GameObject WindowObject
{
get => m_WindowObject;
set => m_WindowObject = value;
}
/// <summary>
/// 屏幕二维偏移量
/// </summary>
public Vector2 ScreenOffset
{
get => m_ScreenOffset;
set => m_ScreenOffset = value;
}
/// <summary>
/// 是否启用此窗口
/// </summary>
public bool Enabled
{
get => m_Enabled;
set => m_Enabled = value;
}
// --- 运行时状态（非序列化） ---
/// <summary>
/// 实际生成的窗口实例（原型或预制体实例）
/// </summary>
[System.NonSerialized]
public GameObject Instance;
/// <summary>
/// 此窗口对象是否被判定为预制体（不在坞子项中）
/// </summary>
[System.NonSerialized]
public bool IsPrefab;
}
}
Runtime/VisualForm/WindowEntry.cs.meta
+11
View File
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 95453fd9f28009d4f8bdae1fe45919a2
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
Runtime/VisualForm/WindowState.cs
+80 -76
View File
@@ -1,17 +1,18 @@
using System.Collections.Generic;
using UnityEngine;
namespace XericUI.VisualForm
{
/// <summary>
/// 中间窗口状态类 - 管理锚点窗口和锚点坞之间的中间产物。
/// 负责窗口实例的生命周期管理、坐标脏标记和屏幕定位。
/// 负责所有窗口条目的实例生命周期管理、坐标脏标记和屏幕定位。
/// 使用对象池管理，避免频繁创建销毁。
///
/// 生命周期：
/// OnStart - 从对象池取出时调用（初始化/复用）
/// OnEnable - 锚点激活时调用（脏更新触发）
/// OnDisable- 锚点隐藏时调用（脏更新触发）
/// OnEnd - 回收到对象池时调用（清理/回收）
/// OnStart - 从对象池取出时调用（初始化/复用，解析所有窗口条目）
/// OnEnable - 锚点激活时调用（脏更新触发，激活所有启用条目）
/// OnDisable- 锚点隐藏时调用（脏更新触发，隐藏所有条目）
/// OnEnd - 回收到对象池时调用（清理/回收所有条目实例）
/// </summary>
public class WindowState
{
@@ -26,34 +27,10 @@ namespace XericUI.VisualForm
public AnchorDock Dock { get; private set; }
/// <summary>
/// 原始窗口对象（来自AnchorWindow的引用）
/// 窗口条目列表（来自AnchorWindow的WindowEntries的运行时副本）
/// 每个条目维护自己的实例、偏移量和激活状态
/// </summary>
private GameObject _windowObject;
/// <summary>
/// 实例化的窗口对象（如果是预制体则为此实例，否则为_windowObject本身）
/// </summary>
private GameObject _instance;
/// <summary>
/// 是否为预制体
/// </summary>
private bool _isPrefab;
/// <summary>
/// 是否为预制体（公开属性）
/// </summary>
public bool IsPrefab => _isPrefab;
/// <summary>
/// 窗口实例对象（预制体实例化后的对象，或子项中已有的对象）
/// </summary>
public GameObject WindowInstance => _instance;
/// <summary>
/// 上帧锚点世界坐标
/// </summary>
public Vector3 LastWorldPosition => _lastPosition;
public List<WindowEntry> Entries { get; private set; } = new List<WindowEntry>();
/// <summary>
/// 当前是否处于激活状态
@@ -65,6 +42,11 @@ namespace XericUI.VisualForm
/// </summary>
public bool CoordinateDirty { get; set; }
/// <summary>
/// 上帧锚点世界坐标
/// </summary>
public Vector3 LastWorldPosition => _lastPosition;
/// <summary>
/// 上帧世界坐标（用于比较变化量）
/// </summary>
@@ -75,8 +57,6 @@ namespace XericUI.VisualForm
/// <summary>
/// 从对象池取出时的初始化（Start事件）
/// </summary>
/// <param name="anchor">关联的锚点</param>
/// <param name="dock">关联的锚点坞</param>
public void OnStart(WorldAnchor anchor, AnchorDock dock)
{
ResetState();
@@ -84,8 +64,8 @@ namespace XericUI.VisualForm
Anchor = anchor;
Dock = dock;
// 解析窗口实例（原型对象或预制体实例化）
ResolveWindowInstance();
// 解析所有窗口条目（原型对象或预制体实例化）
ResolveWindowEntries();
// 初始化位置记录
if (anchor != null)
@@ -93,38 +73,42 @@ namespace XericUI.VisualForm
}
/// <summary>
/// 解析窗口实例：自动判断窗口对象是原型（已在子项中）还是预制体，并完成实例获取或创建。
/// 如果锚点是AnchorWindow且携带窗口对象，则根据是否在坞子项中决定处理方向：
/// - 在子项中 → 直接使用该对象作为实例（原型模式）
/// - 不在子项中 → 从WindowPool获取或实例化预制体
/// 如果锚点不是AnchorWindow或无窗口对象，则不创建实例。
/// 解析所有窗口条目：遍历AnchorWindow的WindowEntries，
/// 为每个条目判断窗口对象是原型还是预制体，并完成实例获取或创建。
/// </summary>
public void ResolveWindowInstance()
public void ResolveWindowEntries()
{
if (Dock == null || Anchor == null) return;
var anchorWindow = Anchor as AnchorWindow;
if (anchorWindow == null || anchorWindow.WindowObject == null)
if (anchorWindow == null || anchorWindow.WindowEntries.Count == 0)
return;
_windowObject = anchorWindow.WindowObject;
Entries.Clear();
// 通过锚点坞的哈希检查窗口对象是否在子项中
_isPrefab = !Dock.IsChildObject(_windowObject);
if (_isPrefab)
foreach (var srcEntry in anchorWindow.WindowEntries)
{
// 预制体：从对象池获取或创建实例，挂到坞下
_instance = WindowPool.Get(_windowObject, Dock.transform);
}
else
{
// 原型：已在子项中的实例对象，直接引用
_instance = _windowObject;
}
if (srcEntry == null || srcEntry.WindowObject == null)
continue;
// 同步标记到AnchorWindow
anchorWindow.IsPrefab = _isPrefab;
var entry = srcEntry; // 直接复用WindowEntry引用，运行时状态写回
// 通过锚点坞的哈希检查窗口对象是否在子项中
entry.IsPrefab = !Dock.IsChildObject(entry.WindowObject);
if (entry.IsPrefab)
{
// 预制体：从对象池获取或创建实例，挂到坞下
entry.Instance = WindowPool.Get(entry.WindowObject, Dock.transform);
}
else
{
// 原型：已在子项中的实例对象，直接引用
entry.Instance = entry.WindowObject;
}
Entries.Add(entry);
}
}
/// <summary>
@@ -134,12 +118,16 @@ namespace XericUI.VisualForm
{
IsEnabled = true;
// 如果实例尚不存在（如纯WorldAnchor没有窗口对象），尝试解析
if (_instance == null)
ResolveWindowInstance();
// 确保窗口条目已解析
if (Entries.Count == 0)
ResolveWindowEntries();
if (_instance != null)
_instance.SetActive(true);
// 激活所有启用的条目实例
foreach (var entry in Entries)
{
if (entry.Instance != null && entry.Enabled)
entry.Instance.SetActive(true);
}
// 激活时强制标记坐标脏，确保下一帧更新位置
CoordinateDirty = true;
@@ -152,8 +140,11 @@ namespace XericUI.VisualForm
{
IsEnabled = false;
if (_instance != null)
_instance.SetActive(false);
foreach (var entry in Entries)
{
if (entry.Instance != null)
entry.Instance.SetActive(false);
}
}
/// <summary>
@@ -161,12 +152,17 @@ namespace XericUI.VisualForm
/// </summary>
public void OnEnd()
{
// 回收预制体实例到对象池
if (_isPrefab && _instance != null)
// 回收所有预制体实例到对象池
foreach (var entry in Entries)
{
WindowPool.Release(_windowObject, _instance);
if (entry.IsPrefab && entry.Instance != null)
WindowPool.Release(entry.WindowObject, entry.Instance);
entry.Instance = null;
entry.IsPrefab = false;
}
Entries.Clear();
ResetState();
}
@@ -181,9 +177,6 @@ namespace XericUI.VisualForm
{
Anchor = null;
Dock = null;
_windowObject = null;
_instance = null;
_isPrefab = false;
IsEnabled = false;
CoordinateDirty = false;
_lastPosition = Vector3.zero;
@@ -193,7 +186,6 @@ namespace XericUI.VisualForm
/// 检查锚点坐标是否发生变化，超过阈值则标记脏
/// 由锚点坞在每帧调用
/// </summary>
/// <param name="threshold">变化阈值</param>
public void CheckPositionDirty(float threshold)
{
if (Anchor == null) return;
@@ -207,18 +199,30 @@ namespace XericUI.VisualForm
}
/// <summary>
/// 获取当前需要定位的Transform目标（实例化的窗口对象或锚点自身）
/// 获取第一个有效窗口条目的Transform（兼容旧API）
/// </summary>
/// <returns>目标Transform</returns>
public Transform GetTargetTransform()
{
if (_instance != null)
return _instance.transform;
foreach (var entry in Entries)
{
if (entry.Instance != null)
return entry.Instance.transform;
}
if (Anchor != null)
return Anchor.CachedTransform;
return null;
}
/// <summary>
/// 获取所有需要定位的Transform
/// </summary>
public IEnumerable<Transform> GetAllTargetTransforms()
{
foreach (var entry in Entries)
if (entry.Instance != null)
yield return entry.Instance.transform;
}
#endregion
}
}