BoundingBoxFollower.cs 9.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250
  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 System.Collections.Generic;
  33. using UnityEngine;
  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, usedByEffector, usedByComposite;
  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. colliderTable.Count > 0 && slot != null && // Slot is set and colliders already populated.
  86. skeletonRenderer.skeleton == slot.Skeleton && // Skeleton object did not change.
  87. slotName == slot.Data.Name // Slot object did not change.
  88. )
  89. return;
  90. slot = null;
  91. currentAttachment = null;
  92. currentAttachmentName = null;
  93. currentCollider = null;
  94. colliderTable.Clear();
  95. nameTable.Clear();
  96. var skeleton = skeletonRenderer.skeleton;
  97. if (skeleton == null)
  98. return;
  99. slot = skeleton.FindSlot(slotName);
  100. if (slot == null) {
  101. if (BoundingBoxFollower.DebugMessages)
  102. Debug.LogWarning(string.Format("Slot '{0}' not found for BoundingBoxFollower on '{1}'. (Previous colliders were disposed.)", slotName, this.gameObject.name));
  103. return;
  104. }
  105. int slotIndex = slot.Data.Index;
  106. int requiredCollidersCount = 0;
  107. var colliders = GetComponents<PolygonCollider2D>();
  108. if (this.gameObject.activeInHierarchy) {
  109. foreach (var skin in skeleton.Data.Skins)
  110. AddCollidersForSkin(skin, slotIndex, colliders, ref requiredCollidersCount);
  111. if (skeleton.Skin != null)
  112. AddCollidersForSkin(skeleton.Skin, slotIndex, colliders, ref requiredCollidersCount);
  113. }
  114. DisposeExcessCollidersAfter(requiredCollidersCount);
  115. if (BoundingBoxFollower.DebugMessages) {
  116. bool valid = colliderTable.Count != 0;
  117. if (!valid) {
  118. if (this.gameObject.activeInHierarchy)
  119. Debug.LogWarning("Bounding Box Follower not valid! Slot [" + slotName + "] does not contain any Bounding Box Attachments!");
  120. else
  121. Debug.LogWarning("Bounding Box Follower tried to rebuild as a prefab.");
  122. }
  123. }
  124. }
  125. void AddCollidersForSkin (Skin skin, int slotIndex, PolygonCollider2D[] previousColliders, ref int collidersCount) {
  126. if (skin == null) return;
  127. var skinEntries = new List<Skin.SkinEntry>();
  128. skin.GetAttachments(slotIndex, skinEntries);
  129. foreach (var entry in skinEntries) {
  130. var attachment = skin.GetAttachment(slotIndex, entry.Name);
  131. var boundingBoxAttachment = attachment as BoundingBoxAttachment;
  132. if (BoundingBoxFollower.DebugMessages && attachment != null && boundingBoxAttachment == null)
  133. Debug.Log("BoundingBoxFollower tried to follow a slot that contains non-boundingbox attachments: " + slotName);
  134. if (boundingBoxAttachment != null) {
  135. if (!colliderTable.ContainsKey(boundingBoxAttachment)) {
  136. var bbCollider = collidersCount < previousColliders.Length ?
  137. previousColliders[collidersCount] : gameObject.AddComponent<PolygonCollider2D>();
  138. ++collidersCount;
  139. SkeletonUtility.SetColliderPointsLocal(bbCollider, slot, boundingBoxAttachment);
  140. bbCollider.isTrigger = isTrigger;
  141. bbCollider.usedByEffector = usedByEffector;
  142. bbCollider.usedByComposite = usedByComposite;
  143. bbCollider.enabled = false;
  144. bbCollider.hideFlags = HideFlags.NotEditable;
  145. colliderTable.Add(boundingBoxAttachment, bbCollider);
  146. nameTable.Add(boundingBoxAttachment, entry.Name);
  147. }
  148. }
  149. }
  150. }
  151. void OnDisable () {
  152. if (clearStateOnDisable)
  153. ClearState();
  154. if (skeletonRenderer != null)
  155. skeletonRenderer.OnRebuild -= HandleRebuild;
  156. }
  157. public void ClearState () {
  158. if (colliderTable != null)
  159. foreach (var col in colliderTable.Values)
  160. col.enabled = false;
  161. currentAttachment = null;
  162. currentAttachmentName = null;
  163. currentCollider = null;
  164. }
  165. void DisposeExcessCollidersAfter (int requiredCount) {
  166. var colliders = GetComponents<PolygonCollider2D>();
  167. if (colliders.Length == 0) return;
  168. for (int i = requiredCount; i < colliders.Length; ++i) {
  169. var collider = colliders[i];
  170. if (collider != null) {
  171. #if UNITY_EDITOR
  172. if (Application.isEditor && !Application.isPlaying)
  173. DestroyImmediate(collider);
  174. else
  175. #endif
  176. Destroy(collider);
  177. }
  178. }
  179. }
  180. void LateUpdate () {
  181. if (slot != null && slot.Attachment != currentAttachment)
  182. MatchAttachment(slot.Attachment);
  183. }
  184. /// <summary>Sets the current collider to match attachment.</summary>
  185. /// <param name="attachment">If the attachment is not a bounding box, it will be treated as null.</param>
  186. void MatchAttachment (Attachment attachment) {
  187. var bbAttachment = attachment as BoundingBoxAttachment;
  188. if (BoundingBoxFollower.DebugMessages && attachment != null && bbAttachment == null)
  189. Debug.LogWarning("BoundingBoxFollower tried to match a non-boundingbox attachment. It will treat it as null.");
  190. if (currentCollider != null)
  191. currentCollider.enabled = false;
  192. if (bbAttachment == null) {
  193. currentCollider = null;
  194. currentAttachment = null;
  195. currentAttachmentName = null;
  196. } else {
  197. PolygonCollider2D foundCollider;
  198. colliderTable.TryGetValue(bbAttachment, out foundCollider);
  199. if (foundCollider != null) {
  200. currentCollider = foundCollider;
  201. currentCollider.enabled = true;
  202. currentAttachment = bbAttachment;
  203. currentAttachmentName = nameTable[bbAttachment];
  204. } else {
  205. currentCollider = null;
  206. currentAttachment = bbAttachment;
  207. currentAttachmentName = null;
  208. 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);
  209. }
  210. }
  211. }
  212. }
  213. }