Transitions & Scene Loading

Loading Data will restart your scene. Without any visuals like a Loading Screen, your players will immediately notice when Loading happens. Because of that, OmniSave exposes a way to load scenes & data with custom transitions, including a Fade Example.

Scene Load with Fade

// Saves -> Fades out -> Loads scene -> Restores data -> Fades in
await SaveManager.LoadSceneWithFade("Level2");

// Custom fade duration
await SaveManager.LoadSceneWithFade("Boss", duration: 1.0f);

Load Game with Fade

// Load save slot with smooth transition
await SaveManager.LoadWithFade(slot: 1, duration: 0.5f);

Custom Transitions

Implement ILoadTransition for full control:

public class MyCustomTransition : ILoadTransition
{
    public async Task PlayInAsync()
    {
        // Show your custom loading transition
        await Task.Delay(500);
    }
    
    public async Task PlayOutAsync()
    {
        // Hide your custom loading transition
        await Task.Delay(500);
    }
}

Here´s how you then use it:

var transition = new MyCustomTransition();
await SaveManager.LoadWithTransition(slot: 1, transition);

Showcase Fade Modes

// Fade out, load, fade in (default)
await SaveManager.LoadWithFade(1, mode: FadeMode.FadeInOut);

// Only fade out
await SaveManager.LoadWithFade(1, mode: FadeMode.FadeOutOnly);

// Only fade in
await SaveManager.LoadWithFade(1, mode: FadeMode.FadeInOnly);