BoundingBoxFollower.cs 9.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253
  1. /******************************************************************************
  2. * Spine Runtimes License Agreement
  3. * Last updated January 1, 2020. Replaces all prior versions.
  4. *
  5. * Copyright (c) 2013-2020, Esoteric Software LLC
  6. *
  7. * Integration of the Spine Runtimes into software or otherwise creating
  8. * derivative works of the Spine Runtimes is permitted under the terms and
  9. * conditions of Section 2 of the Spine Editor License Agreement:
  10. * http://esotericsoftware.com/spine-editor-license
  11. *
  12. * Otherwise, it is permitted to integrate the Spine Runtimes into software
  13. * or otherwise create derivative works of the Spine Runtimes (collectively,
  14. * "Products"), provided that each user of the Products must obtain their own
  15. * Spine Editor license and redistribution of the Products in any form must
  16. * include this license and copyright notice.
  17. *
  18. * THE SPINE RUNTIMES ARE PROVIDED BY ESOTERIC SOFTWARE LLC "AS IS" AND ANY
  19. * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  20. * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  21. * DISCLAIMED. IN NO EVENT SHALL ESOTERIC SOFTWARE LLC BE LIABLE FOR ANY
  22. * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  23. * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
  24. * BUSINESS INTERRUPTION, OR LOSS OF USE, DATA, OR PROFITS) HOWEVER CAUSED AND
  25. * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  27. * THE SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28. *****************************************************************************/
  29. #if UNITY_2018_3 || UNITY_2019 || UNITY_2018_3_OR_NEWER
  30. #define NEW_PREFAB_SYSTEM
  31. #endif
  32. using UnityEngine;
  33. using System.Collections.Generic;
  34. namespace Spine.Unity {
  35. #if NEW_PREFAB_SYSTEM
  36. [ExecuteAlways]
  37. #else
  38. [ExecuteInEditMode]
  39. #endif
  40. [HelpURL("http://esotericsoftware.com/spine-unity#BoundingBoxFollower")]
  41. public class BoundingBoxFollower : MonoBehaviour {
  42. internal static bool DebugMessages = true;
  43. #region Inspector
  44. public SkeletonRenderer skeletonRenderer;
  45. [SpineSlot(dataField: "skeletonRenderer", containsBoundingBoxes: true)]
  46. public string slotName;
  47. public bool isTrigger;
  48. public bool clearStateOnDisable = true;
  49. #endregion
  50. Slot slot;
  51. BoundingBoxAttachment currentAttachment;
  52. string currentAttachmentName;
  53. PolygonCollider2D currentCollider;
  54. public readonly Dictionary<BoundingBoxAttachment, PolygonCollider2D> colliderTable = new Dictionary<BoundingBoxAttachment, PolygonCollider2D>();
  55. public readonly Dictionary<BoundingBoxAttachment, string> nameTable = new Dictionary<BoundingBoxAttachment, string>();
  56. public Slot Slot { get { return slot; } }
  57. public BoundingBoxAttachment CurrentAttachment { get { return currentAttachment; } }
  58. public string CurrentAttachmentName { get { return currentAttachmentName; } }
  59. public PolygonCollider2D CurrentCollider { get { return currentCollider; } }
  60. public bool IsTrigger { get { return isTrigger; } }
  61. void Start () {
  62. Initialize();
  63. }
  64. void OnEnable () {
  65. if (skeletonRenderer != null) {
  66. skeletonRenderer.OnRebuild -= HandleRebuild;
  67. skeletonRenderer.OnRebuild += HandleRebuild;
  68. }
  69. Initialize();
  70. }
  71. void HandleRebuild (SkeletonRenderer sr) {
  72. //if (BoundingBoxFollower.DebugMessages) Debug.Log("Skeleton was rebuilt. Repopulating BoundingBoxFollower.");
  73. Initialize();
  74. }
  75. /// <summary>
  76. /// Initialize and instantiate the BoundingBoxFollower colliders. This is method checks if the BoundingBoxFollower has already been initialized for the skeleton instance and slotName and prevents overwriting unless it detects a new setup.</summary>
  77. public void Initialize (bool overwrite = false) {
  78. if (skeletonRenderer == null)
  79. return;
  80. skeletonRenderer.Initialize(false);
  81. if (string.IsNullOrEmpty(slotName))
  82. return;
  83. // Don't reinitialize if the setup did not change.
  84. if (!overwrite
  85. &&
  86. colliderTable.Count > 0 && slot != null // Slot is set and colliders already populated.
  87. &&
  88. skeletonRenderer.skeleton == slot.Skeleton // Skeleton object did not change.
  89. &&
  90. slotName == slot.data.name // Slot object did not change.
  91. )
  92. return;
  93. slot = null;
  94. currentAttachment = null;
  95. currentAttachmentName = null;
  96. currentCollider = null;
  97. colliderTable.Clear();
  98. nameTable.Clear();
  99. var skeleton = skeletonRenderer.skeleton;
  100. if (skeleton == null)
  101. return;
  102. slot = skeleton.FindSlot(slotName);
  103. int slotIndex = skeleton.FindSlotIndex(slotName);
  104. if (slot == null) {
  105. if (BoundingBoxFollower.DebugMessages)
  106. Debug.LogWarning(string.Format("Slot '{0}' not found for BoundingBoxFollower on '{1}'. (Previous colliders were disposed.)", slotName, this.gameObject.name));
  107. return;
  108. }
  109. int requiredCollidersCount = 0;
  110. var colliders = GetComponents<PolygonCollider2D>();
  111. if (this.gameObject.activeInHierarchy) {
  112. foreach (var skin in skeleton.Data.Skins)
  113. AddCollidersForSkin(skin, slotIndex, colliders, ref requiredCollidersCount);
  114. if (skeleton.skin != null)
  115. AddCollidersForSkin(skeleton.skin, slotIndex, colliders, ref requiredCollidersCount);
  116. }
  117. DisposeExcessCollidersAfter(requiredCollidersCount);
  118. if (BoundingBoxFollower.DebugMessages) {
  119. bool valid = colliderTable.Count != 0;
  120. if (!valid) {
  121. if (this.gameObject.activeInHierarchy)
  122. Debug.LogWarning("Bounding Box Follower not valid! Slot [" + slotName + "] does not contain any Bounding Box Attachments!");
  123. else
  124. Debug.LogWarning("Bounding Box Follower tried to rebuild as a prefab.");
  125. }
  126. }
  127. }
  128. void AddCollidersForSkin (Skin skin, int slotIndex, PolygonCollider2D[] previousColliders, ref int collidersCount) {
  129. if (skin == null) return;
  130. var skinEntries = new List<Skin.SkinEntry>();
  131. skin.GetAttachments(slotIndex, skinEntries);
  132. foreach (var entry in skinEntries) {
  133. var attachment = skin.GetAttachment(slotIndex, entry.Name);
  134. var boundingBoxAttachment = attachment as BoundingBoxAttachment;
  135. if (BoundingBoxFollower.DebugMessages && attachment != null && boundingBoxAttachment == null)
  136. Debug.Log("BoundingBoxFollower tried to follow a slot that contains non-boundingbox attachments: " + slotName);
  137. if (boundingBoxAttachment != null) {
  138. if (!colliderTable.ContainsKey(boundingBoxAttachment)) {
  139. var bbCollider = collidersCount < previousColliders.Length ?
  140. previousColliders[collidersCount] : gameObject.AddComponent<PolygonCollider2D>();
  141. ++collidersCount;
  142. SkeletonUtility.SetColliderPointsLocal(bbCollider, slot, boundingBoxAttachment);
  143. bbCollider.isTrigger = isTrigger;
  144. bbCollider.enabled = false;
  145. bbCollider.hideFlags = HideFlags.NotEditable;
  146. bbCollider.isTrigger = IsTrigger;
  147. colliderTable.Add(boundingBoxAttachment, bbCollider);
  148. nameTable.Add(boundingBoxAttachment, entry.Name);
  149. }
  150. }
  151. }
  152. }
  153. void OnDisable () {
  154. if (clearStateOnDisable)
  155. ClearState();
  156. if (skeletonRenderer != null)
  157. skeletonRenderer.OnRebuild -= HandleRebuild;
  158. }
  159. public void ClearState () {
  160. if (colliderTable != null)
  161. foreach (var col in colliderTable.Values)
  162. col.enabled = false;
  163. currentAttachment = null;
  164. currentAttachmentName = null;
  165. currentCollider = null;
  166. }
  167. void DisposeExcessCollidersAfter (int requiredCount) {
  168. var colliders = GetComponents<PolygonCollider2D>();
  169. if (colliders.Length == 0) return;
  170. for (int i = requiredCount; i < colliders.Length; ++i) {
  171. var collider = colliders[i];
  172. if (collider != null) {
  173. #if UNITY_EDITOR
  174. if (Application.isEditor && !Application.isPlaying)
  175. DestroyImmediate(collider);
  176. else
  177. #endif
  178. Destroy(collider);
  179. }
  180. }
  181. }
  182. void LateUpdate () {
  183. if (slot != null && slot.Attachment != currentAttachment)
  184. MatchAttachment(slot.Attachment);
  185. }
  186. /// <summary>Sets the current collider to match attachment.</summary>
  187. /// <param name="attachment">If the attachment is not a bounding box, it will be treated as null.</param>
  188. void MatchAttachment (Attachment attachment) {
  189. var bbAttachment = attachment as BoundingBoxAttachment;
  190. if (BoundingBoxFollower.DebugMessages && attachment != null && bbAttachment == null)
  191. Debug.LogWarning("BoundingBoxFollower tried to match a non-boundingbox attachment. It will treat it as null.");
  192. if (currentCollider != null)
  193. currentCollider.enabled = false;
  194. if (bbAttachment == null) {
  195. currentCollider = null;
  196. currentAttachment = null;
  197. currentAttachmentName = null;
  198. } else {
  199. PolygonCollider2D foundCollider;
  200. colliderTable.TryGetValue(bbAttachment, out foundCollider);
  201. if (foundCollider != null) {
  202. currentCollider = foundCollider;
  203. currentCollider.enabled = true;
  204. currentAttachment = bbAttachment;
  205. currentAttachmentName = nameTable[bbAttachment];
  206. } else {
  207. currentCollider = null;
  208. currentAttachment = bbAttachment;
  209. currentAttachmentName = null;
  210. if (BoundingBoxFollower.DebugMessages) Debug.LogFormat("Collider for BoundingBoxAttachment named '{0}' was not initialized. It is possibly from a new skin. currentAttachmentName will be null. You may need to call BoundingBoxFollower.Initialize(overwrite: true);", bbAttachment.Name);
  211. }
  212. }
  213. }
  214. }
  215. }