No Description
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

TimelineKeyboardNavigation.cs 15KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Linq;
  4. using UnityEditor.IMGUI.Controls;
  5. using UnityEngine.Timeline;
  6. namespace UnityEditor.Timeline
  7. {
  8. static class KeyboardNavigation
  9. {
  10. public static void FrameTrackHeader(TreeViewItem treeItem = null)
  11. {
  12. if (TrackHeadActive())
  13. treeItem = treeItem ?? SelectionManager.SelectedTrackGUI().Last();
  14. else
  15. {
  16. var item = GetVisibleSelectedItems().LastOrDefault();
  17. treeItem = TimelineWindow.instance.allTracks.FirstOrDefault(
  18. x => item != null && x.track == item.parentTrack);
  19. }
  20. if (treeItem != null)
  21. TimelineWindow.instance.treeView.FrameItem(treeItem);
  22. }
  23. public static bool TrackHeadActive()
  24. {
  25. return SelectionManager.SelectedTracks().Any(x => x.IsVisibleInHierarchy()) && !ClipAreaActive();
  26. }
  27. public static bool ClipAreaActive()
  28. {
  29. return GetVisibleSelectedItems().Any();
  30. }
  31. public static IEnumerable<ITimelineItem> GetVisibleSelectedItems()
  32. {
  33. return SelectionManager.SelectedItems().Where(x => x.parentTrack.IsVisibleInHierarchy());
  34. }
  35. public static IEnumerable<TimelineTrackBaseGUI> GetVisibleTracks()
  36. {
  37. return TimelineWindow.instance.allTracks.Where(x => x.track.IsVisibleInHierarchy());
  38. }
  39. static TrackAsset PreviousTrack(this TrackAsset track)
  40. {
  41. var uiOrderTracks = GetVisibleTracks().Select(t => t.track).ToList();
  42. var selIdx = uiOrderTracks.IndexOf(track);
  43. return selIdx > 0 ? uiOrderTracks[selIdx - 1] : null;
  44. }
  45. static TrackAsset NextTrack(this TrackAsset track)
  46. {
  47. var uiOrderTracks = GetVisibleTracks().Select(t => t.track).ToList();
  48. var selIdx = uiOrderTracks.IndexOf(track);
  49. return selIdx < uiOrderTracks.Count - 1 && selIdx != -1 ? uiOrderTracks[selIdx + 1] : null;
  50. }
  51. static ITimelineItem PreviousItem(this ITimelineItem item, bool clipOnly)
  52. {
  53. var items = item.parentTrack.GetItems().ToArray();
  54. if (clipOnly)
  55. {
  56. items = items.Where(x => x is ClipItem).ToArray();
  57. }
  58. else
  59. {
  60. items = items.Where(x => x is MarkerItem).ToArray();
  61. }
  62. var idx = Array.IndexOf(items, item);
  63. return idx > 0 ? items[idx - 1] : null;
  64. }
  65. static ITimelineItem NextItem(this ITimelineItem item, bool clipOnly)
  66. {
  67. var items = item.parentTrack.GetItems().ToArray();
  68. if (clipOnly)
  69. {
  70. items = items.Where(x => x is ClipItem).ToArray();
  71. }
  72. else
  73. {
  74. items = items.Where(x => x is MarkerItem).ToArray();
  75. }
  76. var idx = Array.IndexOf(items, item);
  77. return idx < items.Length - 1 ? items[idx + 1] : null;
  78. }
  79. static bool FilterItems(ref List<ITimelineItem> items)
  80. {
  81. var clipOnly = false;
  82. if (items.Any(x => x is ClipItem))
  83. {
  84. items = items.Where(x => x is ClipItem).ToList();
  85. clipOnly = true;
  86. }
  87. return clipOnly;
  88. }
  89. static ITimelineItem GetClosestItem(TrackAsset track, ITimelineItem refItem)
  90. {
  91. var start = refItem.start;
  92. var end = refItem.end;
  93. var items = track.GetItems().ToList();
  94. if (refItem is ClipItem)
  95. {
  96. items = items.Where(x => x is ClipItem).ToList();
  97. }
  98. else
  99. {
  100. items = items.Where(x => x is MarkerItem).ToList();
  101. }
  102. if (!items.Any())
  103. return null;
  104. ITimelineItem ret = null;
  105. var scoreToBeat = double.NegativeInfinity;
  106. foreach (var item in items)
  107. {
  108. // test for overlap
  109. var low = Math.Max(item.start, start);
  110. var high = Math.Min(item.end, end);
  111. if (low <= high)
  112. {
  113. var score = high - low;
  114. if (score >= scoreToBeat)
  115. {
  116. scoreToBeat = score;
  117. ret = item;
  118. }
  119. }
  120. }
  121. return ret;
  122. }
  123. public static bool FocusFirstVisibleItem(IEnumerable<TrackAsset> focusTracks = null)
  124. {
  125. var timeRange = TimelineEditor.visibleTimeRange;
  126. var tracks = focusTracks ?? TimelineWindow.instance.treeView.visibleTracks.Where(x => x.IsVisibleInHierarchy() && x.GetItems().Any());
  127. var items = tracks.SelectMany(t => t.GetItems().OfType<ClipItem>().Where(x => x.end >= timeRange.x && x.end <= timeRange.y ||
  128. x.start >= timeRange.x && x.start <= timeRange.y)).ToList();
  129. var itemFullyInView = items.Where(x => x.end >= timeRange.x && x.end <= timeRange.y &&
  130. x.start >= timeRange.x && x.start <= timeRange.y);
  131. var itemToSelect = itemFullyInView.FirstOrDefault() ?? items.FirstOrDefault();
  132. if (itemToSelect != null && !itemToSelect.parentTrack.lockedInHierarchy)
  133. {
  134. SelectionManager.SelectOnly(itemToSelect);
  135. return true;
  136. }
  137. return false;
  138. }
  139. public static bool NavigateLeft(IEnumerable<TrackAsset> tracks)
  140. {
  141. if (!TrackHeadActive())
  142. return false;
  143. if (TryCollapse(tracks))
  144. return true;
  145. return SelectAndShowParentTrack(tracks.LastOrDefault());
  146. }
  147. /// <summary>
  148. /// Tries to collapse any track from a list of tracks
  149. /// </summary>
  150. /// <param name="tracks"></param>
  151. /// <returns>true if any were collapsed, false otherwise</returns>
  152. public static bool TryCollapse(IEnumerable<TrackAsset> tracks)
  153. {
  154. var didCollapse = false;
  155. foreach (TrackAsset track in tracks)
  156. {
  157. if (!track.GetChildTracks().Any())
  158. continue;
  159. if (!track.IsCollapsed())
  160. {
  161. didCollapse = true;
  162. track.SetCollapsed(true);
  163. }
  164. }
  165. if (didCollapse)
  166. {
  167. TimelineEditor.window.treeView.Reload();
  168. return true;
  169. }
  170. return false;
  171. }
  172. public static bool ToggleCollapseGroup(IEnumerable<TrackAsset> tracks)
  173. {
  174. if (!TrackHeadActive())
  175. return false;
  176. var didChange = false;
  177. foreach (TrackAsset track in tracks)
  178. {
  179. if (!track.GetChildTracks().Any())
  180. continue;
  181. track.SetCollapsed(!track.IsCollapsed());
  182. didChange = true;
  183. }
  184. if (didChange)
  185. TimelineEditor.window.treeView.Reload();
  186. return didChange;
  187. }
  188. static bool SelectAndShowParentTrack(TrackAsset track)
  189. {
  190. TrackAsset parent = track != null ? track.parent as TrackAsset : null;
  191. if (parent)
  192. {
  193. SelectionManager.SelectOnly(parent);
  194. FrameTrackHeader(GetVisibleTracks().FirstOrDefault(x => x.track == parent));
  195. return true;
  196. }
  197. return false;
  198. }
  199. public static bool SelectLeftItem(bool shift = false)
  200. {
  201. if (ClipAreaActive())
  202. {
  203. var items = SelectionManager.SelectedItems().ToList();
  204. var clipOnly = FilterItems(ref items);
  205. var item = items.Last();
  206. var prev = item.PreviousItem(clipOnly);
  207. if (prev != null && !prev.parentTrack.lockedInHierarchy)
  208. {
  209. if (shift)
  210. {
  211. if (SelectionManager.Contains(prev))
  212. SelectionManager.Remove(item);
  213. SelectionManager.Add(prev);
  214. }
  215. else
  216. SelectionManager.SelectOnly(prev);
  217. TimelineHelpers.FrameItems(new[] { prev });
  218. }
  219. else if (item != null && !shift && item.parentTrack != TimelineEditor.inspectedAsset.markerTrack)
  220. SelectionManager.SelectOnly(item.parentTrack);
  221. return true;
  222. }
  223. return false;
  224. }
  225. public static bool SelectRightItem(bool shift = false)
  226. {
  227. if (ClipAreaActive())
  228. {
  229. var items = SelectionManager.SelectedItems().ToList();
  230. var clipOnly = FilterItems(ref items);
  231. var item = items.Last();
  232. var next = item.NextItem(clipOnly);
  233. if (next != null && !next.parentTrack.lockedInHierarchy)
  234. {
  235. if (shift)
  236. {
  237. if (SelectionManager.Contains(next))
  238. SelectionManager.Remove(item);
  239. SelectionManager.Add(next);
  240. }
  241. else
  242. SelectionManager.SelectOnly(next);
  243. TimelineHelpers.FrameItems(new[] { next });
  244. return true;
  245. }
  246. }
  247. return false;
  248. }
  249. public static bool NavigateRight(IEnumerable<TrackAsset> tracks)
  250. {
  251. if (!TrackHeadActive())
  252. return false;
  253. if (TryExpand(tracks))
  254. return true;
  255. return TrySelectFirstChild(tracks);
  256. }
  257. /// <summary>
  258. /// Tries to expand from a list of tracks
  259. /// </summary>
  260. /// <param name="tracks"></param>
  261. /// <returns>true if any expanded, false otherwise</returns>
  262. public static bool TryExpand(IEnumerable<TrackAsset> tracks)
  263. {
  264. var didExpand = false;
  265. foreach (TrackAsset track in tracks)
  266. {
  267. if (!track.GetChildTracks().Any())
  268. continue;
  269. if (track.IsCollapsed())
  270. {
  271. didExpand = true;
  272. track.SetCollapsed(false);
  273. }
  274. }
  275. if (didExpand)
  276. {
  277. TimelineEditor.window.treeView.Reload();
  278. }
  279. return didExpand;
  280. }
  281. /// <summary>
  282. /// Tries to select the first clip from a list of tracks
  283. /// </summary>
  284. /// <param name="tracks"></param>
  285. /// <returns>true if any expanded, false otherwise</returns>
  286. public static bool TrySelectFirstChild(IEnumerable<TrackAsset> tracks)
  287. {
  288. foreach (var track in tracks)
  289. {
  290. //Try to navigate in group tracks first
  291. if (track is GroupTrack)
  292. {
  293. if (track.GetChildTracks().Any())
  294. {
  295. SelectionManager.SelectOnly(track.GetChildTracks().First());
  296. return true;
  297. }
  298. //Group tracks should not halt navigation
  299. continue;
  300. }
  301. //if track is locked or has no clips, do nothing
  302. if (track.lockedInHierarchy || !track.clips.Any())
  303. continue;
  304. var firstClip = track.clips.First();
  305. SelectionManager.SelectOnly(firstClip);
  306. TimelineHelpers.FrameItems(new ITimelineItem[] { firstClip.ToItem() });
  307. return true;
  308. }
  309. return false;
  310. }
  311. public static bool SelectUpTrack(bool shift = false)
  312. {
  313. if (TrackHeadActive())
  314. {
  315. var prevTrack = PreviousTrack(SelectionManager.SelectedTracks().Last());
  316. if (prevTrack != null)
  317. {
  318. if (shift)
  319. {
  320. if (SelectionManager.Contains(prevTrack))
  321. SelectionManager.Remove(SelectionManager.SelectedTracks().Last());
  322. SelectionManager.Add(prevTrack);
  323. }
  324. else
  325. SelectionManager.SelectOnly(prevTrack);
  326. FrameTrackHeader(GetVisibleTracks().First(x => x.track == prevTrack));
  327. }
  328. return true;
  329. }
  330. return false;
  331. }
  332. public static bool SelectUpItem()
  333. {
  334. if (ClipAreaActive())
  335. {
  336. var refItem = SelectionManager.SelectedItems().Last();
  337. var prevTrack = refItem.parentTrack.PreviousTrack();
  338. while (prevTrack != null)
  339. {
  340. var selectionItem = GetClosestItem(prevTrack, refItem);
  341. if (selectionItem == null || prevTrack.lockedInHierarchy)
  342. {
  343. prevTrack = prevTrack.PreviousTrack();
  344. continue;
  345. }
  346. SelectionManager.SelectOnly(selectionItem);
  347. TimelineHelpers.FrameItems(new[] { selectionItem });
  348. FrameTrackHeader(GetVisibleTracks().First(x => x.track == selectionItem.parentTrack));
  349. break;
  350. }
  351. return true;
  352. }
  353. return false;
  354. }
  355. public static bool SelectDownTrack(bool shift = false)
  356. {
  357. if (TrackHeadActive())
  358. {
  359. var nextTrack = SelectionManager.SelectedTracks().Last().NextTrack();
  360. if (nextTrack != null)
  361. {
  362. if (shift)
  363. {
  364. if (SelectionManager.Contains(nextTrack))
  365. SelectionManager.Remove(SelectionManager.SelectedTracks().Last());
  366. SelectionManager.Add(nextTrack);
  367. }
  368. else
  369. SelectionManager.SelectOnly(nextTrack);
  370. FrameTrackHeader(GetVisibleTracks().First(x => x.track == nextTrack));
  371. }
  372. return true;
  373. }
  374. return false;
  375. }
  376. public static bool SelectDownItem()
  377. {
  378. if (ClipAreaActive())
  379. {
  380. var refItem = SelectionManager.SelectedItems().Last();
  381. var nextTrack = refItem.parentTrack.NextTrack();
  382. while (nextTrack != null)
  383. {
  384. var selectionItem = GetClosestItem(nextTrack, refItem);
  385. if (selectionItem == null || nextTrack.lockedInHierarchy)
  386. {
  387. nextTrack = nextTrack.NextTrack();
  388. continue;
  389. }
  390. SelectionManager.SelectOnly(selectionItem);
  391. TimelineHelpers.FrameItems(new[] { selectionItem });
  392. FrameTrackHeader(GetVisibleTracks().First(x => x.track == selectionItem.parentTrack));
  393. break;
  394. }
  395. return true;
  396. }
  397. return false;
  398. }
  399. }
  400. }