Luna UI Documentation

LoadingView is a thin overlay that fades in/out while a scene loads. It's driven by the SceneTransitionManager, which holds a dictionary of named SceneTransition strategies — pluggable so you can add fade, slide, circle-hole, or fully custom variants without touching the loader.

Setup

The loading view wires up automatically when you load scenes through SceneLoader / SceneLoaderAddressable and pass a transition by name. See the GameFull sample for a full example.

csharp

SceneLoader.Instance.LoadScene(
    sceneIndex: 2,
    transition: SceneTransitionManager.Instance.Transitions.GetValue("Fade")
);

SceneTransitionManager

A dictionary of named SceneTransition strategies. Used by SceneLoader and SceneLoaderAddressable (and you can use it directly).

Loading Transition

SceneTransition

Abstract base — implement to add a custom transition to the manager.

csharp

public class SceneLoadTransitionFade : SceneTransition
{
    public float _fadeInDuration  = 0.5f;
    public float _fadeOutDuration = 1f;     // longer because scene-load lag

    public override float GetStartDelay()
        => _fadeInDuration + 0.2f;          // ensure fade completes before scene load starts

    public override void FadeIn()
        => SceneTransition.LoadingScreenToggleEvent?.Invoke(true,  _fadeInDuration);

    public override void FadeOut()
        => SceneTransition.LoadingScreenToggleEvent?.Invoke(false, _fadeOutDuration);
}

Methods to implement

Method	Description
`GetStartDelay()`	Seconds to wait between `FadeIn()` and the scene-load actually starting.
`FadeIn()`	Show the loading overlay.
`FadeOut()`	Hide the loading overlay.

Events

csharp

public static event Action<bool, float> LoadingScreenToggleEvent;

Parameter	Type	Description
1	bool	`true` for fade-in, `false` for fade-out.
2	float	Duration of the fade.

Loading

Setup

SceneTransitionManager

SceneTransition

Methods to implement

Events

See also