暂无描述
您最多选择25个主题 主题必须以字母或数字开头,可以包含连字符 (-),并且长度不得超过35个字符

BaseGraph.API.cs 7.0KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191
  1. using System;
  2. using System.Collections;
  3. using UnityEngine;
  4. using UnityEngine.EventSystems;
  5. namespace XCharts.Runtime
  6. {
  7. /// <summary>
  8. /// The base class of all graphs or components.
  9. /// |所有图形的基类。
  10. /// </summary>
  11. public partial class BaseGraph
  12. {
  13. /// <summary>
  14. /// The x of graph.
  15. /// |图形的X
  16. /// </summary>
  17. public float graphX { get { return m_GraphX; } }
  18. /// <summary>
  19. /// The y of graph.
  20. /// |图形的Y
  21. /// </summary>
  22. public float graphY { get { return m_GraphY; } }
  23. /// <summary>
  24. /// The width of graph.
  25. /// |图形的宽
  26. /// </summary>
  27. public float graphWidth { get { return m_GraphWidth; } }
  28. /// <summary>
  29. /// The height of graph.
  30. /// |图形的高
  31. /// </summary>
  32. public float graphHeight { get { return m_GraphHeight; } }
  33. /// <summary>
  34. /// The position of graph.
  35. /// |图形的左下角起始坐标。
  36. /// </summary>
  37. public Vector3 graphPosition { get { return m_GraphPosition; } }
  38. public Rect graphRect { get { return m_GraphRect; } }
  39. public Vector2 graphSizeDelta { get { return m_GraphSizeDelta; } }
  40. public Vector2 graphPivot { get { return m_GraphPivot; } }
  41. public Vector2 graphMinAnchor { get { return m_GraphMinAnchor; } }
  42. public Vector2 graphMaxAnchor { get { return m_GraphMaxAnchor; } }
  43. public Vector2 graphAnchoredPosition { get { return m_GraphAnchoredPosition; } }
  44. /// <summary>
  45. /// The postion of pointer.
  46. /// |鼠标位置。
  47. /// </summary>
  48. public Vector2 pointerPos { get; protected set; }
  49. /// <summary>
  50. /// Whether the mouse pointer is in the chart.
  51. /// |鼠标是否在图表内。
  52. /// </summary>
  53. public bool isPointerInChart { get; protected set; }
  54. /// <summary>
  55. /// 警告信息。
  56. /// </summary>
  57. public string warningInfo { get; protected set; }
  58. /// <summary>
  59. /// 强制开启鼠标事件检测。
  60. /// </summary>
  61. public bool forceOpenRaycastTarget { get { return m_ForceOpenRaycastTarget; } set { m_ForceOpenRaycastTarget = value; } }
  62. /// <summary>
  63. /// 鼠标点击回调。
  64. /// </summary>
  65. public Action<PointerEventData, BaseGraph> onPointerClick { set { m_OnPointerClick = value; m_ForceOpenRaycastTarget = true; } }
  66. /// <summary>
  67. /// 鼠标按下回调。
  68. /// </summary>
  69. public Action<PointerEventData, BaseGraph> onPointerDown { set { m_OnPointerDown = value; m_ForceOpenRaycastTarget = true; } }
  70. /// <summary>
  71. /// 鼠标弹起回调。
  72. /// </summary>
  73. public Action<PointerEventData, BaseGraph> onPointerUp { set { m_OnPointerUp = value; m_ForceOpenRaycastTarget = true; } }
  74. /// <summary>
  75. /// 鼠标进入回调。
  76. /// </summary>
  77. public Action<PointerEventData, BaseGraph> onPointerEnter { set { m_OnPointerEnter = value; m_ForceOpenRaycastTarget = true; } }
  78. /// <summary>
  79. /// 鼠标退出回调。
  80. /// </summary>
  81. public Action<PointerEventData, BaseGraph> onPointerExit { set { m_OnPointerExit = value; m_ForceOpenRaycastTarget = true; } }
  82. /// <summary>
  83. /// 鼠标开始拖拽回调。
  84. /// </summary>
  85. public Action<PointerEventData, BaseGraph> onBeginDrag { set { m_OnBeginDrag = value; m_ForceOpenRaycastTarget = true; } }
  86. /// <summary>
  87. /// 鼠标拖拽回调。
  88. /// </summary>
  89. public Action<PointerEventData, BaseGraph> onDrag { set { m_OnDrag = value; m_ForceOpenRaycastTarget = true; } }
  90. /// <summary>
  91. /// 鼠标结束拖拽回调。
  92. /// </summary>
  93. public Action<PointerEventData, BaseGraph> onEndDrag { set { m_OnEndDrag = value; m_ForceOpenRaycastTarget = true; } }
  94. /// <summary>
  95. /// 鼠标滚动回调。
  96. /// </summary>
  97. public Action<PointerEventData, BaseGraph> onScroll { set { m_OnScroll = value; m_ForceOpenRaycastTarget = true; } }
  98. /// <summary>
  99. /// 设置图形的宽高(在非stretch pivot下才有效,其他情况需要自己调整RectTransform)
  100. /// </summary>
  101. /// <param name="width"></param>
  102. /// <param name="height"></param>
  103. public virtual void SetSize(float width, float height)
  104. {
  105. if (LayerHelper.IsFixedWidthHeight(rectTransform))
  106. {
  107. rectTransform.sizeDelta = new Vector2(width, height);
  108. }
  109. else
  110. {
  111. Debug.LogError("Can't set size on stretch pivot,you need to modify rectTransform by yourself.");
  112. }
  113. }
  114. /// <summary>
  115. /// 重新初始化Painter
  116. /// </summary>
  117. public void SetPainterDirty()
  118. {
  119. m_PainerDirty = true;
  120. }
  121. /// <summary>
  122. /// Redraw graph in next frame.
  123. /// |在下一帧刷新图形。
  124. /// </summary>
  125. public virtual void RefreshGraph()
  126. {
  127. m_RefreshChart = true;
  128. }
  129. public void RefreshAllComponent()
  130. {
  131. SetAllComponentDirty();
  132. RefreshGraph();
  133. }
  134. /// <summary>
  135. /// 检测警告信息。
  136. /// </summary>
  137. /// <returns></returns>
  138. public string CheckWarning()
  139. {
  140. warningInfo = CheckHelper.CheckChart(this);
  141. return warningInfo;
  142. }
  143. /// <summary>
  144. /// 移除并重新创建所有图表的Object。
  145. /// </summary>
  146. public void RebuildChartObject()
  147. {
  148. ChartHelper.DestroyAllChildren(transform);
  149. SetAllComponentDirty();
  150. }
  151. public bool ScreenPointToChartPoint(Vector2 screenPoint, out Vector2 chartPoint)
  152. {
  153. #if UNITY_STANDALONE_WIN || UNITY_STANDALONE_OSX
  154. var relative = Display.RelativeMouseAt(screenPoint);
  155. if (relative != Vector3.zero)
  156. screenPoint = relative;
  157. #endif
  158. var cam = canvas.renderMode == RenderMode.ScreenSpaceOverlay ? null : canvas.worldCamera;
  159. if (!RectTransformUtility.ScreenPointToLocalPointInRectangle(rectTransform,
  160. screenPoint, cam, out chartPoint))
  161. {
  162. return false;
  163. }
  164. return true;
  165. }
  166. /// <summary>
  167. /// 保存图表为图片。
  168. /// </summary>
  169. /// <param name="imageType">type of image: png, jpg, exr</param>
  170. /// <param name="savePath">save path</param>
  171. public void SaveAsImage(string imageType = "png", string savePath = "")
  172. {
  173. StartCoroutine(SaveAsImageSync(imageType, savePath));
  174. }
  175. private IEnumerator SaveAsImageSync(string imageType, string path)
  176. {
  177. yield return new WaitForEndOfFrame();
  178. ChartHelper.SaveAsImage(rectTransform, canvas, imageType, path);
  179. }
  180. }
  181. }