TransformTreeWindow.cs 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419
  1. // Animancer // https://kybernetik.com.au/animancer // Copyright 2018-2024 Kybernetik //
  2. // FlexiMotion // https://kybernetik.com.au/flexi-motion // Copyright 2023 Kybernetik //
  3. #if UNITY_EDITOR
  4. using System;
  5. using System.Collections.Generic;
  6. using UnityEditor;
  7. using UnityEditor.IMGUI.Controls;
  8. using UnityEngine;
  9. using static Animancer.Editor.AnimancerGUI;
  10. namespace Animancer.Editor
  11. {
  12. /// <summary>[Editor-Only]
  13. /// A <see cref="SerializedComponentDataEditorWindow{TObject, TData}"/>
  14. /// which displays a <see cref="TransformTreeView"/>.
  15. /// </summary>
  16. /// https://kybernetik.com.au/animancer/api/Animancer.Editor/TransformTreeWindow_2
  17. /// https://kybernetik.com.au/flexi-motion/api/FlexiMotion.Editor/TransformTreeWindow_2
  18. public abstract class TransformTreeWindow<TObject, TData> :
  19. SerializedComponentDataEditorWindow<TObject, TData>,
  20. ITransformTreeViewSource
  21. where TObject : Component
  22. where TData : class, ICopyable<TData>, IEquatable<TData>, new()
  23. {
  24. /************************************************************************************************************************/
  25. [SerializeField] private MultiColumnHeaderState _HeaderState;
  26. [SerializeField] private TreeViewState _GUIState;
  27. [NonSerialized] private TransformTreeView _TreeView;
  28. /************************************************************************************************************************/
  29. /// <summary>The header of the tree view.</summary>
  30. public MultiColumnHeaderState HeaderState => _HeaderState;
  31. /// <summary>The view used to display the <see cref="SerializedDataEditorWindow{TObject, TData}.Data"/>.</summary>
  32. public TransformTreeView TreeView => _TreeView;
  33. /************************************************************************************************************************/
  34. /// <inheritdoc/>
  35. protected override void OnEnable()
  36. {
  37. base.OnEnable();
  38. minSize = new Vector2(400, 200);
  39. Initialize();
  40. Undo.undoRedoPerformed += ReloadTreeView;
  41. Selection.selectionChanged += Repaint;
  42. }
  43. /************************************************************************************************************************/
  44. /// <inheritdoc/>
  45. protected override void OnDisable()
  46. {
  47. base.OnDisable();
  48. Undo.undoRedoPerformed -= ReloadTreeView;
  49. Selection.selectionChanged -= Repaint;
  50. _TreeView?.Dispose();
  51. SceneView.RepaintAll();
  52. }
  53. /************************************************************************************************************************/
  54. /// <inheritdoc/>
  55. protected override void CaptureData()
  56. {
  57. base.CaptureData();
  58. Initialize();
  59. }
  60. /// <summary>
  61. /// Initializes this window if the <see cref="SerializedDataEditorWindow{TObject, TData}.SourceObject"/>
  62. /// has been set.
  63. /// </summary>
  64. protected virtual void Initialize()
  65. {
  66. if (SourceObject == null)
  67. return;
  68. titleContent = new($"{SourceObject.name}: {SourceObject.GetType().Name}");
  69. var isNew = _GUIState == null;
  70. if (isNew)
  71. _GUIState = new();
  72. if (_TreeView == null)
  73. {
  74. _TreeView = new(_GUIState, null, this);
  75. _TreeView.Reload();
  76. _TreeView.OnObjectSelectionChanged();
  77. }
  78. CreateHeader();
  79. if (isNew)
  80. InitializeExpandedRows();
  81. }
  82. /************************************************************************************************************************/
  83. /// <summary>Calls <see cref="CreateColumns"/> and initializes the tree view header.</summary>
  84. protected void CreateHeader()
  85. {
  86. var serializedHeaderState = _HeaderState;
  87. _HeaderState = new(CreateColumns(position.width - LineHeight));
  88. if (MultiColumnHeaderState.CanOverwriteSerializedFields(serializedHeaderState, _HeaderState))
  89. MultiColumnHeaderState.OverwriteSerializedFields(serializedHeaderState, _HeaderState);
  90. _TreeView.multiColumnHeader = new MultiColumnHeader(_HeaderState);
  91. }
  92. /// <summary>Creates the columns for the <see cref="TreeView"/> to use.</summary>
  93. protected abstract MultiColumnHeaderState.Column[] CreateColumns(float width);
  94. /// <summary>Creates a column for the <see cref="TreeView"/> to use.</summary>
  95. protected static MultiColumnHeaderState.Column CreateColumn(string name, string tooltip, float width)
  96. => new()
  97. {
  98. headerContent = new GUIContent(name, tooltip),
  99. width = width,
  100. allowToggleVisibility = false,
  101. canSort = false,
  102. };
  103. /************************************************************************************************************************/
  104. /// <inheritdoc/>
  105. public virtual void AddItems(ref int id, TreeViewItem root)
  106. {
  107. var rootTransform = Root;
  108. TreeView.AddItemRecursive(ref id, root, rootTransform);
  109. var transforms = Transforms;
  110. var count = transforms.Count;
  111. for (int i = 0; i < count; i++)
  112. {
  113. var transform = transforms[i];
  114. if (!transform.IsChildOf(rootTransform))
  115. {
  116. AddItem(ref id, root, transform);
  117. }
  118. }
  119. }
  120. /// <inheritdoc/>
  121. public virtual TreeViewItem AddItem(ref int id, TreeViewItem parent, Transform transform)
  122. => TreeView.AddItem(ref id, parent, transform);
  123. /************************************************************************************************************************/
  124. private void InitializeExpandedRows()
  125. {
  126. var includedTransforms = Transforms;
  127. if (includedTransforms.Count == 0)// If there are no springs, expand everything.
  128. {
  129. _TreeView.SetExpandedRecursive(TransformTreeView.RootID, true);
  130. }
  131. else// Otherwise, only expand to show all springs.
  132. {
  133. var allTransforms = _TreeView.Transforms;
  134. for (int i = 0; i < allTransforms.Count; i++)
  135. {
  136. var transform = allTransforms[i];
  137. if (includedTransforms.Contains(transform))
  138. {
  139. while (transform.parent != null)
  140. {
  141. transform = transform.parent;
  142. var index = allTransforms.LastIndexOf(transform);
  143. if (index >= 0)
  144. _TreeView.SetExpanded(index, true);
  145. }
  146. }
  147. }
  148. }
  149. }
  150. /************************************************************************************************************************/
  151. /// <summary>Draws the GUI of this window.</summary>
  152. protected virtual void OnGUI()
  153. {
  154. if (_TreeView == null ||
  155. Data == null ||
  156. SourceObject == null)
  157. {
  158. Close();
  159. return;
  160. }
  161. GUILayout.FlexibleSpace();
  162. var area = GUILayoutUtility.GetLastRect();
  163. area.width = position.width;
  164. var searchArea = area;
  165. searchArea.xMin += StandardSpacing;
  166. searchArea.y += StandardSpacing;
  167. searchArea.height = LineHeight;
  168. area.yMin = searchArea.yMax + StandardSpacing;
  169. _TreeView.DrawSearchField(searchArea);
  170. _TreeView.OnGUI(area);
  171. DoFooterGUI();
  172. }
  173. /************************************************************************************************************************/
  174. /// <inheritdoc/>
  175. public virtual Transform Root
  176. => AnimancerUtilities.FindRoot(SourceObject.gameObject);
  177. /// <inheritdoc/>
  178. public abstract IList<Transform> Transforms { get; }
  179. /************************************************************************************************************************/
  180. /// <inheritdoc/>
  181. public virtual void BeforeRowGUI(Rect area, TreeViewItem item)
  182. {
  183. var color = GetRowColor(item);
  184. if (color.a > 0)
  185. EditorGUI.DrawRect(area, color);
  186. }
  187. /// <summary>Gets the color of a row in the <see cref="TreeView"/>.</summary>
  188. protected virtual Color GetRowColor(TreeViewItem item)
  189. => default;
  190. /************************************************************************************************************************/
  191. /// <inheritdoc/>
  192. public abstract void DrawCellGUI(Rect area, int column, int row, TreeViewItem item, ref bool isSelectionClick);
  193. /************************************************************************************************************************/
  194. /// <summary>Draws a <see cref="Transform"/> cell.</summary>
  195. public void DrawTransformCellGUI(Rect area, Transform transform)
  196. {
  197. var enabled = GUI.enabled;
  198. if (Event.current.type != EventType.Repaint)
  199. GUI.enabled = false;
  200. DoObjectFieldGUI(area, GUIContent.none, transform.gameObject, true);
  201. GUI.enabled = enabled;
  202. }
  203. /************************************************************************************************************************/
  204. /// <summary>Draws a cell to toggle whether a particular item is included or not.</summary>
  205. public void DrawIsIncludedCellGUI(
  206. Rect area,
  207. int treeItemID,
  208. int definitionIndex,
  209. ref bool isSelectionClick)
  210. {
  211. EditorGUI.BeginChangeCheck();
  212. var isIncluded = definitionIndex >= 0;
  213. isIncluded = GUI.Toggle(area, isIncluded, "");
  214. if (EditorGUI.EndChangeCheck())
  215. {
  216. SetIncludedWithSelection(treeItemID, isIncluded);
  217. isSelectionClick = false;
  218. }
  219. }
  220. /************************************************************************************************************************/
  221. private static readonly List<int>
  222. TreeItemIDs = new();
  223. private List<int> GetSelectedIDsWith(int treeItemID)
  224. {
  225. TreeItemIDs.Clear();
  226. TreeItemIDs.AddRange(TreeView.GetSelection());
  227. if (!TreeItemIDs.Contains(treeItemID))
  228. TreeItemIDs.Add(treeItemID);
  229. TreeItemIDs.Sort();
  230. return TreeItemIDs;
  231. }
  232. /************************************************************************************************************************/
  233. private void SetIncludedWithSelection(
  234. int treeItemID,
  235. bool isIncluded)
  236. {
  237. RecordUndo();
  238. var selected = GetSelectedIDsWith(treeItemID);
  239. for (int i = selected.Count - 1; i >= 0; i--)
  240. {
  241. treeItemID = selected[i];
  242. var definitionIndex = GetDefinitionIndex(treeItemID);
  243. SetIncluded(treeItemID, definitionIndex, isIncluded);
  244. EditorGUIUtility.editingTextField = false;
  245. }
  246. TreeView.Reload();
  247. GUIUtility.ExitGUI();
  248. }
  249. /// <summary>Adds or removes an item from the <see cref="SerializedDataEditorWindow{TObject, TData}.Data"/>.</summary>
  250. protected abstract void SetIncluded(
  251. int treeItemID,
  252. int definitionIndex,
  253. bool isIncluded);
  254. /************************************************************************************************************************/
  255. /// <summary>Sets the value of a field for all selected items.</summary>
  256. protected void SetValue(
  257. int treeItemID,
  258. Action<int> setValue)
  259. {
  260. RecordUndo();
  261. var selected = GetSelectedIDsWith(treeItemID);
  262. for (int i = selected.Count - 1; i >= 0; i--)
  263. {
  264. var definitionIndex = GetDefinitionIndex(selected[i]);
  265. if (definitionIndex >= 0)
  266. setValue(definitionIndex);
  267. }
  268. }
  269. /************************************************************************************************************************/
  270. /// <summary>
  271. /// Gets the index in the <see cref="SerializedDataEditorWindow{TObject, TData}.Data"/>
  272. /// corresponding to a row in the <see cref="TreeView"/>.
  273. /// Returns -1 if the row isn't included.
  274. /// </summary>
  275. protected virtual int GetDefinitionIndex(int treeItemID)
  276. {
  277. if (_TreeView.Transforms.TryGetObject(treeItemID, out var transform))
  278. return Transforms.IndexOf(transform);
  279. else
  280. return -1;
  281. }
  282. /************************************************************************************************************************/
  283. private static readonly GUIContent
  284. RevertLabel = new(
  285. "Revert",
  286. "Undo all changes made in this window"),
  287. ApplyLabel = new(
  288. "Apply",
  289. "Apply all changes made in this window to the source object"),
  290. AutoApplyLabel = new(
  291. "Auto Apply",
  292. "Immediately apply all changes made in this window to the source object?");
  293. /// <summary>Draws the GUI at the bottom of this window.</summary>
  294. protected virtual void DoFooterGUI()
  295. {
  296. GUILayout.Space(StandardSpacing);
  297. var area = GUILayoutUtility.GetRect(0, 0);
  298. area.y -= 1;
  299. area.height = 1;
  300. EditorGUI.DrawRect(area, Grey(0.5f, 0.5f));
  301. GUILayout.BeginHorizontal();
  302. using (new EditorGUI.DisabledScope(Event.current.type != EventType.Repaint))
  303. DoObjectFieldGUI("", SourceObject, true);
  304. GUILayout.FlexibleSpace();
  305. DoFooterCenterGUI();
  306. GUILayout.FlexibleSpace();
  307. DoApplyRevertGUI();
  308. GUILayout.EndHorizontal();
  309. }
  310. /// <summary>Draws additional GUI controls in the center of the footer.</summary>
  311. protected virtual void DoFooterCenterGUI() { }
  312. /************************************************************************************************************************/
  313. /// <inheritdoc/>
  314. public override void Revert()
  315. {
  316. base.Revert();
  317. _TreeView.Reload();
  318. }
  319. /************************************************************************************************************************/
  320. private void ReloadTreeView()
  321. => TreeView.Reload();
  322. /************************************************************************************************************************/
  323. }
  324. }
  325. #endif