Struct LoadingOverlay 

pub struct LoadingOverlay {
    pub screen: Option<AssetId>,
    pub backdrop: Option<AssetId>,
    pub track: Option<AssetId>,
    pub fill: Option<AssetId>,
    pub label: Option<AssetId>,
}

Requests the scene-loading overlay: a full-window backdrop with a progress bar, shown while a scene jump waits for its streamed content and faded out once the destination scene is fully resident.

The overlay is assembled from ordinary UI elements the fields reference: a Screen that hosts them, a backdrop Sprite covering the canvas, a progress-bar track and fill Sprite pair, and a TextLabel above the bar. Each frame the engine widens the fill to the destination scene’s load progress and rewrites the label with the percentage; restyle any piece by declaring it yourself under the same name.

While the overlay’s screen is up the world pauses and its render is skipped, exactly like an opaque menu, but streaming keeps running so the load it reports can finish. Scenes whose content is already resident jump without the overlay ever appearing.

Every rendering world that declares Scenes and a StreamingConfig receives a LoadingOverlay and its pieces at build time when it declares none, so the example below is only needed to restyle them. Declare an EngineDefaults with "loading_overlay": false to remove it from the build entirely.

Fields

screen: Option<AssetId>

Screen the overlay shows while a scene loads. Its pauses_world (on by default) freezes the world beneath the overlay so the destination scene starts fresh when revealed.

backdrop: Option<AssetId>

Backdrop Sprite covering the canvas. Its tint alpha is animated to reveal the scene once loading completes; an opaque tint hides the still-loading world completely.

track: Option<AssetId>

Progress-bar track Sprite; its width is the bar’s full extent the fill is measured against.

fill: Option<AssetId>

Progress-bar fill Sprite; the engine sets its width to the track width times the destination scene’s load progress each frame.

label: Option<AssetId>

TextLabel rewritten each frame with the load percentage.

Trait Implementations

impl Clone for LoadingOverlay

fn clone(&self) -> LoadingOverlay

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Component for LoadingOverlay

const NAME: &'static str = "LoadingOverlay"

The registry name a world authors this component under.

fn from_baked(bytes: &[u8]) -> Result<Self, CnResult>

Reconstruct this component from a blob record, whose bytes are the serialized runtime component (cook already ran the asset -> component translation). The default rejects: runtime-only components are never stored in a blob, so only loadable types provide an implementation.

fn inject_locator(&mut self, _locator: PayloadLocator)

Called after construction to inject the payload locator from the blob def. Only meaningful for components with a compiled payload. The default implementation does nothing (correct for most components).

fn inject_name(&mut self, _id: AssetId)

Called after construction to inject the asset’s identity from the blob def. Only meaningful for components that look themselves up by id at runtime. The default implementation does nothing.

impl ComponentSlot for LoadingOverlay

const DISCRIMINANT: u8

The component type’s stable id, used as its ComponentId.

fn slot(s: &ComponentStorage) -> &Column<Self>

Borrow this type’s column out of the storage.

fn slot_mut(s: &mut ComponentStorage) -> &mut Column<Self>

Mutably borrow this type’s column out of the storage.

impl Debug for LoadingOverlay

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for LoadingOverlay

fn default() -> LoadingOverlay

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LoadingOverlay

where LoadingOverlay: Default,

fn deserialize<__D>( __deserializer: __D, ) -> Result<LoadingOverlay, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<LoadingOverlay> for ComponentAsset

fn from(c: LoadingOverlay) -> Self

Converts to this type from the input type.

impl RuntimeComponent for LoadingOverlay

impl Serialize for LoadingOverlay

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.