Method ApplyAll

Source/Editor/Modules/PrefabsModule.cs:243–284

Applies the difference from the prefab object instance, saves the changes and synchronizes them with the active instances of the prefab asset. Applies all the changes from not only the given actor instance but all actors created within that prefab instance. The modified instance.

(Actor instance)

        /// </remarks>
        /// <param name="instance">The modified instance.</param>
        public void ApplyAll(Actor instance)
        {
            // Validate input
            if (!instance)
                throw new ArgumentNullException(nameof(instance));
            if (!instance.HasPrefabLink || instance.PrefabID == Guid.Empty)
                throw new ArgumentException("The modified actor instance has missing prefab link.");

            var prefab = FlaxEngine.Content.LoadAsync<Prefab>(instance.PrefabID);
            if (prefab == null)
                throw new ArgumentException("Missing prefab to apply.");
            PrefabApplying?.Invoke(prefab, instance);

            // When applying changes to prefab from actor in level ignore it's root transformation (see ActorEditor.ProcessDiff)
            Actor prefabRoot = null;
            var originalTransform = instance.LocalTransform;
            var originalName = instance.Name;
            if (instance.HasScene)
            {
                prefabRoot = instance.GetPrefabRoot();
                if (prefabRoot != null && prefabRoot.IsPrefabRoot && instance.HasScene)
                {
                    var defaultInstance = prefab.GetDefaultInstance();
                    originalTransform = prefabRoot.LocalTransform;
                    originalName = prefabRoot.Name;
                    prefabRoot.LocalTransform = defaultInstance.Transform;
                    prefabRoot.Name = defaultInstance.Name;
                }
            }

            // Call backend
            var failed = PrefabManager.Internal_ApplyAll(FlaxEngine.Object.GetUnmanagedPtr(instance));
            if (prefabRoot != null)
            {
                prefabRoot.LocalTransform = originalTransform;
                prefabRoot.Name = originalName;
            }
            if (failed)
                throw new Exception("Failed to apply the prefab. See log to learn more.");

            PrefabApplied?.Invoke(prefab, instance);
        }
    }
}