From b4339fcd95f87870d6dd52e5fb9d8aabb12b7758 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=BCleyman=20Yasir=20KULA?= Date: Thu, 17 Aug 2017 20:18:24 +0300 Subject: [PATCH] Major update to v2.0! - Now a better tool in almost any way: usability, accuracy and speed (most of the time) - Can now search custom classes and structs (non UnityEngine.Object deriven) - Ability to see the complete paths to the references in the fresh new node-based results page - Added option to search private properties - Added option to include sub-assets in search as well (if any), like animation clips or the mesh data of an imported model - Search ScriptableObject's in the project --- Editor/AssetUsageDetector.cs | 2831 ++++++++++++++++++++-------------- img1.png | Bin 0 -> 18901 bytes img2.gif | Bin 0 -> 73913 bytes 3 files changed, 1696 insertions(+), 1135 deletions(-) create mode 100644 img1.png create mode 100644 img2.gif diff --git a/Editor/AssetUsageDetector.cs b/Editor/AssetUsageDetector.cs index 54cd836..16a3eec 100644 --- a/Editor/AssetUsageDetector.cs +++ b/Editor/AssetUsageDetector.cs @@ -1,13 +1,8 @@ // Asset Usage Detector - by Suleyman Yasir KULA (yasirkula@yahoo.com) -// Finds references to an asset or GameObject +// Finds references to an asset or Object // -// Limitations: -// - GUIText materials can not be searched (could not find a property that does not leak material) -// - Textures in Flare's can not be searched (no property to access the texture?) -// - "static" variables are not searched -// - also "transform", "rectTransform", "gameObject" and "attachedRigidbody" properties in components -// are not searched (to yield more relevant results) -// - found a bug? Let me know on Unity forums! +// Note that static variables are not searched +// Found a bug? Let me know on Unity forums! using UnityEngine; using UnityEditor; @@ -16,1146 +11,1506 @@ using UnityEditor.SceneManagement; using System.Collections; using System.Collections.Generic; using System.Reflection; -using AssetUsageDetectorExtras; +using System; +using Object = UnityEngine.Object; -// Package for helper classes to avoid possible name collisions -namespace AssetUsageDetectorExtras +namespace AssetUsageDetectorNamespace { - public enum AssetType { Texture, MultipleSprite, Material, Script, Shader, Animation, GameObject, Other }; public enum Phase { Setup, Processing, Complete }; - // Custom class to hold the results for a single scene (or Assets folder) - public class SceneObjectReferences + // Delegate to get the value of a variable (either field or property) + public delegate object VariableGetVal( object obj ); + + #region Helper Classes + // Custom class to hold the results for a single scene or Assets folder + public class ReferenceHolder { - // Custom class to hold a single result (reference) and its ToString representation - private class SceneObjectReference + // Custom struct to hold a single path to a reference + public struct ReferencePath { - public Object reference; - public string description; + public readonly ReferenceNode startNode; + public readonly int[] pathLinksToFollow; - public SceneObjectReference( Object reference, string additionalInfo = null ) + public ReferencePath( ReferenceNode startNode, int[] pathIndices ) { - this.reference = reference; - description = reference.name + " (" + reference.GetType() + ")"; - - if( additionalInfo != null ) - description += "\n" + additionalInfo; + this.startNode = startNode; + pathLinksToFollow = pathIndices; } } - private string scenePath; + private string title; private bool clickable; - private List references; + private List references; + private List shortestPathsToReferences; - public int Count { get { return references.Count; } } - public Object this[int index] { get { return references[index].reference; } } + public int NumberOfReferences { get { return references.Count; } } - public SceneObjectReferences( string scenePath, bool clickable ) + public ReferenceHolder( string title, bool clickable ) { - this.scenePath = scenePath; + this.title = title; this.clickable = clickable; - references = new List(); + references = new List(); + shortestPathsToReferences = null; } // Add a reference to the list - public void AddReference( Object reference, string additionalInfo = null ) + public void AddReference( ReferenceNode node ) { - references.Add( new SceneObjectReference( reference, additionalInfo ) ); + references.Add( node ); } - // Ping the first element of the references (either in Project view - // or Hierarchy view) to force both views to scroll to a proper position - public void PingFirstReference() + // Add all the Object's in this container to the set + public void AddObjectsTo( HashSet objectsSet ) { - if( references.Count > 0 && references[0].reference != null ) - EditorGUIUtility.PingObject( references[0].reference ); + CalculateShortestPathsToReferences(); + + for( int i = 0; i < shortestPathsToReferences.Count; i++ ) + { + Object obj = shortestPathsToReferences[i].startNode.nodeObject as Object; + if( obj != null ) + objectsSet.Add( obj ); + } } - // Draw the results found for this scene - public void DrawOnGUI() + // Add all the GameObject's in this container to the set + public void AddGameObjectsTo( HashSet gameObjectsSet ) + { + CalculateShortestPathsToReferences(); + + for( int i = 0; i < shortestPathsToReferences.Count; i++ ) + { + Object obj = shortestPathsToReferences[i].startNode.nodeObject as Object; + if( obj != null ) + { + if( obj is GameObject ) + gameObjectsSet.Add( (GameObject) obj ); + else if( obj is Component ) + gameObjectsSet.Add( ( (Component) obj ).gameObject ); + } + } + } + + // Calculate shortest unique paths to the references + public void CalculateShortestPathsToReferences() + { + if( shortestPathsToReferences != null ) + return; + + shortestPathsToReferences = new List( 32 ); + for( int i = 0; i < references.Count; i++ ) + references[i].CalculateShortestPaths( shortestPathsToReferences ); + } + + // Draw the results found for this container + public void DrawOnGUI( bool drawFullPaths ) { Color c = GUI.color; GUI.color = Color.cyan; - if( !clickable ) - GUILayout.Box( scenePath, AssetUsageDetector.boxGUIStyle, GUILayout.ExpandWidth( true ), GUILayout.Height( 40 ) ); - else if( GUILayout.Button( scenePath, AssetUsageDetector.boxGUIStyle, GUILayout.ExpandWidth( true ), GUILayout.Height( 40 ) ) ) + if( GUILayout.Button( title, AssetUsageDetector.BoxGUIStyle, AssetUsageDetector.GL_EXPAND_WIDTH, AssetUsageDetector.GL_HEIGHT_40 ) && clickable ) { - // If scene name is clicked, highlight it on Project view - EditorGUIUtility.PingObject( AssetDatabase.LoadAssetAtPath( scenePath ) ); - Selection.activeObject = AssetDatabase.LoadAssetAtPath( scenePath ); + // If the container (scene, usually) is clicked, highlight it on Project view + EditorGUIUtility.PingObject( AssetDatabase.LoadAssetAtPath( title ) ); + Selection.activeObject = AssetDatabase.LoadAssetAtPath( title ); } GUI.color = Color.yellow; - for( int i = 0; i < references.Count; i++ ) + if( drawFullPaths ) { - if( references[i].reference == null ) - continue; - - GUILayout.Space( 5 ); - - if( GUILayout.Button( references[i].description, AssetUsageDetector.boxGUIStyle, GUILayout.ExpandWidth( true ) ) ) + for( int i = 0; i < references.Count; i++ ) { - // If a reference is clicked, highlight it (either on Hierarchy view or Project view) - EditorGUIUtility.PingObject( references[i].reference ); - Selection.activeObject = references[i].reference; + if( references[i].nodeObject == null ) + continue; + + GUILayout.Space( 5 ); + + references[i].DrawOnGUIRecursively(); } } - - GUI.color = c; - - GUILayout.Space( 10 ); - } - } - - public class AnimationClipSearchResult - { - public bool isFound; - public string additionalInfo; - - public AnimationClipSearchResult( bool isFound, string additionalInfo = null ) - { - this.isFound = isFound; - this.additionalInfo = additionalInfo; - } - } -} - -public class AssetUsageDetector : EditorWindow -{ - private Object assetToSearch; - private List assetToSearchMultipleSprite; // Stores each sprite of the asset if it is a multiple sprite - private AssetType assetType; - private System.Type assetClass; // Class of the object (like GameObject, Material, custom MonoBehaviour etc.) - - private Phase currentPhase = Phase.Setup; - - private List searchResult = new List(); // Overall search results - private SceneObjectReferences currentSceneReferences; // Results for the scene currently being searched - - private bool ShouldContinueSearching { get { return !stopAtFirstOccurrence || currentSceneReferences.Count == 0; } } - - private Dictionary typeToVariables; // An optimization to fetch & filter fields of a class only once - private Dictionary typeToProperties; // An optimization to fetch & filter properties of a class only once - private Dictionary searchedAnimationClips; // An optimization to search keyframes of animation clips only once - - private bool searchInOpenScenes = true; // Scenes currently open in Hierarchy view - private bool searchInScenesInBuild = false; // Scenes in build (ticked in Build Settings) - private bool searchInAllScenes = false; // All scenes (including scenes that are not in build) - private bool searchInAssetsFolder = false; // Assets in Project view - - private bool stopAtFirstOccurrence = false; // Stop as soon as a reference is found - private bool restoreInitialSceneSetup = true; // Close the additively loaded scenes that were not part of the initial scene setup - - private string errorMessage = ""; - - private Color32 ORANGE_COLOR = new Color32( 235, 185, 140, 255 ); - private static GUIStyle m_boxGUIStyle; // GUIStyle used to draw the results of the search - public static GUIStyle boxGUIStyle - { - get - { - if( m_boxGUIStyle == null ) - { - m_boxGUIStyle = new GUIStyle( EditorStyles.helpBox ); - m_boxGUIStyle.alignment = TextAnchor.MiddleCenter; - m_boxGUIStyle.font = EditorStyles.label.font; - } - - return m_boxGUIStyle; - } - } - private Vector2 scrollPosition = Vector2.zero; - - // Initial scene setup (which scenes were open and/or loaded) - private SceneSetup[] sceneInitialSetup; - - // Fetch public, protected and private non-static variables (fields) from objects - // Fetch only public non-static properties from objects - private const BindingFlags FIELD_MODIFIERS = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic; - private const BindingFlags PROPERTY_MODIFIERS = BindingFlags.Instance | BindingFlags.Public; - - // Add menu named "Asset Usage Detector" to the Util menu - [MenuItem( "Util/Asset Usage Detector" )] - static void Init() - { - // Get existing open window or if none, make a new one - AssetUsageDetector window = (AssetUsageDetector) EditorWindow.GetWindow( typeof( AssetUsageDetector ) ); - window.titleContent = new GUIContent( "Asset Usage" ); - - window.Show(); - } - - void OnGUI() - { - // Make the window scrollable - scrollPosition = EditorGUILayout.BeginScrollView( scrollPosition, GUILayout.ExpandWidth( true ), GUILayout.ExpandHeight( true ) ); - - GUILayout.BeginVertical(); - - GUILayout.Space( 10 ); - - // Show the error message, if it is not empty - if( errorMessage.Length > 0 ) - { - Color c = GUI.color; - GUI.color = ORANGE_COLOR; - GUILayout.Box( errorMessage, GUILayout.ExpandWidth( true ) ); - GUI.color = c; - } - - GUILayout.Space( 10 ); - - if( currentPhase == Phase.Processing ) - { - // Search is in progress - GUILayout.Label( ". . . . . . ." ); - } - else if( currentPhase == Phase.Setup ) - { - assetToSearch = EditorGUILayout.ObjectField( "Asset: ", assetToSearch, typeof( Object ), true ); - - GUILayout.Space( 10 ); - - GUILayout.Box( "SCENES TO SEARCH", GUILayout.ExpandWidth( true ) ); - - if( EditorApplication.isPlaying ) - { - searchInAllScenes = false; - searchInScenesInBuild = false; - } - else if( searchInAllScenes ) - GUI.enabled = false; - - searchInOpenScenes = EditorGUILayout.ToggleLeft( "Currently open (loaded) scene(s)", searchInOpenScenes ); - - if( EditorApplication.isPlaying ) - GUI.enabled = false; - - searchInScenesInBuild = EditorGUILayout.ToggleLeft( "Scenes in Build Settings (ticked)", searchInScenesInBuild ); - - if( !EditorApplication.isPlaying ) - GUI.enabled = true; - - searchInAllScenes = EditorGUILayout.ToggleLeft( "All scenes in project (including scenes not in build)", searchInAllScenes ); - - GUI.enabled = true; - - GUILayout.Space( 10 ); - - GUILayout.Box( "OTHER FILTER(S)", GUILayout.ExpandWidth( true ) ); - - searchInAssetsFolder = EditorGUILayout.ToggleLeft( "Also search in Project view (Assets folder)", searchInAssetsFolder ); - - GUILayout.Space( 10 ); - - GUILayout.Box( "SETTINGS", GUILayout.ExpandWidth( true ) ); - - stopAtFirstOccurrence = EditorGUILayout.ToggleLeft( "Stop searching at first occurrence", stopAtFirstOccurrence ); - restoreInitialSceneSetup = EditorGUILayout.ToggleLeft( "Restore initial scene setup after search is reset (Recommended)", restoreInitialSceneSetup ); - - GUILayout.Space( 10 ); - - // Don't let the user press the GO button without any search filters - if( !searchInAllScenes && !searchInOpenScenes && !searchInScenesInBuild && !searchInAssetsFolder ) - GUI.enabled = false; - - if( GUILayout.Button( "GO!", GUILayout.Height( 30 ) ) ) - { - if( assetToSearch == null ) - { - errorMessage = "SELECT AN ASSET FIRST!"; - } - else if( !EditorApplication.isPlaying && !AreScenesSaved() ) - { - // Don't start the search if at least one scene is currently dirty (not saved) - errorMessage = "SAVE OPEN SCENES FIRST!"; - } - else - { - Debug.Log( "Searching..." ); - - errorMessage = ""; - currentPhase = Phase.Processing; - - if( !EditorApplication.isPlaying ) - { - // Get the scenes that are open right now - sceneInitialSetup = EditorSceneManager.GetSceneManagerSetup(); - } - else - { - sceneInitialSetup = null; - } - - // Start searching - ExecuteQuery(); - - return; - } - } - } - else if( currentPhase == Phase.Complete ) - { - // Draw the results of the search - GUI.enabled = false; - - assetToSearch = EditorGUILayout.ObjectField( "Asset: ", assetToSearch, typeof( Object ), true ); - - GUILayout.Space( 10 ); - GUI.enabled = true; - - if( GUILayout.Button( "Reset Search", GUILayout.Height( 30 ) ) ) - { - if( EditorApplication.isPlaying || !restoreInitialSceneSetup || sceneInitialSetup == null || EditorSceneManager.SaveCurrentModifiedScenesIfUserWantsTo() ) - { - errorMessage = ""; - currentPhase = Phase.Setup; - - if( restoreInitialSceneSetup ) - RestoreInitialSceneSetup(); - } - } - - Color c = GUI.color; - GUI.color = Color.green; - GUILayout.Box( "Don't forget to save scene(s) if you made any changes!", GUILayout.ExpandWidth( true ) ); - GUI.color = c; - - GUILayout.Space( 10 ); - - if( searchResult.Count == 0 ) - { - GUILayout.Box( "No results found...", GUILayout.ExpandWidth( true ) ); - } else { + if( shortestPathsToReferences == null ) + CalculateShortestPathsToReferences(); + + for( int i = 0; i < shortestPathsToReferences.Count; i++ ) + { + ReferencePath path = shortestPathsToReferences[i]; + if( path.startNode.nodeObject == null ) + continue; + + GUILayout.Space( 5 ); + + GUILayout.BeginHorizontal(); + + path.startNode.DrawOnGUI( null ); + + ReferenceNode currentNode = path.startNode; + for( int j = 0; j < path.pathLinksToFollow.Length; j++ ) + { + ReferenceNode.Link link = currentNode[path.pathLinksToFollow[j]]; + link.targetNode.DrawOnGUI( link.description ); + currentNode = link.targetNode; + } + + GUILayout.EndHorizontal(); + } + } + + GUI.color = c; + + GUILayout.Space( 10 ); + } + } + + // Custom class to hold an object in the path to a reference as a node + public class ReferenceNode + { + public struct Link + { + public readonly ReferenceNode targetNode; + public readonly string description; + + public Link( ReferenceNode targetNode, string description ) + { + this.targetNode = targetNode; + this.description = description; + } + } + + public object nodeObject; + private readonly List links; + + public int NumberOfOutgoingLinks { get { return links.Count; } } + public Link this[int index] { get { return links[index]; } } + + public ReferenceNode() + { + links = new List( 2 ); + } + + public ReferenceNode( object obj ) : this() + { + nodeObject = obj; + } + + // Add a one-way connection to another node + public void AddLinkTo( ReferenceNode nextNode, string description = null ) + { + if( nextNode != null ) + { + if( !string.IsNullOrEmpty( description ) ) + description = "[" + description + "]"; + + links.Add( new Link( nextNode, description ) ); + } + } + + // Clear this node so that it can be reused later + public void Clear() + { + nodeObject = null; + links.Clear(); + } + + // Calculate shortest unique paths that start with this node + public void CalculateShortestPaths( List currentPaths ) + { + CalculateShortestPaths( currentPaths, new List( 8 ), new List( 8 ) { -1 }, 0 ); + } + + // Just some boring calculations to find the shortest unique paths recursively + private void CalculateShortestPaths( List shortestPaths, List currentPath, List currentPathIndices, int latestObjectIndexInPath ) + { + if( nodeObject == null ) + return; + + int currentIndex = currentPath.Count; + currentPath.Add( this ); + + if( links.Count == 0 ) + { + // Check if the path to the reference is unique (not discovered so far) + bool isUnique = true; + for( int i = 0; i < shortestPaths.Count; i++ ) + { + if( shortestPaths[i].startNode == currentPath[latestObjectIndexInPath] && shortestPaths[i].pathLinksToFollow.Length == currentPathIndices.Count - latestObjectIndexInPath - 1 ) + { + int j = latestObjectIndexInPath + 1; + for( int k = 0; j < currentPathIndices.Count; j++, k++ ) + { + if( shortestPaths[i].pathLinksToFollow[k] != currentPathIndices[j] ) + break; + } + + if( j == currentPathIndices.Count ) + { + isUnique = false; + break; + } + } + } + + // Don't allow duplicate shortest paths + if( isUnique ) + { + int[] pathIndices = new int[currentPathIndices.Count - latestObjectIndexInPath - 1]; + for( int i = latestObjectIndexInPath + 1, j = 0; i < currentPathIndices.Count; i++, j++ ) + pathIndices[j] = currentPathIndices[i]; + + shortestPaths.Add( new ReferenceHolder.ReferencePath( currentPath[latestObjectIndexInPath], pathIndices ) ); + } + } + else + { + if( nodeObject is Object ) + latestObjectIndexInPath = currentIndex; + + for( int i = 0; i < links.Count; i++ ) + { + currentPathIndices.Add( i ); + links[i].targetNode.CalculateShortestPaths( shortestPaths, currentPath, currentPathIndices, latestObjectIndexInPath ); + currentPathIndices.RemoveAt( currentIndex + 1 ); + } + } + + currentPath.RemoveAt( currentIndex ); + } + + // Draw all the paths that start with this node on GUI recursively + public void DrawOnGUIRecursively( string linkToPrevNodeDescription = null ) + { + GUILayout.BeginHorizontal(); + + DrawOnGUI( linkToPrevNodeDescription ); + + if( links.Count > 0 ) + { + GUILayout.BeginVertical(); + + for( int i = 0; i < links.Count; i++ ) + { + ReferenceNode next = links[i].targetNode; + if( next.nodeObject != null ) + next.DrawOnGUIRecursively( links[i].description ); + } + + GUILayout.EndVertical(); + } + + GUILayout.EndHorizontal(); + } + + // Draw only this node on GUI + public void DrawOnGUI( string linkToPrevNodeDescription ) + { + string label = GetNodeContent( linkToPrevNodeDescription ); + if( GUILayout.Button( label, AssetUsageDetector.BoxGUIStyle, AssetUsageDetector.GL_EXPAND_HEIGHT ) ) + { + // If a reference is clicked, highlight it (either on Hierarchy view or Project view) + Object unityObject = nodeObject as Object; + if( unityObject != null ) + { + EditorGUIUtility.PingObject( unityObject ); + Selection.activeObject = unityObject; + } + } + + if( AssetUsageDetector.showTooltips && Event.current.type == EventType.Repaint && GUILayoutUtility.GetLastRect().Contains( Event.current.mousePosition ) ) + AssetUsageDetector.tooltip = label; + } + + // Get the string representation of this node + private string GetNodeContent( string linkToPrevNodeDescription = null ) + { + string result = string.Empty; + if( !string.IsNullOrEmpty( linkToPrevNodeDescription ) ) + result = linkToPrevNodeDescription + "\n"; + + Object unityObject = nodeObject as Object; + if( unityObject != null ) + result += unityObject.name + " (" + unityObject.GetType() + ")"; + else + result += nodeObject.GetType() + " object"; + + return result; + } + } + + // Custom struct to hold a variable, its important properties and its getter function + public struct VariableGetterHolder + { + public readonly string name; + public readonly bool isProperty; + public readonly bool isSerializable; + private readonly VariableGetVal getter; + + public VariableGetterHolder( FieldInfo fieldInfo, VariableGetVal getter, bool isSerializable ) + { + name = fieldInfo.Name; + isProperty = false; + this.isSerializable = isSerializable; + this.getter = getter; + } + + public VariableGetterHolder( PropertyInfo propertyInfo, VariableGetVal getter, bool isSerializable ) + { + name = propertyInfo.Name; + isProperty = true; + this.isSerializable = isSerializable; + this.getter = getter; + } + + public object Get( object obj ) + { + return getter( obj ); + } + } + + // Credit: http://stackoverflow.com/questions/724143/how-do-i-create-a-delegate-for-a-net-property + public interface IPropertyAccessor + { + object GetValue( object source ); + } + + // A wrapper class for properties to get their values more efficiently + public class PropertyWrapper : IPropertyAccessor where TObject : class + { + private readonly Func getter; + + public PropertyWrapper( MethodInfo getterMethod ) + { + getter = (Func) Delegate.CreateDelegate( typeof( Func ), getterMethod ); + } + + public object GetValue( object obj ) + { + try + { + return getter( (TObject) obj ); + } + catch + { + // Property getters may return various kinds of exceptions + // if their backing fields are not initialized (yet) + return null; + } + } + } + #endregion + + #region Extension Functions + public static class AssetUsageDetectorExtensions + { + // Get a unique-ish string hash code for an object + public static string Hash( this object obj ) + { + if( obj is Object ) + return obj.GetHashCode() + + obj.GetType().Name + + ( (Object) obj ).name; + + return obj.GetHashCode() + obj.GetType().Name; + } + + // Check if object depends on any of the references + public static bool HasAnyReferenceTo( this Object obj, HashSet references ) + { + Object[] dependencies = EditorUtility.CollectDependencies( new Object[] { obj } ); + for( int i = 0; i < dependencies.Length; i++ ) + { + if( references.Contains( dependencies[i] ) ) + return true; + } + + return false; + } + + // Check if the field is serializable + public static bool IsSerializable( this FieldInfo fieldInfo ) + { + // see Serialization Rules: https://docs.unity3d.com/Manual/script-Serialization.html + Type fieldType = fieldInfo.FieldType; + if( fieldType.IsDerivedFrom( typeof( Object ) ) ) + return true; + + if( fieldType.IsArray ) + { + if( fieldType.GetArrayRank() != 1 ) + return false; + + fieldType = fieldType.GetElementType(); + } + else if( fieldType.IsGenericType ) + { + if( fieldType.GetGenericTypeDefinition() != typeof( List<> ) ) + return false; + + fieldType = fieldType.GetGenericArguments()[0]; + } + + if( fieldType.IsGenericType || fieldInfo.IsInitOnly || + ( ( !fieldInfo.IsPublic || fieldInfo.IsNotSerialized ) && !Attribute.IsDefined( fieldInfo, typeof( SerializeField ) ) ) ) + return false; + + if( Attribute.IsDefined( fieldType, typeof( SerializableAttribute ), false ) ) + return true; + + return false; + } + + // Check if the type is a common Unity type (let's call them primitives) + public static bool IsPrimitiveUnityType( this Type type ) + { + return type.IsPrimitive || type == typeof( string ) || type == typeof( Vector3 ) || type == typeof( Vector2 ) || type == typeof( Rect ) || + type == typeof( Quaternion ) || type == typeof( Color ) || type == typeof( Color32 ) || type == typeof( LayerMask ) || type == typeof( GUIStyle ) || + type == typeof( Vector4 ) || type == typeof( Matrix4x4 ) || type == typeof( AnimationCurve ) || type == typeof( Gradient ) || type == typeof( RectOffset ); + } + + // Check if the property is serializable + public static bool IsSerializable( this PropertyInfo propertyInfo ) + { + // see Serialization Rules: https://docs.unity3d.com/Manual/script-Serialization.html + Type propertyType = propertyInfo.PropertyType; + if( propertyType.IsDerivedFrom( typeof( Object ) ) ) + return true; + + if( propertyType.IsArray ) + { + if( propertyType.GetArrayRank() != 1 ) + return false; + + propertyType = propertyType.GetElementType(); + } + else if( propertyType.IsGenericType ) + { + if( propertyType.GetGenericTypeDefinition() != typeof( List<> ) ) + return false; + + propertyType = propertyType.GetGenericArguments()[0]; + } + + if( propertyType.IsGenericType ) + return false; + + return true; + } + + // Credit: https://www.codeproject.com/Articles/14560/Fast-Dynamic-Property-Field-Accessors + // Get function for a field + public static VariableGetVal CreateGetter( this FieldInfo fieldInfo, Type type ) + { + // Commented the IL generator code below because it might actually be slower than simply using reflection + //DynamicMethod dm = new DynamicMethod( "Get" + fieldInfo.Name, fieldInfo.FieldType, new Type[] { typeof( object ) }, type ); + //ILGenerator il = dm.GetILGenerator(); + //// Load the instance of the object (argument 0) onto the stack + //il.Emit( OpCodes.Ldarg_0 ); + //// Load the value of the object's field (fi) onto the stack + //il.Emit( OpCodes.Ldfld, fieldInfo ); + //// return the value on the top of the stack + //il.Emit( OpCodes.Ret ); + + //return (VariableGetVal) dm.CreateDelegate( typeof( VariableGetVal ) ); + + return fieldInfo.GetValue; + } + + // Get function for a property + public static VariableGetVal CreateGetter( this PropertyInfo propertyInfo ) + { + // Ignore indexer properties + if( propertyInfo.GetIndexParameters().Length > 0 ) + return null; + + MethodInfo mi = propertyInfo.GetGetMethod( true ); + if( mi != null ) + { + Type GenType = typeof( PropertyWrapper<,> ).MakeGenericType( propertyInfo.DeclaringType, propertyInfo.PropertyType ); + return ( (IPropertyAccessor) Activator.CreateInstance( GenType, mi ) ).GetValue; + } + + return null; + } + + // Check if "child" is a subclass of "parent" (or if their types match) + public static bool IsDerivedFrom( this Type child, Type parent ) + { + if( child == parent || child.IsSubclassOf( parent ) ) + return true; + + return false; + + } + } + #endregion + + // Here we go..! + public class AssetUsageDetector : EditorWindow + { + private Object assetToSearch; + + private HashSet assetsSet; // A set that contains the searched asset and its sub-assets (if any) + private Type[] assetClasses; // Type's of the searched objects (like GameObject, Material, a custom MonoBehaviour etc.) + + private Phase currentPhase = Phase.Setup; + + private List searchResult = new List(); // Overall search results + private ReferenceHolder currentReferenceHolder; // Results for the currently searched scene + + private Dictionary typeToVariables; // An optimization to fetch & filter fields and properties of a class only once + private Dictionary searchableTypes; // An optimization to search only certain types for references that can store the searched object(s) in their variables + private Dictionary searchedObjects; // An optimization to search an object only once (key is a hash of the searched object) + + private Stack callStack; // Stack of SearchObject function parameters to avoid infinite loops (which happens when same object is passed as parameter to function) + private Stack searchedTypesStack; // Stack of TypeCanContainReferences function parameters to avoid infinite loops + + private bool searchMaterialAssets; + private bool searchGameObjectReferences; + private bool searchMonoBehavioursForScript; + private bool searchRenderers; + private bool searchMaterialsForShader; + private bool searchMaterialsForTexture; + + private bool searchSerializableVariablesOnly; + + private bool searchInOpenScenes = true; // Scenes currently open in Hierarchy view + private bool searchInScenesInBuild = false; // Scenes in build + private bool searchInScenesInBuildTickedOnly = true; // Scenes in build (ticked only or not) + private bool searchInAllScenes = false; // All scenes (including scenes that are not in build) + private bool searchInAssetsFolder = false; // Assets in Project view + + private bool includeSubAssetsInSearch = false; // Search sub-assets of a main asset as well + private bool isSearchingAsset; // Whether we are searching for an asset's references or a scene object's references + + private int searchDepthLimit = 1; // Depth limit for recursively searching variables of objects + private int currentDepth = 0; + + private bool showFullPathsToReferences = false; // Draw either the complete paths to the references or only the most relevant parts of the paths + + private bool restoreInitialSceneSetup = true; // Close the additively loaded scenes that were not part of the initial scene setup + private SceneSetup[] initialSceneSetup; // Initial scene setup (which scenes were open and/or loaded) + + private string errorMessage = string.Empty; + + // Fetch public, protected and private non-static fields from objects by default + // Don't fetch properties from objects by default + private BindingFlags fieldModifiers = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic; + private BindingFlags propertyModifiers = BindingFlags.Instance; + + private int prevSearchDepthLimit; + private BindingFlags prevFieldModifiers; + private BindingFlags prevPropertyModifiers; + + private static bool assembliesReloaded = true; // An optimization to reinitialize some cached variables only if assemblies are reloaded + + public static string tooltip = null; + public static bool showTooltips = true; + + private const float PLAY_MODE_REFRESH_INTERVAL = 1f; // Interval to refresh the editor window in play mode + private double nextPlayModeRefreshTime = 0f; + + public static GUILayoutOption GL_EXPAND_WIDTH = GUILayout.ExpandWidth( true ); + public static GUILayoutOption GL_EXPAND_HEIGHT = GUILayout.ExpandHeight( true ); + public static GUILayoutOption GL_WIDTH_100 = GUILayout.Width( 100 ); + public static GUILayoutOption GL_WIDTH_250 = GUILayout.Width( 250 ); + public static GUILayoutOption GL_HEIGHT_30 = GUILayout.Height( 30 ); + public static GUILayoutOption GL_HEIGHT_35 = GUILayout.Height( 35 ); + public static GUILayoutOption GL_HEIGHT_40 = GUILayout.Height( 40 ); + + private static GUIStyle m_boxGUIStyle; // GUIStyle used to draw the results of the search + public static GUIStyle BoxGUIStyle + { + get + { + if( m_boxGUIStyle == null ) + { + m_boxGUIStyle = new GUIStyle( EditorStyles.helpBox ) + { + alignment = TextAnchor.MiddleCenter, + font = EditorStyles.label.font + }; + } + + return m_boxGUIStyle; + } + } + + private GUIStyle m_tooltipGUIStyle; // GUIStyle used to draw the tooltip + private GUIStyle TooltipGUIStyle + { + get + { + if( m_tooltipGUIStyle == null ) + { + m_tooltipGUIStyle = new GUIStyle( EditorStyles.helpBox ) + { + alignment = TextAnchor.MiddleCenter, + font = EditorStyles.label.font + }; + + Texture2D backgroundTexture = new Texture2D( 1, 1 ); + backgroundTexture.SetPixel( 0, 0, new Color( 0.88f, 0.88f, 0.88f, 0.85f ) ); + backgroundTexture.Apply(); + + backgroundTexture.hideFlags = HideFlags.HideAndDontSave; + + m_tooltipGUIStyle.normal.background = backgroundTexture; + m_tooltipGUIStyle.normal.textColor = Color.black; + } + + return m_tooltipGUIStyle; + } + } + + private Vector2 scrollPosition = Vector2.zero; + + private int searchCount; // Number of searched objects + private double searchStartTime; + + private List nodesPool = new List( 32 ); + private List validVariables = new List( 32 ); + + // This method is now disabled by default + private bool experimentalMethod = false; + + // Add "Asset Usage Detector" menu item to the Window menu + [MenuItem( "Window/Asset Usage Detector" )] + static void Init() + { + // Get existing open window or if none, make a new one + AssetUsageDetector window = GetWindow(); + window.titleContent = new GUIContent( "Asset Usage Detector" ); + + window.Show(); + } + + void Update() + { + // Refresh the window at a regular interval in play mode to update the tooltip + if( EditorApplication.isPlaying && currentPhase == Phase.Complete && showTooltips && EditorApplication.timeSinceStartup >= nextPlayModeRefreshTime ) + { + nextPlayModeRefreshTime = EditorApplication.timeSinceStartup + PLAY_MODE_REFRESH_INTERVAL; ; + Repaint(); + } + } + + void OnGUI() + { + // Make the window scrollable + scrollPosition = EditorGUILayout.BeginScrollView( scrollPosition, GL_EXPAND_WIDTH, GL_EXPAND_HEIGHT ); + + GUILayout.BeginVertical(); + + GUILayout.Space( 10 ); + + // Show the error message, if it is not empty + if( errorMessage.Length > 0 ) + EditorGUILayout.HelpBox( errorMessage, MessageType.Error ); + + GUILayout.Space( 10 ); + + if( currentPhase == Phase.Processing ) + { + // If we are stuck at this phase, then we have encountered an exception + GUILayout.Label( ". . . something went wrong, check console . . ." ); + + restoreInitialSceneSetup = EditorGUILayout.ToggleLeft( "Restore initial scene setup (Recommended)", restoreInitialSceneSetup ); + + if( GUILayout.Button( "RETURN", GL_HEIGHT_30 ) ) + { + if( !restoreInitialSceneSetup || RestoreInitialSceneSetup() ) + { + errorMessage = string.Empty; + currentPhase = Phase.Setup; + } + } + } + else if( currentPhase == Phase.Setup ) + { + assetToSearch = EditorGUILayout.ObjectField( "Asset: ", assetToSearch, typeof( Object ), true ); + + if( assetToSearch != null && AssetDatabase.IsMainAsset( assetToSearch ) ) + { + GUILayout.BeginHorizontal(); + + includeSubAssetsInSearch = EditorGUILayout.ToggleLeft( "Include sub-assets in search (if any)", includeSubAssetsInSearch, GL_WIDTH_250 ); + if( !includeSubAssetsInSearch && assetToSearch is Texture && AssetDatabase.LoadAssetAtPath( AssetDatabase.GetAssetPath( assetToSearch ) ) != null ) + GUILayout.Label( " <-- Recommended for sprites!", EditorStyles.boldLabel ); + + GUILayout.EndHorizontal(); + } + + GUILayout.Space( 10 ); + + GUILayout.Box( "SEARCH IN", GL_EXPAND_WIDTH ); + + searchInAssetsFolder = EditorGUILayout.ToggleLeft( "Project view (Assets folder)", searchInAssetsFolder ); + + GUILayout.Space( 10 ); + + if( EditorApplication.isPlaying ) + { + searchInAllScenes = false; + searchInScenesInBuild = false; + } + else if( searchInAllScenes ) + GUI.enabled = false; + + searchInOpenScenes = EditorGUILayout.ToggleLeft( "Currently open (loaded) scene(s)", searchInOpenScenes ); + + if( EditorApplication.isPlaying ) + GUI.enabled = false; + + searchInScenesInBuild = EditorGUILayout.ToggleLeft( "Scenes in Build Settings", searchInScenesInBuild ); + + if( searchInScenesInBuild ) + { + GUILayout.BeginHorizontal(); + GUILayout.Space( 35 ); + + searchInScenesInBuildTickedOnly = EditorGUILayout.ToggleLeft( "Ticked only", searchInScenesInBuildTickedOnly, GL_WIDTH_100 ); + searchInScenesInBuildTickedOnly = !EditorGUILayout.ToggleLeft( "All", !searchInScenesInBuildTickedOnly, GL_WIDTH_100 ); + + GUILayout.EndHorizontal(); + } + + if( !EditorApplication.isPlaying ) + GUI.enabled = true; + + searchInAllScenes = EditorGUILayout.ToggleLeft( "All scenes in the project", searchInAllScenes ); + + GUI.enabled = true; + + GUILayout.Space( 10 ); + + GUILayout.Box( "SEARCH SETTINGS", GL_EXPAND_WIDTH ); + GUILayout.BeginHorizontal(); - // Select all the references without filtering them (i.e. without - // getting gameObject's of components) - if( GUILayout.Button( "Select All\n(Component-wise)", GUILayout.Height( 35 ) ) ) - { - // Find the number of references first - int referenceCount = 0; - for( int i = 0; i < searchResult.Count; i++ ) - { - // Ping the first element of the references (either in Project view - // or Hierarchy view) to force both views to scroll to a proper position - // (setting Selection.objects does not scroll automatically) - searchResult[i].PingFirstReference(); + GUILayout.Label( new GUIContent( "> Search depth: " + searchDepthLimit, "Depth limit for recursively searching variables of objects" ), GL_WIDTH_250 ); - referenceCount += searchResult[i].Count; - } + searchDepthLimit = (int) GUILayout.HorizontalSlider( searchDepthLimit, 0, 4 ); - Object[] allReferences = new Object[referenceCount]; - int currIndex = 0; - for( int i = 0; i < searchResult.Count; i++ ) - { - for( int j = 0; j < searchResult[i].Count; j++ ) - { - allReferences[currIndex] = searchResult[i][j]; - currIndex++; - } - } + GUILayout.EndHorizontal(); - Selection.objects = allReferences; - } + GUILayout.Label( "> Search variables:" ); - // Select all the references after filtering them (i.e. do not select components - // but their gameObject's) - if( GUILayout.Button( "Select All\n(GameObject-wise)", GUILayout.Height( 35 ) ) ) - { - HashSet uniqueGameObjects = new HashSet(); - List resultList = new List(); - for( int i = 0; i < searchResult.Count; i++ ) - { - // Ping the first element of the references (either in Project view - // or Hierarchy view) to force both views to scroll to a proper position - // (setting Selection.objects does not scroll automatically) - searchResult[i].PingFirstReference(); + GUILayout.BeginHorizontal(); - for( int j = 0; j < searchResult[i].Count; j++ ) - { - Component currReferenceAsComponent = searchResult[i][j] as Component; - if( currReferenceAsComponent != null ) - { - if( !uniqueGameObjects.Contains( currReferenceAsComponent.gameObject ) ) - { - uniqueGameObjects.Add( currReferenceAsComponent.gameObject ); - resultList.Add( currReferenceAsComponent.gameObject ); - } - } - else - { - resultList.Add( searchResult[i][j] ); - } - } - } + GUILayout.Space( 35 ); - Selection.activeObject = resultList[0]; - Selection.objects = resultList.ToArray(); - } + if( EditorGUILayout.ToggleLeft( "Public", ( fieldModifiers & BindingFlags.Public ) == BindingFlags.Public, GL_WIDTH_100 ) ) + fieldModifiers |= BindingFlags.Public; + else + fieldModifiers &= ~BindingFlags.Public; + + if( EditorGUILayout.ToggleLeft( "Non-public", ( fieldModifiers & BindingFlags.NonPublic ) == BindingFlags.NonPublic, GL_WIDTH_100 ) ) + fieldModifiers |= BindingFlags.NonPublic; + else + fieldModifiers &= ~BindingFlags.NonPublic; + + GUILayout.EndHorizontal(); + + GUILayout.Label( "> Search properties (can be slow):" ); + + GUILayout.BeginHorizontal(); + + GUILayout.Space( 35 ); + + if( EditorGUILayout.ToggleLeft( "Public", ( propertyModifiers & BindingFlags.Public ) == BindingFlags.Public, GL_WIDTH_100 ) ) + propertyModifiers |= BindingFlags.Public; + else + propertyModifiers &= ~BindingFlags.Public; + + if( EditorGUILayout.ToggleLeft( "Non-public", ( propertyModifiers & BindingFlags.NonPublic ) == BindingFlags.NonPublic, GL_WIDTH_100 ) ) + propertyModifiers |= BindingFlags.NonPublic; + else + propertyModifiers &= ~BindingFlags.NonPublic; GUILayout.EndHorizontal(); GUILayout.Space( 10 ); - for( int i = 0; i < searchResult.Count; i++ ) + // Disabled by default as it seems slower than the normal method + //experimentalMethod = EditorGUILayout.ToggleLeft( "Experimental method (is it faster?)", experimentalMethod ); + + // Don't let the user press the GO button without any valid search location + if( !searchInAllScenes && !searchInOpenScenes && !searchInScenesInBuild && !searchInAssetsFolder ) + GUI.enabled = false; + + if( GUILayout.Button( "GO!", GL_HEIGHT_30 ) ) { - searchResult[i].DrawOnGUI(); + if( assetToSearch == null ) + { + errorMessage = "SELECT AN ASSET FIRST!"; + } + else if( !EditorApplication.isPlaying && !AreScenesSaved() ) + { + // Don't start the search if at least one scene is currently dirty (not saved) + errorMessage = "SAVE OPEN SCENES FIRST!"; + } + else + { + errorMessage = string.Empty; + currentPhase = Phase.Processing; + + if( !EditorApplication.isPlaying ) + initialSceneSetup = EditorSceneManager.GetSceneManagerSetup(); // Get the scenes that are open right now + else + initialSceneSetup = null; + + // Start searching + ExecuteQuery(); + } } } - } - - GUILayout.Space( 10 ); - - GUILayout.EndVertical(); - - EditorGUILayout.EndScrollView(); - } - - // Search for references! - private void ExecuteQuery() - { - // Additional infoes received from found references (like names of variables storing the searched asset) - string additionalInfo = null; - - searchResult = new List(); - typeToVariables = new Dictionary(); - typeToProperties = new Dictionary(); - searchedAnimationClips = new Dictionary(); - - assetType = AssetType.Other; - - // Special case: if asset is a Sprite, but its Texture2D file is given, grab the correct asset - // (if it is a multiple sprite, store all sprites in a list) - if( assetToSearch is Texture2D ) - { - string assetPath = AssetDatabase.GetAssetPath( assetToSearch ); - TextureImporter importSettings = (TextureImporter) TextureImporter.GetAtPath( assetPath ); - if( importSettings.spriteImportMode == SpriteImportMode.Multiple ) + else if( currentPhase == Phase.Complete ) { - // If it is a multiple sprite asset, store all sprites in a list - assetToSearchMultipleSprite = new List(); + // Draw the results of the search + GUI.enabled = false; - Object[] sprites = AssetDatabase.LoadAllAssetRepresentationsAtPath( assetPath ); - for( int i = 0; i < sprites.Length; i++ ) + assetToSearch = EditorGUILayout.ObjectField( "Asset(s): ", assetToSearch, typeof( Object ), true ); + + GUILayout.Space( 10 ); + GUI.enabled = true; + + restoreInitialSceneSetup = EditorGUILayout.ToggleLeft( "Restore initial scene setup after search is reset (Recommended)", restoreInitialSceneSetup ); + + if( GUILayout.Button( "Reset Search", GL_HEIGHT_30 ) ) { - if( sprites[i] is Sprite ) + if( !restoreInitialSceneSetup || RestoreInitialSceneSetup() ) { - assetToSearchMultipleSprite.Add( (Sprite) sprites[i] ); + errorMessage = string.Empty; + currentPhase = Phase.Setup; } } - // If there is, in fact, multiple sprites extracted, - // set the asset type accordingly - // Otherwise (only 1 sprite is extracted), simply change the - // searched asset to that sprite - if( assetToSearchMultipleSprite.Count > 1 ) + Color c = GUI.color; + GUI.color = Color.green; + GUILayout.Box( "Don't forget to save scene(s) if you made any changes!", GL_EXPAND_WIDTH ); + GUI.color = c; + + GUILayout.Space( 10 ); + + if( searchResult.Count == 0 ) { - assetType = AssetType.MultipleSprite; - assetClass = typeof( Sprite ); + GUILayout.Box( "No results found...", GL_EXPAND_WIDTH ); } - else if( assetToSearchMultipleSprite.Count == 1 ) + else { - assetToSearch = assetToSearchMultipleSprite[0]; + GUILayout.BeginHorizontal(); + + // Select all the references after filtering them (select only the GameObject's) + if( GUILayout.Button( "Select All\n(GameObject-wise)", GL_HEIGHT_35 ) ) + { + HashSet uniqueGameObjects = new HashSet(); + for( int i = 0; i < searchResult.Count; i++ ) + searchResult[i].AddGameObjectsTo( uniqueGameObjects ); + + if( uniqueGameObjects.Count > 0 ) + { + GameObject[] objects = new GameObject[uniqueGameObjects.Count]; + uniqueGameObjects.CopyTo( objects ); + Selection.objects = objects; + } + } + + // Select all the references without filtering them + if( GUILayout.Button( "Select All\n(Object-wise)", GL_HEIGHT_35 ) ) + { + HashSet uniqueObjects = new HashSet(); + for( int i = 0; i < searchResult.Count; i++ ) + searchResult[i].AddObjectsTo( uniqueObjects ); + + if( uniqueObjects.Count > 0 ) + { + Object[] objects = new Object[uniqueObjects.Count]; + uniqueObjects.CopyTo( objects ); + Selection.objects = objects; + } + } + + GUILayout.EndHorizontal(); + + GUILayout.Space( 10 ); + + showFullPathsToReferences = EditorGUILayout.ToggleLeft( new GUIContent( "Show full paths to references (can be slow with too many references)", "If deselected, only the most relevant parts of the paths are drawn" ), showFullPathsToReferences ); + + showTooltips = EditorGUILayout.ToggleLeft( "Show tooltips", showTooltips ); + + GUILayout.Space( 10 ); + + // Tooltip gets its value in ReferenceHolder.DrawOnGUI function + tooltip = null; + for( int i = 0; i < searchResult.Count; i++ ) + searchResult[i].DrawOnGUI( showFullPathsToReferences ); + + Vector2 mousePos = Event.current.mousePosition; + if( tooltip != null ) + { + // Show tooltip at mouse position + float width = tooltip.Length * 8; + GUI.Box( new Rect( mousePos.x - width * 0.5f, mousePos.y - 40f, width, 40f ), tooltip, TooltipGUIStyle ); + } } } - else if( importSettings.spriteImportMode != SpriteImportMode.None ) - { - // If it is a single sprite, try to extract - // the sprite from the asset - Sprite spriteRepresentation = AssetDatabase.LoadAssetAtPath( assetPath ); - if( spriteRepresentation != null ) - assetToSearch = spriteRepresentation; - } + + GUILayout.Space( 10 ); + + GUILayout.EndVertical(); + + EditorGUILayout.EndScrollView(); } - if( assetType != AssetType.MultipleSprite ) + // Search for references! + private void ExecuteQuery() { - if( assetToSearch is Texture ) - assetType = AssetType.Texture; - else if( assetToSearch is Material ) - assetType = AssetType.Material; - else if( assetToSearch is MonoScript ) - assetType = AssetType.Script; - else if( assetToSearch is Shader ) - assetType = AssetType.Shader; - else if( assetToSearch is AnimationClip ) - assetType = AssetType.Animation; - else if( assetToSearch is GameObject ) - assetType = AssetType.GameObject; + searchCount = 0; + searchStartTime = EditorApplication.timeSinceStartup; + + // Initialize commonly used variables + if( searchResult == null ) + searchResult = new List( 16 ); else - assetType = AssetType.Other; + searchResult.Clear(); - assetClass = assetToSearch.GetType(); - } + if( typeToVariables == null ) + typeToVariables = new Dictionary( 4096 ); + else if( assembliesReloaded || searchDepthLimit != prevSearchDepthLimit || prevFieldModifiers != fieldModifiers || prevPropertyModifiers != propertyModifiers ) + typeToVariables.Clear(); - Debug.Log( "Asset type: " + assetType ); + if( searchableTypes == null ) + searchableTypes = new Dictionary( 4096 ); + else + searchableTypes.Clear(); - // Find the scenes to search for references - HashSet scenesToSearch = new HashSet(); - if( searchInAllScenes ) - { - // Get all scenes from the Assets folder - string[] scenesTemp = AssetDatabase.FindAssets( "t:SceneAsset" ); - for( int i = 0; i < scenesTemp.Length; i++ ) + if( searchedObjects == null ) + searchedObjects = new Dictionary( 32768 ); + else + searchedObjects.Clear(); + + if( callStack == null ) + callStack = new Stack( 64 ); + else + callStack.Clear(); + + if( searchedTypesStack == null ) + searchedTypesStack = new Stack( 8 ); + + if( assetsSet == null ) + assetsSet = new HashSet(); + else + assetsSet.Clear(); + + assembliesReloaded = false; + prevSearchDepthLimit = searchDepthLimit; + prevFieldModifiers = fieldModifiers; + prevPropertyModifiers = propertyModifiers; + + HashSet allAssetClasses = new HashSet(); + + searchMaterialAssets = false; + searchGameObjectReferences = false; + searchMonoBehavioursForScript = false; + searchRenderers = false; + searchMaterialsForShader = false; + searchMaterialsForTexture = false; + + // Store the searched asset and its sub-assets (if any) in a set + isSearchingAsset = !string.IsNullOrEmpty( AssetDatabase.GetAssetPath( assetToSearch ) ); + bool isMainAssetSearched = AssetDatabase.IsMainAsset( assetToSearch ); + if( isMainAssetSearched && includeSubAssetsInSearch && !( assetToSearch is SceneAsset ) ) { - scenesToSearch.Add( AssetDatabase.GUIDToAssetPath( scenesTemp[i] ) ); - } - } - else - { - if( searchInOpenScenes ) - { - // Get all open (and loaded) scenes - for( int i = 0; i < EditorSceneManager.loadedSceneCount; i++ ) + Object[] assets = AssetDatabase.LoadAllAssetsAtPath( AssetDatabase.GetAssetPath( assetToSearch ) ); + for( int i = 0; i < assets.Length; i++ ) { - Scene scene = EditorSceneManager.GetSceneAt( i ); - if( scene.IsValid() ) - scenesToSearch.Add( scene.path ); - } - } - - if( searchInScenesInBuild ) - { - // Get all scenes in build settings (ticked) - EditorBuildSettingsScene[] scenesTemp = EditorBuildSettings.scenes; - for( int i = 0; i < scenesTemp.Length; i++ ) - { - if( scenesTemp[i].enabled ) + if( assets[i] != null ) { - scenesToSearch.Add( scenesTemp[i].path ); + assetsSet.Add( assets[i] ); + allAssetClasses.Add( assets[i].GetType() ); + + if( assets[i] is MonoScript ) + allAssetClasses.Add( ( (MonoScript) assets[i] ).GetClass() ); } } } - } - - if( searchInAssetsFolder ) - { - currentSceneReferences = new SceneObjectReferences( "Project View (Assets)", false ); - - // Search through all prefabs and imported models - string[] pathsToAssets = AssetDatabase.FindAssets( "t:GameObject" ); - for( int i = 0; i < pathsToAssets.Length; i++ ) + else { - CheckGameObjectForAssetRecursive( AssetDatabase.LoadAssetAtPath( AssetDatabase.GUIDToAssetPath( pathsToAssets[i] ) ) ); + assetsSet.Add( assetToSearch ); + allAssetClasses.Add( assetToSearch.GetType() ); - if( !ShouldContinueSearching ) - break; + if( assetToSearch is MonoScript ) + allAssetClasses.Add( ( (MonoScript) assetToSearch ).GetClass() ); } - if( ShouldContinueSearching ) + if( assetToSearch is GameObject ) { - // If asset is shader or texture, search through all materials in the project - if( assetType == AssetType.Shader || assetType == AssetType.Texture ) + // If searched asset is a GameObject, include its components in the search + Component[] components; + if( isMainAssetSearched && includeSubAssetsInSearch ) + components = ( (GameObject) assetToSearch ).GetComponentsInChildren(); + else + components = ( (GameObject) assetToSearch ).GetComponents(); + + for( int i = 0; i < components.Length; i++ ) + { + assetsSet.Add( components[i] ); + allAssetClasses.Add( components[i].GetType() ); + } + } + + assetClasses = new Type[allAssetClasses.Count]; + allAssetClasses.CopyTo( assetClasses ); + + foreach( Object asset in assetsSet ) + { + // Initialize the nodes of searched asset(s) + searchedObjects.Add( asset.Hash(), new ReferenceNode( asset ) ); + + if( asset is Texture ) + { + searchMaterialAssets = true; + searchRenderers = true; + searchMaterialsForTexture = true; + } + else if( asset is Material ) + { + searchRenderers = true; + } + else if( asset is MonoScript ) + { + searchMonoBehavioursForScript = true; + } + else if( asset is Shader ) + { + searchMaterialAssets = true; + searchRenderers = true; + searchMaterialsForShader = true; + } + else if( asset is GameObject ) + { + searchGameObjectReferences = true; + } + } + + // Find the scenes to search for references + HashSet scenesToSearch = new HashSet(); + if( searchInAllScenes ) + { + // Get all scenes from the Assets folder + string[] scenesTemp = AssetDatabase.FindAssets( "t:SceneAsset" ); + for( int i = 0; i < scenesTemp.Length; i++ ) + scenesToSearch.Add( AssetDatabase.GUIDToAssetPath( scenesTemp[i] ) ); + } + else + { + if( searchInOpenScenes ) + { + // Get all open (and loaded) scenes + for( int i = 0; i < EditorSceneManager.loadedSceneCount; i++ ) + { + Scene scene = EditorSceneManager.GetSceneAt( i ); + if( scene.IsValid() ) + scenesToSearch.Add( scene.path ); + } + } + + if( searchInScenesInBuild ) + { + // Get all scenes in build settings + EditorBuildSettingsScene[] scenesTemp = EditorBuildSettings.scenes; + for( int i = 0; i < scenesTemp.Length; i++ ) + { + if( !searchInScenesInBuildTickedOnly || scenesTemp[i].enabled ) + scenesToSearch.Add( scenesTemp[i].path ); + } + } + } + + // By default, search only serializable variables for references + searchSerializableVariablesOnly = true; + + // Don't search assets if searched object is a scene object as assets can't hold references to scene objects + if( searchInAssetsFolder && isSearchingAsset ) + { + currentReferenceHolder = new ReferenceHolder( "Project View (Assets)", false ); + + // Search through all the prefabs and imported models in the project + string[] pathsToAssets = AssetDatabase.FindAssets( "t:GameObject" ); + for( int i = 0; i < pathsToAssets.Length; i++ ) + SearchGameObjectRecursively( AssetDatabase.LoadAssetAtPath( AssetDatabase.GUIDToAssetPath( pathsToAssets[i] ) ) ); + + // Search through all the scriptable objects in the project + pathsToAssets = AssetDatabase.FindAssets( "t:ScriptableObject" ); + for( int i = 0; i < pathsToAssets.Length; i++ ) + BeginSearchObject( AssetDatabase.LoadAssetAtPath( AssetDatabase.GUIDToAssetPath( pathsToAssets[i] ) ) ); + + // If a searched asset is shader or texture, search through all the materials in the project + if( searchMaterialAssets ) { pathsToAssets = AssetDatabase.FindAssets( "t:Material" ); for( int i = 0; i < pathsToAssets.Length; i++ ) - { - Material mat = AssetDatabase.LoadAssetAtPath( AssetDatabase.GUIDToAssetPath( pathsToAssets[i] ) ); - if( CheckMaterialForAsset( mat, out additionalInfo ) ) - { - currentSceneReferences.AddReference( mat, additionalInfo ); - - if( stopAtFirstOccurrence ) - break; - } - } - } - } - - // Search through all AnimatorController's and AnimationClip's in the project - if( ShouldContinueSearching ) - { - if( assetType != AssetType.Animation ) - { - // Search through animation clip keyframes for references to searched asset - pathsToAssets = AssetDatabase.FindAssets( "t:AnimationClip" ); - for( int i = 0; i < pathsToAssets.Length; i++ ) - { - AnimationClip animClip = AssetDatabase.LoadAssetAtPath( AssetDatabase.GUIDToAssetPath( pathsToAssets[i] ) ); - if( CheckAnimationForAsset( animClip, out additionalInfo ) ) - { - currentSceneReferences.AddReference( animClip, additionalInfo ); - - if( stopAtFirstOccurrence ) - break; - } - } + BeginSearchObject( AssetDatabase.LoadAssetAtPath( AssetDatabase.GUIDToAssetPath( pathsToAssets[i] ) ) ); } - if( ShouldContinueSearching ) - { - // Search through all animator controllers - pathsToAssets = AssetDatabase.FindAssets( "t:RuntimeAnimatorController" ); - for( int i = 0; i < pathsToAssets.Length; i++ ) - { - RuntimeAnimatorController animController = AssetDatabase.LoadAssetAtPath( AssetDatabase.GUIDToAssetPath( pathsToAssets[i] ) ); - AnimationClip[] animClips = animController.animationClips; - bool foundAsset = false; - for( int j = 0; j < animClips.Length; j++ ) - { - if( CheckAnimationForAsset( animClips[j], out additionalInfo ) ) - { - if( additionalInfo != null ) - additionalInfo = "Animation clip: " + animClips[j].name + "\n" + additionalInfo; + // Search through all the animation clips in the project + pathsToAssets = AssetDatabase.FindAssets( "t:AnimationClip" ); + for( int i = 0; i < pathsToAssets.Length; i++ ) + BeginSearchObject( AssetDatabase.LoadAssetAtPath( AssetDatabase.GUIDToAssetPath( pathsToAssets[i] ) ) ); - foundAsset = true; - break; - } - } + // Search through all the animator controllers in the project + pathsToAssets = AssetDatabase.FindAssets( "t:RuntimeAnimatorController" ); + for( int i = 0; i < pathsToAssets.Length; i++ ) + BeginSearchObject( AssetDatabase.LoadAssetAtPath( AssetDatabase.GUIDToAssetPath( pathsToAssets[i] ) ) ); - if( foundAsset ) - { - currentSceneReferences.AddReference( animController, additionalInfo ); - - if( stopAtFirstOccurrence ) - break; - } - } - } + // If a reference is found in the Project view, save the results + if( currentReferenceHolder.NumberOfReferences > 0 ) + searchResult.Add( currentReferenceHolder ); } - // If a reference is found in the Project view, save the result(s) - if( currentSceneReferences.Count > 0 ) - { - searchResult.Add( currentSceneReferences ); - } - } + // Search non-serializable variables for references only if we are currently searching a scene and the editor is in play mode + if( EditorApplication.isPlaying ) + searchSerializableVariablesOnly = false; - if( ShouldContinueSearching ) - { foreach( string scenePath in scenesToSearch ) { + // Search scene for references if( scenePath != null ) - { - // Open the scene additively (to access its objects) - Scene scene; - if( EditorApplication.isPlaying ) - scene = EditorSceneManager.GetSceneByPath( scenePath ); - else - scene = EditorSceneManager.OpenScene( scenePath, OpenSceneMode.Additive ); - - currentSceneReferences = new SceneObjectReferences( scenePath, true ); - - // Search through all GameObjects in the scene - GameObject[] rootGameObjects = scene.GetRootGameObjects(); - for( int i = 0; i < rootGameObjects.Length; i++ ) - { - CheckGameObjectForAssetRecursive( rootGameObjects[i] ); - - if( !ShouldContinueSearching ) - break; - } - - // If no reference is found in this scene - // and the scene is not part of the initial scene setup, - // close it - if( currentSceneReferences.Count == 0 ) - { - if( !EditorApplication.isPlaying ) - { - bool sceneIsOneOfInitials = false; - for( int i = 0; i < sceneInitialSetup.Length; i++ ) - { - if( sceneInitialSetup[i].path == scenePath ) - { - if( !sceneInitialSetup[i].isLoaded ) - EditorSceneManager.CloseScene( scene, false ); - - sceneIsOneOfInitials = true; - break; - } - } - - if( !sceneIsOneOfInitials ) - EditorSceneManager.CloseScene( scene, true ); - } - } - else - { - // Some references are found in this scene, - // save the results - searchResult.Add( currentSceneReferences ); - - if( stopAtFirstOccurrence ) - break; - } - } + SearchScene( scenePath ); } - } - if( !stopAtFirstOccurrence || searchResult.Count == 0 ) - { + // Search through all the GameObjects under the DontDestroyOnLoad scene (if exists) if( EditorApplication.isPlaying ) { - currentSceneReferences = new SceneObjectReferences( "DontDestroyOnLoad", false ); + currentReferenceHolder = new ReferenceHolder( "DontDestroyOnLoad", false ); - // Search through all GameObjects under the DontDestroyOnLoad scene GameObject[] rootGameObjects = GetDontDestroyOnLoadObjects().ToArray(); for( int i = 0; i < rootGameObjects.Length; i++ ) - { - CheckGameObjectForAssetRecursive( rootGameObjects[i] ); + SearchGameObjectRecursively( rootGameObjects[i] ); - if( !ShouldContinueSearching ) - break; - } + if( currentReferenceHolder.NumberOfReferences > 0 ) + searchResult.Add( currentReferenceHolder ); + } - if( currentSceneReferences.Count > 0 ) + // Log some c00l stuff to console + Debug.Log( "Searched " + searchCount + " objects in " + ( EditorApplication.timeSinceStartup - searchStartTime ).ToString( "F2" ) + " seconds" ); + + // Search is complete! + currentPhase = Phase.Complete; + } + + // Search a scene for references + private void SearchScene( string scenePath ) + { + Scene scene = EditorSceneManager.GetSceneByPath( scenePath ); + + if( !EditorApplication.isPlaying ) + { + // Open the scene additively (to access its objects) only if it seems to contain some references to searched object(s) + if( isSearchingAsset && !AssetDatabase.LoadAssetAtPath( scenePath ).HasAnyReferenceTo( assetsSet ) ) + return; + + scene = EditorSceneManager.OpenScene( scenePath, OpenSceneMode.Additive ); + } + + currentReferenceHolder = new ReferenceHolder( scenePath, true ); + + // Search through all the GameObjects in the scene + GameObject[] rootGameObjects = scene.GetRootGameObjects(); + for( int i = 0; i < rootGameObjects.Length; i++ ) + SearchGameObjectRecursively( rootGameObjects[i] ); + + // If no references are found in the scene and if the scene is not part of the initial scene setup, close it + if( currentReferenceHolder.NumberOfReferences == 0 ) + { + if( !EditorApplication.isPlaying ) { - // Some references are found in this scene, - // save the results - searchResult.Add( currentSceneReferences ); + bool sceneIsOneOfInitials = false; + for( int i = 0; i < initialSceneSetup.Length; i++ ) + { + if( initialSceneSetup[i].path == scenePath ) + { + if( !initialSceneSetup[i].isLoaded ) + EditorSceneManager.CloseScene( scene, false ); + + sceneIsOneOfInitials = true; + break; + } + } + + if( !sceneIsOneOfInitials ) + EditorSceneManager.CloseScene( scene, true ); } } + else + { + // Some references are found in this scene, save the results + searchResult.Add( currentReferenceHolder ); + } } - // Search is complete! - currentPhase = Phase.Complete; - } - - // Search through components of this GameObject in detail - // (including fields, properties, arrays, ArrayList's and generic List's in scripts) - // and then search through its children recursively - private void CheckGameObjectForAssetRecursive( GameObject go ) - { - if( !ShouldContinueSearching ) - return; - - // Check if this GameObject's prefab is the selected asset - if( assetType == AssetType.GameObject && PrefabUtility.GetPrefabParent( go ) == assetToSearch ) + // Search a GameObject and its children for references recursively + private void SearchGameObjectRecursively( GameObject go ) { - currentSceneReferences.AddReference( go ); + BeginSearchObject( go ); - if( stopAtFirstOccurrence ) - return; + Transform tr = go.transform; + for( int i = 0; i < tr.childCount; i++ ) + SearchGameObjectRecursively( tr.GetChild( i ).gameObject ); } - else + + // Begin searching a root object (like a GameObject or an asset) + private void BeginSearchObject( Object obj ) { - string additionalInfo = null; + if( assetsSet.Contains( obj ) ) + { + // Rare case: if searched object is a scene GameObject, search its components for references + // instead of completely ignoring the GameObject + if( obj is GameObject ) + { + ReferenceNode referenceNode = PopReferenceNode( obj ); + Component[] components = ( (GameObject) obj ).GetComponents(); + for( int i = 0; i < components.Length; i++ ) + { + ReferenceNode componentNode = SearchComponent( components[i] ); + if( componentNode == null ) + continue; - Component[] components = go.GetComponents(); + if( componentNode.NumberOfOutgoingLinks > 0 ) + referenceNode.AddLinkTo( componentNode ); + else + PoolReferenceNode( componentNode ); + } + + if( referenceNode.NumberOfOutgoingLinks > 0 ) + currentReferenceHolder.AddReference( referenceNode ); + else + PoolReferenceNode( referenceNode ); + } + return; + } + + ReferenceNode searchResult = SearchObject( obj ); + if( searchResult != null ) + currentReferenceHolder.AddReference( searchResult ); + } + + // Search an object for references + private ReferenceNode SearchObject( object obj ) + { + if( obj == null || obj.Equals( null ) ) + return null; + + // Avoid recursion (which leads to stackoverflow exception) using a stack + if( callStack.Contains( obj ) ) + return null; + + // Hashing does not work well with structs all the time, don't cache search results for structs + string objHash = null; + if( !( obj is ValueType ) ) + { + objHash = obj.Hash(); + + // If object was searched before, return the cached result + ReferenceNode cachedResult; + if( searchedObjects.TryGetValue( objHash, out cachedResult ) ) + { + if( cachedResult != null ) + return cachedResult; + + return null; + } + } + + searchCount++; + + ReferenceNode result; + Object unityObject = obj as Object; + if( unityObject != null ) + { + // If we hit a searched asset + if( assetsSet.Contains( unityObject ) ) + { + result = new ReferenceNode( unityObject ); + searchedObjects.Add( objHash, result ); + + return result; + } + + // Search the Object in detail only if EditorUtility.CollectDependencies returns a reference + if( isSearchingAsset && !unityObject.HasAnyReferenceTo( assetsSet ) ) + { + searchedObjects.Add( objHash, null ); + return null; + } + + callStack.Push( unityObject ); + + // Search the Object in detail + if( unityObject is GameObject ) + result = SearchGameObject( (GameObject) unityObject ); + else if( unityObject is Component ) + result = SearchComponent( (Component) unityObject ); + else if( unityObject is Material ) + result = SearchMaterial( (Material) unityObject ); + else if( unityObject is RuntimeAnimatorController ) + result = SearchAnimatorController( (RuntimeAnimatorController) unityObject ); + else if( unityObject is AnimationClip ) + result = SearchAnimationClip( (AnimationClip) unityObject ); + else + { + result = PopReferenceNode( unityObject ); + SearchFieldsAndPropertiesOf( result ); + } + + callStack.Pop(); + } + else + { + // Comply with the recursive search limit + if( currentDepth >= searchDepthLimit ) + return null; + + callStack.Push( obj ); + currentDepth++; + + result = PopReferenceNode( obj ); + SearchFieldsAndPropertiesOf( result ); + + currentDepth--; + callStack.Pop(); + } + + if( result != null && result.NumberOfOutgoingLinks == 0 ) + { + PoolReferenceNode( result ); + result = null; + } + + // Cache the search result if we are skimming through a class (not a struct; i.e. objHash != null) + // and if the object is a UnityEngine.Object (if not cache the result only if we have actually found something + // or we are at the root of the search; i.e. currentDepth == 0) + if( ( result != null || unityObject != null || currentDepth == 0 ) && objHash != null ) + searchedObjects.Add( objHash, result ); + + return result; + } + + // Search through components of this GameObject in detail + private ReferenceNode SearchGameObject( GameObject go ) + { + ReferenceNode referenceNode = PopReferenceNode( go ); + + // Check if this GameObject's prefab is one of the selected assets + if( searchGameObjectReferences ) + { + Object prefab = PrefabUtility.GetPrefabParent( go ); + if( assetsSet.Contains( prefab ) && go == PrefabUtility.FindRootGameObjectWithSameParentPrefab( go ) ) + referenceNode.AddLinkTo( GetReferenceNode( prefab ), "Prefab object" ); + } + // Search through all the components of the object + Component[] components = go.GetComponents(); for( int i = 0; i < components.Length; i++ ) { - Component component = components[i]; - - if( component == null ) - continue; - - // Ignore Transform component (no object field to search for) - if( component is Transform ) - continue; - - if( component == assetToSearch ) - { - currentSceneReferences.AddReference( component ); - - if( stopAtFirstOccurrence ) - return; - else - continue; - } - - if( assetType == AssetType.Script && component is MonoBehaviour ) - { - // If selected asset is a script, check if this component is an instance of it - - if( MonoScript.FromMonoBehaviour( (MonoBehaviour) component ) == assetToSearch ) - { - currentSceneReferences.AddReference( component ); - - if( stopAtFirstOccurrence ) - return; - else - continue; - } - } - else if( ( assetType == AssetType.Shader || assetType == AssetType.Texture || assetType == AssetType.Material ) && component is Renderer ) - { - // If selected asset is a shader, texture or material, and this component is a Renderer, - // perform a special search (CheckMaterialForAsset) for references - - Material[] materials = ( (Renderer) component ).sharedMaterials; - - bool foundAsset = false; - for( int j = 0; j < materials.Length; j++ ) - { - if( CheckMaterialForAsset( materials[j], out additionalInfo ) ) - { - if( additionalInfo != null ) - additionalInfo = "Material: " + materials[j].name + "\n" + additionalInfo; - - foundAsset = true; - break; - } - } - - if( foundAsset ) - { - currentSceneReferences.AddReference( component, additionalInfo ); - - if( stopAtFirstOccurrence ) - return; - else - continue; - } - } - else if( component is Animation || component is Animator ) - { - // If this component is an Animation or Animator, perform a special search for references - // in its animation clips (and keyframes in these animations) - - bool foundAsset = false; - if( component is Animation ) - { - foreach( AnimationState anim in (Animation) component ) - { - if( CheckAnimationForAsset( anim.clip, out additionalInfo ) ) - { - if( additionalInfo != null ) - additionalInfo = "Animation clip: " + anim.clip.name + "\n" + additionalInfo; - - foundAsset = true; - break; - } - } - } - else if( component is Animator ) - { - RuntimeAnimatorController animController = ( (Animator) component ).runtimeAnimatorController; - if( animController != null ) - { - AnimationClip[] animClips = animController.animationClips; - for( int j = 0; j < animClips.Length; j++ ) - { - if( CheckAnimationForAsset( animClips[j], out additionalInfo ) ) - { - if( additionalInfo != null ) - additionalInfo = "Animation clip: " + animClips[j].name + "\n" + additionalInfo; - - foundAsset = true; - break; - } - } - } - } - - if( foundAsset ) - { - currentSceneReferences.AddReference( component, additionalInfo ); - - if( stopAtFirstOccurrence ) - return; - else - continue; - } - } - - // None of the above methods yielded a result for this component, - // Perform a search through fields, properties, arrays, ArrayList's and - // generic List's of this component - - FieldInfo[] variables; - if( !typeToVariables.TryGetValue( component.GetType(), out variables ) ) - { - // If it is the first time this type of object is seen, - // filter and cache its fields - System.Type componentType = component.GetType(); - variables = componentType.GetFields( FIELD_MODIFIERS ); - - // Filter the fields - if( variables.Length > 0 ) - { - int invalidVariables = 0; - List validVariables = new List(); - for( int j = 0; j < variables.Length; j++ ) - { - // Field filtering process: - // 1- allow field types that are subclass of UnityEngine.Object and superclass of searched asset's type - // 2- allow fields that extend UnityEngine.Component (but only if asset type is GameObject) to find out whether the component - // stored in that field is a component of the searched asset - // 3- allow ArrayList collections - // 4- allow arrays whose elements' type is superclass of the searched asset's type - // 5- allow arrays whose elements extend UnityEngine.Component and the asset type is GameObject (similar to 2) - // 6- allow generic List collections whose generic type is superclass of the searched asset's type - // 6- allow generic List collections whose generic type extends UnityEngine.Component - // and the asset type is GameObject (similar to 2) - System.Type variableType = variables[j].FieldType; - if( ( IsTypeDerivedFrom( variableType, typeof( Object ) ) && IsTypeDerivedFrom( assetClass, variableType ) ) || - ( IsTypeDerivedFrom( variableType, typeof( Component ) ) && assetType == AssetType.GameObject ) || - IsTypeDerivedFrom( variableType, typeof( ArrayList ) ) || - ( variableType.IsArray && ( IsTypeDerivedFrom( assetClass, variableType.GetElementType() ) || - ( IsTypeDerivedFrom( variableType.GetElementType(), typeof( Component ) ) && assetType == AssetType.GameObject ) ) ) || - ( variableType.IsGenericType && ( IsTypeDerivedFrom( assetClass, variableType.GetGenericArguments()[0] ) || - ( IsTypeDerivedFrom( variableType.GetGenericArguments()[0], typeof( Component ) ) && assetType == AssetType.GameObject ) ) ) ) - { - validVariables.Add( variables[j] ); - } - else - { - invalidVariables++; - } - } - - if( invalidVariables > 0 ) - { - variables = validVariables.ToArray(); - } - } - - // Cache the filtered fields - typeToVariables.Add( componentType, variables ); - } - - // Search through all the filtered fields - for( int j = 0; j < variables.Length; j++ ) - { - object variableValue = variables[j].GetValue( component ); - if( CheckVariableValueForAsset( variableValue ) ) - { - currentSceneReferences.AddReference( component, "Variable: " + variables[j].Name ); - - if( stopAtFirstOccurrence ) - return; - else - break; - } - else if( variableValue is IEnumerable && !( variableValue is Transform ) ) - { - // If the field is IEnumerable (possibly an array or collection), - // search through members of it (not recursive) - // Note that Transform IEnumerable (children of the transform) is not iterated - bool assetFoundInArray = false; - try - { - foreach( object arrayItem in (IEnumerable) variableValue ) - { - if( CheckVariableValueForAsset( arrayItem ) ) - { - currentSceneReferences.AddReference( component, "Variable (IEnumerable): " + variables[j].Name ); - - if( stopAtFirstOccurrence ) - return; - else - { - assetFoundInArray = true; - break; - } - } - } - } - catch( UnassignedReferenceException ) - { } - catch( MissingReferenceException ) - { } - - if( assetFoundInArray ) - { - break; - } - } - } - - PropertyInfo[] properties; - if( !typeToProperties.TryGetValue( component.GetType(), out properties ) ) - { - // If it is the first time this type of object is seen, - // filter and cache its properties - System.Type componentType = component.GetType(); - properties = componentType.GetProperties( PROPERTY_MODIFIERS ); - - // Filter the properties - if( properties.Length > 0 ) - { - int invalidProperties = 0; - List validProperties = new List(); - for( int j = 0; j < properties.Length; j++ ) - { - // Property filtering process: - // 1- allow property types that are subclass of UnityEngine.Object and superclass of searched asset's type - // 2- allow properties that extend UnityEngine.Component (but only if asset type is GameObject) to find out whether the component - // stored in that property is a component of the searched asset - // 3- allow ArrayList collections - // 4- allow arrays whose elements' type is superclass of the searched asset's type - // 5- allow arrays whose elements extend UnityEngine.Component and the asset type is GameObject (similar to 2) - // 6- allow generic List collections whose generic type is superclass of the searched asset's type - // 6- allow generic List collections whose generic type extends UnityEngine.Component - // and the asset type is GameObject (similar to 2) - System.Type propertyType = properties[j].PropertyType; - if( ( IsTypeDerivedFrom( propertyType, typeof( Object ) ) && IsTypeDerivedFrom( assetClass, propertyType ) ) || - ( IsTypeDerivedFrom( propertyType, typeof( Component ) ) && assetType == AssetType.GameObject ) || - IsTypeDerivedFrom( propertyType, typeof( ArrayList ) ) || - ( propertyType.IsArray && ( IsTypeDerivedFrom( assetClass, propertyType.GetElementType() ) || - ( IsTypeDerivedFrom( propertyType.GetElementType(), typeof( Component ) ) && assetType == AssetType.GameObject ) ) ) || - ( propertyType.IsGenericType && ( IsTypeDerivedFrom( assetClass, propertyType.GetGenericArguments()[0] ) || - ( IsTypeDerivedFrom( propertyType.GetGenericArguments()[0], typeof( Component ) ) && assetType == AssetType.GameObject ) ) ) ) - { - // Additional filtering for properties: - // 1- Ignore "gameObject", "transform", "rectTransform" and "attachedRigidbody" properties to reduce repetition - // and get more relevant results - // 2- Ignore "canvasRenderer" and "canvas" properties of Graphic components - // 3 & 4- Prevent accessing properties of Unity that instantiate an existing resource (causing leak) - if( properties[j].Name.Equals( "gameObject" ) || properties[j].Name.Equals( "transform" ) || - properties[j].Name.Equals( "attachedRigidbody" ) || properties[j].Name.Equals( "rectTransform" ) ) - invalidProperties++; - else if( ( properties[j].Name.Equals( "canvasRenderer" ) || properties[j].Name.Equals( "canvas" ) ) && - IsTypeDerivedFrom( componentType, typeof( UnityEngine.UI.Graphic ) ) ) - invalidProperties++; - else if( properties[j].Name.Equals( "mesh" ) && IsTypeDerivedFrom( componentType, typeof( MeshFilter ) ) ) - invalidProperties++; - else if( ( properties[j].Name.Equals( "material" ) || properties[j].Name.Equals( "materials" ) ) && - ( IsTypeDerivedFrom( componentType, typeof( Renderer ) ) || IsTypeDerivedFrom( componentType, typeof( Collider ) ) || - IsTypeDerivedFrom( componentType, typeof( Collider2D ) ) || IsTypeDerivedFrom( componentType, typeof( GUIText ) ) ) ) - invalidProperties++; - else - validProperties.Add( properties[j] ); - } - else - { - invalidProperties++; - } - } - - if( invalidProperties > 0 ) - { - properties = validProperties.ToArray(); - } - } - - // Cache the filtered properties - typeToProperties.Add( componentType, properties ); - } - - // Search through all the filtered properties - for( int j = 0; j < properties.Length; j++ ) - { - try - { - object propertyValue = properties[j].GetValue( component, null ); - - if( CheckVariableValueForAsset( propertyValue ) ) - { - currentSceneReferences.AddReference( component, "Property: " + properties[j].Name ); - - if( stopAtFirstOccurrence ) - return; - else - break; - } - else if( propertyValue is IEnumerable && !( propertyValue is Transform ) ) - { - // If the property is IEnumerable (possibly an array or collection), - // search through members of it (not recursive) - // Note that Transform IEnumerable (children of the transform) is not iterated - bool assetFoundInArray = false; - try - { - foreach( object arrayItem in (IEnumerable) propertyValue ) - { - if( CheckVariableValueForAsset( arrayItem ) ) - { - currentSceneReferences.AddReference( component, "Property (IEnumerable): " + properties[j].Name ); - - if( stopAtFirstOccurrence ) - return; - else - { - assetFoundInArray = true; - break; - } - } - } - } - catch( UnassignedReferenceException ) - { } - catch( MissingReferenceException ) - { } - - if( assetFoundInArray ) - { - break; - } - } - } - catch( System.Exception ) - { } - } + ReferenceNode result = SearchObject( components[i] ); + if( result != null ) + referenceNode.AddLinkTo( result ); } + + return referenceNode; } - // Search the children GameObject's recursively - Transform tr = go.transform; - for( int i = 0; i < tr.childCount; i++ ) + // Check if the asset is used in this component + private ReferenceNode SearchComponent( Component component ) { - CheckGameObjectForAssetRecursive( tr.GetChild( i ).gameObject ); - } - } + // Ignore Transform component (no object field to search for) + if( component is Transform ) + return null; - // Chech if asset is used in this material - private bool CheckMaterialForAsset( Material material, out string additionalInfo ) - { - additionalInfo = null; + ReferenceNode referenceNode = PopReferenceNode( component ); - if( material == null ) - return false; - - if( material == assetToSearch ) - return true; - - if( assetType == AssetType.Shader ) - { - if( material.shader == assetToSearch ) - return true; - } - else if( assetType == AssetType.Texture ) - { - // Search through all the textures attached to this material - // Credit to: jobesu on unity answers - Shader shader = material.shader; - int shaderPropertyCount = ShaderUtil.GetPropertyCount( shader ); - for( int k = 0; k < shaderPropertyCount; k++ ) + if( searchMonoBehavioursForScript && component is MonoBehaviour ) { - if( ShaderUtil.GetPropertyType( shader, k ) == ShaderUtil.ShaderPropertyType.TexEnv ) + // If a searched asset is script, check if this component is an instance of it + MonoScript script = MonoScript.FromMonoBehaviour( (MonoBehaviour) component ); + if( assetsSet.Contains( script ) ) + referenceNode.AddLinkTo( GetReferenceNode( script ) ); + } + + if( searchRenderers && component is Renderer ) + { + // If an asset is a shader, texture or material, and this component is a Renderer, + // search it for references + Material[] materials = ( (Renderer) component ).sharedMaterials; + for( int j = 0; j < materials.Length; j++ ) + referenceNode.AddLinkTo( SearchObject( materials[j] ) ); + } + + if( component is Animation ) + { + // If this component is an Animation, search its animation clips for references + foreach( AnimationState anim in (Animation) component ) + referenceNode.AddLinkTo( SearchObject( anim.clip ) ); + } + + if( component is Animator ) + { + // If this component is an Animator, search its animation clips for references + referenceNode.AddLinkTo( SearchObject( ( (Animator) component ).runtimeAnimatorController ) ); + } + + SearchFieldsAndPropertiesOf( referenceNode ); + + return referenceNode; + } + + // Check if the asset is used in this material + private ReferenceNode SearchMaterial( Material material ) + { + ReferenceNode referenceNode = PopReferenceNode( material ); + + if( searchMaterialsForShader && assetsSet.Contains( material.shader ) ) + referenceNode.AddLinkTo( GetReferenceNode( material.shader ), "Shader" ); + + if( searchMaterialsForTexture ) + { + // Search through all the textures attached to this material + // Credit: http://answers.unity3d.com/answers/1116025/view.html + Shader shader = material.shader; + int shaderPropertyCount = ShaderUtil.GetPropertyCount( shader ); + for( int k = 0; k < shaderPropertyCount; k++ ) { - string propertyName = ShaderUtil.GetPropertyName( shader, k ); - if( material.GetTexture( propertyName ) == assetToSearch ) + if( ShaderUtil.GetPropertyType( shader, k ) == ShaderUtil.ShaderPropertyType.TexEnv ) { - additionalInfo = "Shader property: " + propertyName; - return true; + string propertyName = ShaderUtil.GetPropertyName( shader, k ); + Texture assignedTexture = material.GetTexture( propertyName ); + if( assetsSet.Contains( assignedTexture ) ) + referenceNode.AddLinkTo( GetReferenceNode( assignedTexture ), "Shader property: " + propertyName ); } } } + + return referenceNode; } - return false; - } - - // Check if asset is used in this animation clip (and its keyframes) - private bool CheckAnimationForAsset( AnimationClip clip, out string additionalInfo ) - { - additionalInfo = null; - - // If this AnimationClip is already searched, return the cached result - AnimationClipSearchResult result; - if( !searchedAnimationClips.TryGetValue( clip, out result ) ) + // Check if the asset is used in this animator controller + private ReferenceNode SearchAnimatorController( RuntimeAnimatorController controller ) { - if( clip == assetToSearch ) - { - searchedAnimationClips.Add( clip, new AnimationClipSearchResult( true ) ); - return true; - } + ReferenceNode referenceNode = PopReferenceNode( controller ); - // Don't search for animation clip references inside an animation clip's keyframes! - if( assetType == AssetType.Animation ) - { - searchedAnimationClips.Add( clip, new AnimationClipSearchResult( false ) ); - return false; - } + AnimationClip[] animClips = controller.animationClips; + for( int j = 0; j < animClips.Length; j++ ) + referenceNode.AddLinkTo( SearchObject( animClips[j] ) ); + + return referenceNode; + } + + // Check if the asset is used in this animation clip (and its keyframes) + private ReferenceNode SearchAnimationClip( AnimationClip clip ) + { + ReferenceNode referenceNode = PopReferenceNode( clip ); // Get all curves from animation clip EditorCurveBinding[] objectCurves = AnimationUtility.GetObjectReferenceCurveBindings( clip ); @@ -1163,53 +1518,38 @@ public class AssetUsageDetector : EditorWindow { // Search through all the keyframes in this curve ObjectReferenceKeyframe[] keyframes = AnimationUtility.GetObjectReferenceCurve( clip, objectCurves[i] ); - Object objectAtKeyframe; for( int j = 0; j < keyframes.Length; j++ ) - { - objectAtKeyframe = keyframes[j].value; - if( CheckObjectForAsset( objectAtKeyframe ) ) - { - additionalInfo = "Keyframe: " + keyframes[j].time; - searchedAnimationClips.Add( clip, new AnimationClipSearchResult( true, additionalInfo ) ); - return true; - } - } + referenceNode.AddLinkTo( SearchObject( keyframes[j].value ), "Keyframe: " + keyframes[j].time ); } - searchedAnimationClips.Add( clip, new AnimationClipSearchResult( false ) ); - return false; + return referenceNode; } - additionalInfo = result.additionalInfo; - return result.isFound; - } - - private bool CheckObjectForAsset( Object obj ) - { - if( obj == null ) - return false; - - if( assetType == AssetType.MultipleSprite ) + // Search through field and properties of an object for references + private void SearchFieldsAndPropertiesOf( ReferenceNode referenceNode ) { - for( int i = 0; i < assetToSearchMultipleSprite.Count; i++ ) + // Get filtered variables for this object + VariableGetterHolder[] variables = GetFilteredVariablesForType( referenceNode.nodeObject.GetType() ); + for( int i = 0; i < variables.Length; i++ ) { - if( obj == assetToSearchMultipleSprite[i] ) - return true; - } - } - else - { - if( obj == assetToSearch ) - return true; - else if( obj is Component && assetType == AssetType.GameObject ) - { - // If Object is a component, and selected asset is a GameObject, - // check if it is a component of the selected asset + // When possible, don't search non-serializable variables + if( searchSerializableVariablesOnly && !variables[i].isSerializable ) + continue; + try { - if( ( (Component) obj ).gameObject == assetToSearch ) + object variableValue = variables[i].Get( referenceNode.nodeObject ); + if( variableValue == null ) + continue; + + if( !( variableValue is IEnumerable ) || variableValue is Transform ) + referenceNode.AddLinkTo( SearchObject( variableValue ), ( variables[i].isProperty ? "Property: " : "Variable: " ) + variables[i].name ); + else { - return true; + // If the field is IEnumerable (possibly an array or collection), search through members of it + // Note that Transform IEnumerable (children of the transform) is not iterated + foreach( object arrayItem in (IEnumerable) variableValue ) + referenceNode.AddLinkTo( SearchObject( arrayItem ), ( variables[i].isProperty ? "Property (IEnumerable): " : "Variable (IEnumerable): " ) + variables[i].name ); } } catch( UnassignedReferenceException ) @@ -1219,107 +1559,328 @@ public class AssetUsageDetector : EditorWindow } } - return false; - } - - // Check if this variable is a refence to the asset - private bool CheckVariableValueForAsset( object variableValue ) - { - if( variableValue == null || !( variableValue is Object ) ) - return false; - - return CheckObjectForAsset( (Object) variableValue ); - } - - // Check if all open scenes are saved (not dirty) - private bool AreScenesSaved() - { - for( int i = 0; i < EditorSceneManager.loadedSceneCount; i++ ) + // Get filtered variables for a type + private VariableGetterHolder[] GetFilteredVariablesForType( Type type ) { - Scene scene = EditorSceneManager.GetSceneAt( i ); - if( scene.isDirty || scene.path == null || scene.path.Length == 0 ) - return false; - } + VariableGetterHolder[] result; + if( typeToVariables.TryGetValue( type, out result ) ) + return result; - return true; - } + // This is the first time this type of object is seen, filter and cache its variables + // Variable filtering process: + // 1- skip Obsolete variables + // 2- skip primitive types, enums and strings + // 3- skip common Unity types that can't hold any references (e.g. Vector3, Rect, Color, Quaternion) - // Check if "child" is a subclass of "parent" (or if their types match) - private bool IsTypeDerivedFrom( System.Type child, System.Type parent ) - { - if( child.IsSubclassOf( parent ) || child == parent ) - return true; + validVariables.Clear(); - return false; - } - - // Get the GameObject's listed under the DontDestroyOnLoad scene runtime - private List GetDontDestroyOnLoadObjects() - { - List result = new List(); - - List rootGameObjectsExceptDontDestroyOnLoad = new List(); - for( int i = 0; i < SceneManager.sceneCount; i++ ) - { - rootGameObjectsExceptDontDestroyOnLoad.AddRange( SceneManager.GetSceneAt( i ).GetRootGameObjects() ); - } - - List rootGameObjects = new List(); - Transform[] allTransforms = Resources.FindObjectsOfTypeAll(); - for( int i = 0; i < allTransforms.Length; i++ ) - { - Transform root = allTransforms[i].root; - if( root.hideFlags == HideFlags.None && !rootGameObjects.Contains( root.gameObject ) ) + // Filter the fields + if( fieldModifiers != BindingFlags.Instance ) { - rootGameObjects.Add( root.gameObject ); - } - } - - for( int i = 0; i < rootGameObjects.Count; i++ ) - { - if( !rootGameObjectsExceptDontDestroyOnLoad.Contains( rootGameObjects[i] ) ) - result.Add( rootGameObjects[i] ); - } - - return result; - } - - // Close the scenes that were not part of the initial scene setup - private void RestoreInitialSceneSetup() - { - if( EditorApplication.isPlaying || sceneInitialSetup == null ) - return; - - SceneSetup[] sceneFinalSetup = EditorSceneManager.GetSceneManagerSetup(); - for( int i = 0; i < sceneFinalSetup.Length; i++ ) - { - bool sceneIsOneOfInitials = false; - for( int j = 0; j < sceneInitialSetup.Length; j++ ) - { - if( sceneFinalSetup[i].path == sceneInitialSetup[j].path ) + FieldInfo[] fields = type.GetFields( fieldModifiers ); + for( int i = 0; i < fields.Length; i++ ) { - sceneIsOneOfInitials = true; - break; + // Skip obsolete fields + if( Attribute.IsDefined( fields[i], typeof( ObsoleteAttribute ) ) ) + continue; + + // Skip primitive types + Type fieldType = fields[i].FieldType; + if( fieldType.IsPrimitive || fieldType == typeof( string ) || fieldType.IsEnum ) + continue; + + if( experimentalMethod ) + { + if( !IsTypeSearchable( fieldType ) ) + continue; + } + else if( fieldType.IsPrimitiveUnityType() ) + continue; + + VariableGetVal getter = fields[i].CreateGetter( type ); + if( getter != null ) + validVariables.Add( new VariableGetterHolder( fields[i], getter, fields[i].IsSerializable() ) ); } } - if( !sceneIsOneOfInitials ) + if( propertyModifiers != BindingFlags.Instance ) { - EditorSceneManager.CloseScene( EditorSceneManager.GetSceneByPath( sceneFinalSetup[i].path ), true ); + PropertyInfo[] properties = type.GetProperties( propertyModifiers ); + for( int i = 0; i < properties.Length; i++ ) + { + // Skip obsolete properties + if( Attribute.IsDefined( properties[i], typeof( ObsoleteAttribute ) ) ) + continue; + + // Skip primitive types + Type propertyType = properties[i].PropertyType; + if( propertyType.IsPrimitive || propertyType == typeof( string ) || propertyType.IsEnum ) + continue; + + if( experimentalMethod ) + { + if( !IsTypeSearchable( propertyType ) ) + continue; + } + else if( propertyType.IsPrimitiveUnityType() ) + continue; + + // Additional filtering for properties: + // 1- Ignore "gameObject", "transform", "rectTransform" and "attachedRigidbody" properties of Component's to get more useful results + // 2- Ignore "canvasRenderer" and "canvas" properties of Graphic components + // 3 & 4- Prevent accessing properties of Unity that instantiate an existing resource (causing leak) + string propertyName = properties[i].Name; + if( type.IsDerivedFrom( typeof( Component ) ) && ( propertyName.Equals( "gameObject" ) || + propertyName.Equals( "transform" ) || propertyName.Equals( "attachedRigidbody" ) || propertyName.Equals( "rectTransform" ) ) ) + continue; + else if( type.IsDerivedFrom( typeof( UnityEngine.UI.Graphic ) ) && + ( propertyName.Equals( "canvasRenderer" ) || propertyName.Equals( "canvas" ) ) ) + continue; + else if( propertyName.Equals( "mesh" ) && type.IsDerivedFrom( typeof( MeshFilter ) ) ) + continue; + else if( ( propertyName.Equals( "material" ) || propertyName.Equals( "materials" ) ) && + ( type.IsDerivedFrom( typeof( Renderer ) ) || type.IsDerivedFrom( typeof( Collider ) ) || + type.IsDerivedFrom( typeof( Collider2D ) ) || type.IsDerivedFrom( typeof( GUIText ) ) ) ) + continue; + else + { + VariableGetVal getter = properties[i].CreateGetter(); + if( getter != null ) + validVariables.Add( new VariableGetterHolder( properties[i], getter, properties[i].IsSerializable() ) ); + } + } } + + result = validVariables.ToArray(); + + // Cache the filtered fields + typeToVariables.Add( type, result ); + + return result; } - for( int i = 0; i < sceneInitialSetup.Length; i++ ) + // Check if this type can possibly contain references to the searched asset(s) + private bool IsTypeSearchable( Type type, int depth = 0 ) { - if( !sceneInitialSetup[i].isLoaded ) - EditorSceneManager.CloseScene( EditorSceneManager.GetSceneByPath( sceneInitialSetup[i].path ), false ); + if( type.IsPrimitive || type == typeof( string ) ) + return false; + + if( searchedTypesStack.Contains( type ) ) + return false; + + bool result; + if( searchableTypes.TryGetValue( type, out result ) ) + return result; + + if( type == typeof( GameObject ) || type == typeof( AnimationClip ) || type == typeof( Animation ) || + type == typeof( Animator ) || type.IsDerivedFrom( typeof( RuntimeAnimatorController ) ) || + ( ( searchMaterialsForShader || searchMaterialsForTexture ) && type.IsDerivedFrom( typeof( Material ) ) ) || + ( searchRenderers && type.IsDerivedFrom( typeof( Renderer ) ) ) ) + { + searchableTypes.Add( type, true ); + return true; + } + + for( int i = 0; i < assetClasses.Length; i++ ) + { + if( assetClasses[i].IsDerivedFrom( type ) ) + { + searchableTypes.Add( type, true ); + return true; + } + } + + if( type.IsArray ) + { + if( IsTypeSearchable( type.GetElementType(), depth ) ) + { + searchableTypes.Add( type, true ); + return true; + } + } + + if( type.IsGenericType ) + { + Type[] generics = type.GetGenericArguments(); + for( int i = 0; i < generics.Length; i++ ) + { + if( IsTypeSearchable( generics[i], depth ) ) + { + searchableTypes.Add( type, true ); + return true; + } + } + } + + if( depth < searchDepthLimit ) + { + try + { + searchedTypesStack.Push( type ); + + HashSet searchedVariableTypes = new HashSet(); + FieldInfo[] fields = type.GetFields( fieldModifiers ); + for( int i = 0; i < fields.Length; i++ ) + { + Type fieldType = fields[i].FieldType; + if( searchedVariableTypes.Contains( fieldType ) ) + continue; + + searchedVariableTypes.Add( fieldType ); + if( IsTypeSearchable( fieldType, depth + 1 ) ) + { + searchableTypes.Add( type, true ); + return true; + } + } + + PropertyInfo[] properties = type.GetProperties( propertyModifiers ); + for( int i = 0; i < properties.Length; i++ ) + { + Type propertyType = properties[i].PropertyType; + if( searchedVariableTypes.Contains( propertyType ) ) + continue; + + if( properties[i].GetIndexParameters().Length == 0 && properties[i].GetGetMethod( ( propertyModifiers & BindingFlags.NonPublic ) == BindingFlags.NonPublic ) != null ) + { + searchedVariableTypes.Add( propertyType ); + if( IsTypeSearchable( properties[i].PropertyType, depth + 1 ) ) + { + searchableTypes.Add( type, true ); + return true; + } + } + } + } + finally + { + searchedTypesStack.Pop(); + } + } + + if( depth == 0 ) + searchableTypes.Add( type, false ); + + return false; + } + + // Get reference node for object + private ReferenceNode GetReferenceNode( object nodeObject, string hash = null ) + { + if( hash == null ) + hash = nodeObject.Hash(); + + ReferenceNode result; + if( !searchedObjects.TryGetValue( hash, out result ) || result == null ) + { + result = PopReferenceNode( nodeObject ); + searchedObjects[hash] = result; + } + + return result; + } + + // Fetch a reference node from pool + private ReferenceNode PopReferenceNode( object nodeObject ) + { + if( nodesPool.Count == 0 ) + { + for( int i = 0; i < 32; i++ ) + nodesPool.Add( new ReferenceNode() ); + } + + int index = nodesPool.Count - 1; + ReferenceNode node = nodesPool[index]; + node.nodeObject = nodeObject; + nodesPool.RemoveAt( index ); + + return node; + } + + // Pool a reference node + private void PoolReferenceNode( ReferenceNode node ) + { + node.Clear(); + nodesPool.Add( node ); + } + + // Retrieve the game objects listed under the DontDestroyOnLoad scene + private List GetDontDestroyOnLoadObjects() + { + List result = new List(); + + List rootGameObjectsExceptDontDestroyOnLoad = new List(); + for( int i = 0; i < SceneManager.sceneCount; i++ ) + { + rootGameObjectsExceptDontDestroyOnLoad.AddRange( SceneManager.GetSceneAt( i ).GetRootGameObjects() ); + } + + List rootGameObjects = new List(); + Transform[] allTransforms = Resources.FindObjectsOfTypeAll(); + for( int i = 0; i < allTransforms.Length; i++ ) + { + Transform root = allTransforms[i].root; + if( root.hideFlags == HideFlags.None && !rootGameObjects.Contains( root.gameObject ) ) + { + rootGameObjects.Add( root.gameObject ); + } + } + + for( int i = 0; i < rootGameObjects.Count; i++ ) + { + if( !rootGameObjectsExceptDontDestroyOnLoad.Contains( rootGameObjects[i] ) ) + result.Add( rootGameObjects[i] ); + } + + return result; + } + + // Check if all open scenes are saved (not dirty) + private bool AreScenesSaved() + { + for( int i = 0; i < EditorSceneManager.loadedSceneCount; i++ ) + { + Scene scene = EditorSceneManager.GetSceneAt( i ); + if( scene.isDirty || scene.path == null || scene.path.Length == 0 ) + return false; + } + + return true; + } + + // Close the scenes that were not part of the initial scene setup + private bool RestoreInitialSceneSetup() + { + if( EditorApplication.isPlaying || initialSceneSetup == null ) + return true; + + if( !EditorSceneManager.SaveCurrentModifiedScenesIfUserWantsTo() ) + return false; + + SceneSetup[] sceneFinalSetup = EditorSceneManager.GetSceneManagerSetup(); + for( int i = 0; i < sceneFinalSetup.Length; i++ ) + { + bool sceneIsOneOfInitials = false; + for( int j = 0; j < initialSceneSetup.Length; j++ ) + { + if( sceneFinalSetup[i].path == initialSceneSetup[j].path ) + { + sceneIsOneOfInitials = true; + break; + } + } + + if( !sceneIsOneOfInitials ) + EditorSceneManager.CloseScene( EditorSceneManager.GetSceneByPath( sceneFinalSetup[i].path ), true ); + } + + for( int i = 0; i < initialSceneSetup.Length; i++ ) + { + if( !initialSceneSetup[i].isLoaded ) + EditorSceneManager.CloseScene( EditorSceneManager.GetSceneByPath( initialSceneSetup[i].path ), false ); + } + + return true; } } - - // Restore the initial scene setup when the window is closed - void OnDestroy() - { - if( restoreInitialSceneSetup ) - RestoreInitialSceneSetup(); - } -} +} \ No newline at end of file diff --git a/img1.png b/img1.png new file mode 100644 index 0000000000000000000000000000000000000000..fe669d3501e2527cd4c4d391dc5ceba41f1f191d GIT binary patch literal 18901 zcmbt+1yt4Rw(l|!K?MW>LFtn2?v_sJkX|&>h=fYFGzfxpcStJ+-5}C}goL1U^Cr6Y zKKI^p&l_)yx5wDq*lYdsn{)o^BUo8c`UW~7Is$>XA#-0s6@j?W2>-@ky$F93w($B3 z{6gR?spYI@Z|>}7RM&FWQjq5}vA1P1 zI{yrlyR8F!8-WlIc6Tr`u{LuiH8!)bv=b!XXlNlPwKNqZ*W^@SQE(79Lt5T{>}aO; zSW(^Nv9$@WDY>u^sen5l9KhDh*@)EL*2d0>&s~uG_i_2)_ve4jOiudyBhJ=>#+U}ojzSj0ag*NDw6rs|cXOis{T&4bJ{dbFXCpfkGZ_g% zaySZ;rKKq!kAx^MyOWBbRNZ}iEfrPk*64Vf z8*Uu62E#ohR;e+Xv1G;896>^950!DS@1#qW5CsY1t&JkXjO|r2sHH?RCD4Md z626eQp%UwNjZm_4{bJW%1x->Ie`OaF`OcZ==U?4p?72O?KGSaI?$U&Kc+?jVi1a(v zEGSTs1D6p9!TU-|%&e#xXb8l|`T6+|pFW))u9oUyWYY$2`upEtF+}*T^c?Q29u!tu z^l8vPG&kR!_S`7et~8%-fARVA=d8qBrLygdwzn%@N@1r~%F43R( z@WF3Uoi5Ip3y~Lcn}EQQ`R!$gj%X?}GP10fS&6Z|y}fw2QqS=ib$EDqh6^4P=H&%B zKaEc`#z@9Wu1-u$6h7V06n%ar5erdpuPcGsBG~^LzSW?DY6q=a&XZps@vDZj5wy{A%NXX}XyuaA9S@Y0l!TqX_YY>vIXO9XaARU%ykaqWmS-m`<9p+} z1ONR@WVA8fty^nT4WomD*fkCrrf=Q1)dv~M%A8mg67`0LQtl;5~c$ZfYaKhNQ` z*uDE>!kSizm`?)7*Xp|E!%V60)8j3r-rQS@$KPH#Ddvrbr@!R3Pfki2SP8$wz4qgW zVT&%MVEw!`oyHZZ(J{k>;%OAntdPmBvUo< zy-Mivtr)uIhp7S{j@#b{;3OHB69|Zjr*oA^1{0Qta;-Z(cGt#+^VRrW*Y3yLK6xTw zai><}^|#x8BiI-i81_v&8l?tJZP1?b5_Mu>2)jjZKV27%*I2c+rn9qi zu3{?30)u|N^Zw6SG&D3=EN2IOKKGUeGNp$HDR4VAXDM}UA80W?`Y~R8w6~$=?cl)D z_4=|$kLfl0FJ(`AuP5`RHx2ll9nFlE8ZOz>Ghia}c0ZX1^RBG(I!TUIN>eJC`d1?d zo(*bfXjF~2`1r`eL#hm1Y-()$vfG-n(Q@{RLDa{`CwQg)^?K@}4u0`&?Toi>gX@o; zm)z`ZY^H1kqo1?o659RjMoWk^m1z0iR(I7<1roK8A$;E;9Y@#Nvy3CD*k+E~NPH;k z=Ji}$)xN`0nDN@1I@nrjIo|9lZ8_E92($_c4YeN33QpDu?c^eO>vMWQ!~Q%?$ji#k zt~Ug&FqP*KIodt#2z94G3?eO7)xPm+>q5@g`InM=$!5HdY~hpp69u-duR1Rx)a~!v zN^E&OdGdi#!Hzbei-Mfo*u>-|m#r*sQc@BV6BDJ<&dSI{xk=l6M-0E)`r7R5yUuG) zP}#K>eXpRL`l(;Peoe1glGPp0s5@QnQV8qRs_AudUn)Ph`_G56(o#}SN%oulh-p*+3=jJ1P zt*+D+!`oz-D%R!p^z`I>G>o*Ab>H(zbkJ*bFIUS|G|ex6Alpx82DK_cMdg3&OhJ*E zo=&=3%o2$G?%liRS8iBMzG0=s@6xMxUe1z>iZ;ZlDo>Y_KQ0-H z=i%w8_RKVPb!F~j=*jUhm(3RuFLo}j&x02@+fQh4s*TPcbSi+qay=r==NYqbgajirD=l>y1{;QAwx6l3ihYPT;BtElxzdqH#iiSX1Y|eLJ zDg4CuI@-0JZmi4Cr_H&DAR8MSTV7r+<9J8UVLLtyty{Or^~X3YSnHGU%1Wn==_XdW zbaP`Q^6J24W6$BQrCxmY(~WJBBwH=Aii$PW)%uO@zh173kCy1$&omcrXd=|nIHs>A zr)S8IJ2*PFN+htu3{jMmE2R3ml;(4~J*0Gi{plXg>-oXMPGfiXH?_5HeXj)1`_}Rx z)tZnpnO@Ulm%%KVEX}H{D(`r6Rn_SHd`lITn^b%*D}G}|I%^ZP8_=ns-{PI@o}L^* z=O7e(%#mwnMxI>yes9L7#k2$4+Ip2n=~aLJVIYb3TgA%@rHN2Gj7hhk_#=r050AI{ zXtz?`rUym_!-9ewTwRITOs`VC>27bokBJ$1lS1k;Dk`+XUvnQbBtru*NfZO#r}De; zun)r+FQcB}A$g`-9(pT0qg2H#1IcHYMfmq3!kCEWTV}!NIe&lER$|FS*LM18&^0v9ZZBi6jxW zo2X&jCB5hK9ra)~kR;kzH90=kygok$Nf#%}w}q)8+KgRXaSS7l_!*bt^94Lq#UMKnz6ScbXMy6l;k&i;usYr!Z`EADEu@9w~Uh z;53}4vNkERbf24>J6?vybbNHFFKy#XIfX^}w8p#ApOt+=)VsS?z5A<8S87LM=#>h{l%Q$ua1@~rSJ@V z_+SdFAjN2Zy^s7iecD# zY2Qqywilx$G@HP{z(Cny(CE&3vRj5Kda(6b*ZzfOFWRkaT4~LJMu%B3F|mtIc^wYv z58{+C&*@7@oqn_^W0m9&U6rRkal)#@ukeDCz4fvPcQ{mh6}HiCTM-x(+z=g7AP0@gYDW zWXD1j65}?@!^7?6Ni_vVovMeLR}4daefH~+ zNbcW+b(&INj{5azXEh-vMtqlI4{PxFU<;p7XL}*R5c*GCidl(RH2bAXmkw_@@WRS- ze)NcyjcqO~s^;W-W@P)w*O{Xn`2rdajw(Qk^P5fwQw?t10KclO6G}^&o$P{&b!#i^ zf05GU-J2Swj4kC+`t|D<^t!}SE5tz~)H1b)ap6*LD!<1jW$NIYi_lGSww7QS>=YmD z|M~{g`kF=BMP*!Q0VurUH8nM*YG|ozzwkvz;sHy=uqMXGOEq(OEEpIV;NjsVufMbw z%~xL^s|;-Ta#7?4YKHa{sYPRYy05P7aNfY`s=m7VEowY<+iZ3gQaPLqwBdsXD2o>m zTFL3A23y8A5F+?kbwvMa?7rwran{KM1O&ms!5$tS8Ir5R`I*Z1_I>bR3~=gj$guKn zJK7Cb5M_r_N~#9OLVE~)u$3dFFR-`0tVTkTHfl4{(IL}TMpU1`u$9x5COgQjU;pUm z*LSc^81?I84TYGP>^_Fz!V`glXMTSQ{SNaESNFSj7Xs0p{et%jB=Q5UX*N(7TP?%Sd-OvlD4s~)ezK7#OIu+6Q;$aN1ao#C=x)K z$`9pV8h-}wfLQQxtcR1ixj781Ca4K>Vs)tj^?CeG+_g;8uA-up8*(}H^A&CZ^=`1z zBnquyjF_}VxHvg|6MMg~xLBg!5bsE>^y[{LwRH1E@6kB1M_Lqod&-qzXsv(AoS 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 JK!kw+06U1&z-j;h literal 0 HcmV?d00001