GUICurveEditor.cs 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620
  1. //********************************** Banshee Engine (www.banshee3d.com) **************************************************//
  2. //**************** Copyright (c) 2016 Marko Pintera ([email protected]). All rights reserved. **********************//
  3. using System;
  4. using System.Collections.Generic;
  5. using BansheeEngine;
  6. namespace BansheeEditor
  7. {
  8. /** @addtogroup AnimationEditor
  9. * @{
  10. */
  11. internal class GUICurveEditor
  12. {
  13. class SelectedKeyframes
  14. {
  15. public int curveIdx;
  16. public List<int> keyIndices = new List<int>();
  17. }
  18. struct DraggedKeyframe
  19. {
  20. public DraggedKeyframe(int index, KeyFrame original)
  21. {
  22. this.index = index;
  23. this.original = original;
  24. }
  25. public int index;
  26. public KeyFrame original;
  27. }
  28. class DraggedKeyframes
  29. {
  30. public int curveIdx;
  31. public List<DraggedKeyframe> keys = new List<DraggedKeyframe>();
  32. }
  33. private const int TIMELINE_HEIGHT = 20;
  34. private const int SIDEBAR_WIDTH = 30;
  35. private const int DRAG_START_DISTANCE = 3;
  36. private EditorWindow window;
  37. private GUILayout gui;
  38. private GUIPanel drawingPanel;
  39. private GUIGraphTime guiTimeline;
  40. private GUICurveDrawing guiCurveDrawing;
  41. private GUIGraphValues guiSidebar;
  42. private ContextMenu blankContextMenu;
  43. private ContextMenu keyframeContextMenu;
  44. private Vector2I contextClickPosition;
  45. private EdAnimationCurve[] curves = new EdAnimationCurve[0];
  46. private float xRange;
  47. private float yRange;
  48. private int markedFrameIdx;
  49. private List<SelectedKeyframes> selectedKeyframes = new List<SelectedKeyframes>();
  50. private bool isPointerHeld;
  51. private bool isMousePressedOverKey;
  52. private bool isMousePressedOverTangent;
  53. private bool isDragInProgress;
  54. private List<DraggedKeyframes> draggedKeyframes = new List<DraggedKeyframes>();
  55. private TangentRef draggedTangent;
  56. private Vector2I dragStart;
  57. /// <summary>
  58. /// Triggers whenever user selects a new frame.
  59. /// </summary>
  60. public Action<int> OnFrameSelected;
  61. /// <summary>
  62. /// Returns the displayed range of the curve on the x axis (time).
  63. /// </summary>
  64. public float XRange
  65. {
  66. get { return xRange; }
  67. }
  68. /// <summary>
  69. /// Returns the displayed range of the curve on the y axis.
  70. /// </summary>
  71. public float YRange
  72. {
  73. get { return yRange; }
  74. }
  75. public GUICurveEditor(EditorWindow window, GUILayout gui, int width, int height)
  76. {
  77. this.window = window;
  78. this.gui = gui;
  79. blankContextMenu = new ContextMenu();
  80. blankContextMenu.AddItem("Add keyframe", AddKeyframeAtPosition);
  81. keyframeContextMenu = new ContextMenu();
  82. keyframeContextMenu.AddItem("Delete", DeleteSelectedKeyframes);
  83. keyframeContextMenu.AddItem("Tangents/Auto", () => { ChangeSelectionTangentMode(TangentMode.Auto); });
  84. keyframeContextMenu.AddItem("Tangents/Free", () => { ChangeSelectionTangentMode(TangentMode.Free); });
  85. keyframeContextMenu.AddItem("Tangents/In/Auto", () => { ChangeSelectionTangentMode(TangentMode.InAuto); });
  86. keyframeContextMenu.AddItem("Tangents/In/Free", () => { ChangeSelectionTangentMode(TangentMode.InFree); });
  87. keyframeContextMenu.AddItem("Tangents/In/Linear", () => { ChangeSelectionTangentMode(TangentMode.InLinear); });
  88. keyframeContextMenu.AddItem("Tangents/In/Step", () => { ChangeSelectionTangentMode(TangentMode.InStep); });
  89. keyframeContextMenu.AddItem("Tangents/Out/Auto", () => { ChangeSelectionTangentMode(TangentMode.OutAuto); });
  90. keyframeContextMenu.AddItem("Tangents/Out/Free", () => { ChangeSelectionTangentMode(TangentMode.OutFree); });
  91. keyframeContextMenu.AddItem("Tangents/Out/Linear", () => { ChangeSelectionTangentMode(TangentMode.OutLinear); });
  92. keyframeContextMenu.AddItem("Tangents/Out/Step", () => { ChangeSelectionTangentMode(TangentMode.OutStep); });
  93. guiTimeline = new GUIGraphTime(gui, width, TIMELINE_HEIGHT);
  94. drawingPanel = gui.AddPanel();
  95. drawingPanel.SetPosition(0, TIMELINE_HEIGHT);
  96. guiCurveDrawing = new GUICurveDrawing(drawingPanel, width, height - TIMELINE_HEIGHT, curves);
  97. guiCurveDrawing.SetRange(60.0f, 20.0f);
  98. GUIPanel sidebarPanel = gui.AddPanel(-10);
  99. sidebarPanel.SetPosition(0, TIMELINE_HEIGHT);
  100. guiSidebar = new GUIGraphValues(sidebarPanel, SIDEBAR_WIDTH, height - TIMELINE_HEIGHT);
  101. guiSidebar.SetRange(-10.0f, 10.0f);
  102. }
  103. internal void OnPointerPressed(PointerEvent ev)
  104. {
  105. if (ev.IsUsed)
  106. return;
  107. Vector2I windowPos = window.ScreenToWindowPos(ev.ScreenPos);
  108. Rect2I elementBounds = GUIUtility.CalculateBounds(gui, window.GUI);
  109. Vector2I pointerPos = windowPos - new Vector2I(elementBounds.x, elementBounds.y);
  110. Rect2I drawingBounds = drawingPanel.Bounds;
  111. Vector2I drawingPos = pointerPos - new Vector2I(drawingBounds.x, drawingBounds.y);
  112. if (ev.Button == PointerButton.Left)
  113. {
  114. Vector2 curveCoord;
  115. if (guiCurveDrawing.PixelToCurveSpace(drawingPos, out curveCoord))
  116. {
  117. KeyframeRef keyframeRef;
  118. if (!guiCurveDrawing.FindKeyFrame(drawingPos, out keyframeRef))
  119. {
  120. TangentRef tangentRef;
  121. if (guiCurveDrawing.FindTangent(drawingPos, out tangentRef))
  122. {
  123. isMousePressedOverTangent = true;
  124. dragStart = drawingPos;
  125. draggedTangent = tangentRef;
  126. }
  127. else
  128. ClearSelection();
  129. }
  130. else
  131. {
  132. if (!IsSelected(keyframeRef))
  133. {
  134. if (!Input.IsButtonHeld(ButtonCode.LeftShift) && !Input.IsButtonHeld(ButtonCode.RightShift))
  135. ClearSelection();
  136. SelectKeyframe(keyframeRef);
  137. }
  138. isMousePressedOverKey = true;
  139. dragStart = drawingPos;
  140. }
  141. guiCurveDrawing.Rebuild();
  142. }
  143. else
  144. {
  145. int frameIdx = guiTimeline.GetFrame(pointerPos);
  146. if (frameIdx != -1)
  147. SetMarkedFrame(frameIdx);
  148. OnFrameSelected?.Invoke(frameIdx);
  149. }
  150. isPointerHeld = true;
  151. }
  152. else if (ev.Button == PointerButton.Right)
  153. {
  154. Vector2 curveCoord;
  155. if (guiCurveDrawing.PixelToCurveSpace(drawingPos, out curveCoord))
  156. {
  157. contextClickPosition = drawingPos;
  158. KeyframeRef keyframeRef;
  159. if (!guiCurveDrawing.FindKeyFrame(drawingPos, out keyframeRef))
  160. {
  161. ClearSelection();
  162. blankContextMenu.Open(pointerPos, gui);
  163. }
  164. else
  165. {
  166. // If clicked outside of current selection, just select the one keyframe
  167. if (!IsSelected(keyframeRef))
  168. {
  169. ClearSelection();
  170. SelectKeyframe(keyframeRef);
  171. guiCurveDrawing.Rebuild();
  172. }
  173. keyframeContextMenu.Open(pointerPos, gui);
  174. }
  175. }
  176. }
  177. }
  178. internal void OnPointerMoved(PointerEvent ev)
  179. {
  180. if (ev.Button != PointerButton.Left)
  181. return;
  182. if (isPointerHeld)
  183. {
  184. Vector2I windowPos = window.ScreenToWindowPos(ev.ScreenPos);
  185. Rect2I elementBounds = GUIUtility.CalculateBounds(gui, window.GUI);
  186. Vector2I pointerPos = windowPos - new Vector2I(elementBounds.x, elementBounds.y);
  187. if (isMousePressedOverKey || isMousePressedOverTangent)
  188. {
  189. Rect2I drawingBounds = drawingPanel.Bounds;
  190. Vector2I drawingPos = pointerPos - new Vector2I(drawingBounds.x, drawingBounds.y);
  191. if (!isDragInProgress)
  192. {
  193. int distance = Vector2I.Distance(drawingPos, dragStart);
  194. if (distance >= DRAG_START_DISTANCE)
  195. {
  196. if (isMousePressedOverKey)
  197. {
  198. draggedKeyframes.Clear();
  199. foreach (var selectedEntry in selectedKeyframes)
  200. {
  201. EdAnimationCurve curve = curves[selectedEntry.curveIdx];
  202. KeyFrame[] keyFrames = curve.KeyFrames;
  203. DraggedKeyframes newEntry = new DraggedKeyframes();
  204. newEntry.curveIdx = selectedEntry.curveIdx;
  205. draggedKeyframes.Add(newEntry);
  206. foreach (var keyframeIdx in selectedEntry.keyIndices)
  207. newEntry.keys.Add(new DraggedKeyframe(keyframeIdx, keyFrames[keyframeIdx]));
  208. }
  209. }
  210. // TODO - UNDOREDO record keyframe or tangent
  211. isDragInProgress = true;
  212. }
  213. }
  214. if (isDragInProgress)
  215. {
  216. if (isMousePressedOverKey)
  217. {
  218. Vector2 diff = Vector2.Zero;
  219. Vector2 dragStartCurve;
  220. if (guiCurveDrawing.PixelToCurveSpace(dragStart, out dragStartCurve))
  221. {
  222. Vector2 currentPosCurve;
  223. if (guiCurveDrawing.PixelToCurveSpace(drawingPos, out currentPosCurve))
  224. diff = currentPosCurve - dragStartCurve;
  225. }
  226. foreach (var draggedEntry in draggedKeyframes)
  227. {
  228. EdAnimationCurve curve = curves[draggedEntry.curveIdx];
  229. for (int i = 0; i < draggedEntry.keys.Count; i++)
  230. {
  231. DraggedKeyframe draggedKey = draggedEntry.keys[i];
  232. float newTime = draggedKey.original.time + diff.x;
  233. float newValue = draggedKey.original.value + diff.y;
  234. int newIndex = curve.UpdateKeyframe(draggedKey.index, newTime, newValue);
  235. // It's possible key changed position due to time change, but since we're moving all
  236. // keys at once they cannot change position relative to one another, otherwise we would
  237. // need to update indices for other keys as well.
  238. draggedKey.index = newIndex;
  239. draggedEntry.keys[i] = draggedKey;
  240. }
  241. curve.Apply();
  242. }
  243. // Rebuild selected keys from dragged keys (after potential sorting)
  244. ClearSelection();
  245. foreach (var draggedEntry in draggedKeyframes)
  246. {
  247. foreach (var keyframe in draggedEntry.keys)
  248. SelectKeyframe(new KeyframeRef(draggedEntry.curveIdx, keyframe.index));
  249. }
  250. guiCurveDrawing.Rebuild();
  251. }
  252. else if (isMousePressedOverTangent)
  253. {
  254. EdAnimationCurve curve = curves[draggedTangent.keyframeRef.curveIdx];
  255. KeyFrame keyframe = curve.KeyFrames[draggedTangent.keyframeRef.keyIdx];
  256. Vector2 keyframeCurveCoords = new Vector2(keyframe.time, keyframe.value);
  257. Vector2 currentPosCurve;
  258. if (guiCurveDrawing.PixelToCurveSpace(drawingPos, out currentPosCurve))
  259. {
  260. Vector2 normal = currentPosCurve - keyframeCurveCoords;
  261. normal = normal.Normalized;
  262. float tangent = EdAnimationCurve.NormalToTangent(normal);
  263. if (draggedTangent.type == TangentType.In)
  264. {
  265. if (normal.x > 0.0f)
  266. tangent = float.PositiveInfinity;
  267. keyframe.inTangent = tangent;
  268. }
  269. else
  270. {
  271. if (normal.x < 0.0f)
  272. tangent = float.PositiveInfinity;
  273. keyframe.outTangent = tangent;
  274. }
  275. curve.KeyFrames[draggedTangent.keyframeRef.keyIdx] = keyframe;
  276. curve.Apply();
  277. guiCurveDrawing.Rebuild();
  278. }
  279. }
  280. }
  281. }
  282. else // Move frame marker
  283. {
  284. int frameIdx = guiTimeline.GetFrame(pointerPos);
  285. if (frameIdx != -1)
  286. SetMarkedFrame(frameIdx);
  287. OnFrameSelected?.Invoke(frameIdx);
  288. }
  289. }
  290. }
  291. internal void OnPointerReleased(PointerEvent ev)
  292. {
  293. isPointerHeld = false;
  294. isDragInProgress = false;
  295. isMousePressedOverKey = false;
  296. isMousePressedOverTangent = false;
  297. }
  298. internal void OnButtonUp(ButtonEvent ev)
  299. {
  300. if(ev.Button == ButtonCode.Delete)
  301. DeleteSelectedKeyframes();
  302. }
  303. /// <summary>
  304. /// Change the set of curves to display.
  305. /// </summary>
  306. /// <param name="curves">New set of curves to draw on the GUI element.</param>
  307. public void SetCurves(EdAnimationCurve[] curves)
  308. {
  309. this.curves = curves;
  310. guiCurveDrawing.SetCurves(curves);
  311. Redraw();
  312. }
  313. /// <summary>
  314. /// Change the physical size of the GUI element.
  315. /// </summary>
  316. /// <param name="width">Width of the element in pixels.</param>
  317. /// <param name="height">Height of the element in pixels.</param>
  318. public void SetSize(int width, int height)
  319. {
  320. guiTimeline.SetSize(width, TIMELINE_HEIGHT);
  321. guiCurveDrawing.SetSize(width, height - TIMELINE_HEIGHT);
  322. guiSidebar.SetSize(SIDEBAR_WIDTH, height - TIMELINE_HEIGHT);
  323. Redraw();
  324. }
  325. /// <summary>
  326. /// Changes the visible range that the GUI element displays.
  327. /// </summary>
  328. /// <param name="xRange">Range of the horizontal area. Displayed area will range from [0, xRange].</param>
  329. /// <param name="yRange">Range of the vertical area. Displayed area will range from
  330. /// [-yRange, yRange]</param>
  331. public void SetRange(float xRange, float yRange)
  332. {
  333. this.xRange = xRange;
  334. this.yRange = yRange;
  335. guiTimeline.SetRange(xRange);
  336. guiCurveDrawing.SetRange(xRange, yRange * 2.0f);
  337. guiSidebar.SetRange(yRange, yRange);
  338. Redraw();
  339. }
  340. /// <summary>
  341. /// Number of frames per second, used for frame selection and marking.
  342. /// </summary>
  343. /// <param name="fps">Number of prames per second.</param>
  344. public void SetFPS(int fps)
  345. {
  346. guiTimeline.SetFPS(fps);
  347. guiCurveDrawing.SetFPS(fps);
  348. Redraw();
  349. }
  350. /// <summary>
  351. /// Returns time for a frame with the specified index. Depends on set range and FPS.
  352. /// </summary>
  353. /// <param name="frameIdx">Index of the frame (not a key-frame) to get the time for.</param>
  354. /// <returns>Time of the frame with the provided index. </returns>
  355. public float GetTimeForFrame(int frameIdx)
  356. {
  357. return guiCurveDrawing.GetTimeForFrame(markedFrameIdx);
  358. }
  359. /// <summary>
  360. /// Sets the frame at which to display the frame marker.
  361. /// </summary>
  362. /// <param name="frameIdx">Index of the frame to display the marker on, or -1 to clear the marker.</param>
  363. public void SetMarkedFrame(int frameIdx)
  364. {
  365. markedFrameIdx = frameIdx;
  366. guiTimeline.SetMarkedFrame(frameIdx);
  367. guiCurveDrawing.SetMarkedFrame(frameIdx);
  368. Redraw();
  369. }
  370. public void AddKeyFrameAtMarker()
  371. {
  372. ClearSelection();
  373. foreach (var curve in curves)
  374. {
  375. float t = guiCurveDrawing.GetTimeForFrame(markedFrameIdx);
  376. float value = curve.Evaluate(t);
  377. curve.AddKeyframe(t, value);
  378. curve.Apply();
  379. }
  380. // TODO - UNDOREDO
  381. guiCurveDrawing.Rebuild();
  382. }
  383. public void Redraw()
  384. {
  385. guiCurveDrawing.Rebuild();
  386. guiTimeline.Rebuild();
  387. guiSidebar.Rebuild();
  388. }
  389. private void ChangeSelectionTangentMode(TangentMode mode)
  390. {
  391. foreach (var selectedEntry in selectedKeyframes)
  392. {
  393. EdAnimationCurve curve = curves[selectedEntry.curveIdx];
  394. foreach (var keyframeIdx in selectedEntry.keyIndices)
  395. {
  396. if (mode == TangentMode.Auto || mode == TangentMode.Free)
  397. curve.SetTangentMode(keyframeIdx, mode);
  398. else
  399. {
  400. TangentMode newMode = curve.TangentModes[keyframeIdx];
  401. if (mode.HasFlag((TangentMode) TangentType.In))
  402. {
  403. // Replace only the in tangent mode, keeping the out tangent as is
  404. TangentMode inFlags = (TangentMode.InAuto | TangentMode.InFree | TangentMode.InLinear |
  405. TangentMode.InAuto);
  406. newMode &= ~inFlags;
  407. newMode |= (mode & inFlags);
  408. }
  409. else
  410. {
  411. // Replace only the out tangent mode, keeping the in tangent as is
  412. TangentMode outFlags = (TangentMode.OutAuto | TangentMode.OutFree | TangentMode.OutLinear |
  413. TangentMode.OutAuto);
  414. newMode &= ~outFlags;
  415. newMode |= (mode & outFlags);
  416. }
  417. curve.SetTangentMode(keyframeIdx, newMode);
  418. }
  419. }
  420. curve.Apply();
  421. }
  422. // TODO - UNDOREDO
  423. guiCurveDrawing.Rebuild();
  424. }
  425. private void AddKeyframeAtPosition()
  426. {
  427. Vector2 curveCoord;
  428. if (guiCurveDrawing.PixelToCurveSpace(contextClickPosition, out curveCoord))
  429. {
  430. ClearSelection();
  431. foreach (var curve in curves)
  432. {
  433. float t = curveCoord.x;
  434. float value = curveCoord.y;
  435. curve.AddKeyframe(t, value);
  436. curve.Apply();
  437. }
  438. // TODO - UNDOREDO
  439. guiCurveDrawing.Rebuild();
  440. }
  441. }
  442. private void DeleteSelectedKeyframes()
  443. {
  444. foreach (var selectedEntry in selectedKeyframes)
  445. {
  446. EdAnimationCurve curve = curves[selectedEntry.curveIdx];
  447. // Sort keys from highest to lowest so the indices don't change
  448. selectedEntry.keyIndices.Sort((x, y) =>
  449. {
  450. return y.CompareTo(x);
  451. });
  452. foreach (var keyframeIdx in selectedEntry.keyIndices)
  453. curve.RemoveKeyframe(keyframeIdx);
  454. curve.Apply();
  455. }
  456. // TODO - UNDOREDO
  457. ClearSelection();
  458. guiCurveDrawing.Rebuild();
  459. }
  460. private void ClearSelection()
  461. {
  462. guiCurveDrawing.ClearSelectedKeyframes();
  463. selectedKeyframes.Clear();
  464. }
  465. private void SelectKeyframe(KeyframeRef keyframeRef)
  466. {
  467. guiCurveDrawing.SelectKeyframe(keyframeRef, true);
  468. if (!IsSelected(keyframeRef))
  469. {
  470. int curveIdx = selectedKeyframes.FindIndex(x =>
  471. {
  472. return x.curveIdx == keyframeRef.curveIdx;
  473. });
  474. if (curveIdx == -1)
  475. {
  476. curveIdx = selectedKeyframes.Count;
  477. SelectedKeyframes newKeyframes = new SelectedKeyframes();
  478. newKeyframes.curveIdx = keyframeRef.curveIdx;
  479. selectedKeyframes.Add(newKeyframes);
  480. }
  481. selectedKeyframes[curveIdx].keyIndices.Add(keyframeRef.keyIdx);
  482. }
  483. }
  484. private bool IsSelected(KeyframeRef keyframeRef)
  485. {
  486. int curveIdx = selectedKeyframes.FindIndex(x =>
  487. {
  488. return x.curveIdx == keyframeRef.curveIdx;
  489. });
  490. if (curveIdx == -1)
  491. return false;
  492. int keyIdx = selectedKeyframes[curveIdx].keyIndices.FindIndex(x =>
  493. {
  494. return x == keyframeRef.keyIdx;
  495. });
  496. return keyIdx != -1;
  497. }
  498. }
  499. /** @} */
  500. }