# XWUIGameLoadingScreen

A full-screen loading overlay with a progress bar, percentage readout, rotating gameplay tips, and optional background artwork. Drive it imperatively with `setProgress(0-100)` (the fill and percentage update live, and a `complete` event fires when it reaches 100), `setLabel()`, and `setTip()`. Seed it with `data.label`, `data.progress`, `data.artUrl`, and either a single `data.tip` or a `data.tips` array that cycles every `conf_comp.tipInterval` ms. Hide the percentage with `conf_comp.showPercentage: false` and set the backdrop with `conf_comp.bgColor`; `onComplete` and `getProgress()` round out the API.

## Basic Usage

Shows the loading bar, label, and rotating tips, then signals complete once progress hits 100.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Full-screen loader with a live progress bar, percentage, and cycling gameplay tips.
```

## Driven Progress

A simulated streaming load that pushes the bar with setProgress() and updates phase text with setLabel(), firing onComplete at 100 percent.

```example
file: examples/DrivenProgress.ts
html: examples/BasicUsage.html
title: Driven Progress
description: A simulated streaming load that pushes the bar with setProgress() and updates phase text with setLabel(), firing onComplete at 100 percent.
```

## Art Backdrop

A cinematic loader layered over full-screen key art with the percentage hidden for a clean frame.

```example
file: examples/ArtBackdrop.ts
html: examples/BasicUsage.html
title: Art Backdrop
description: A cinematic loader layered over full-screen key art with the percentage hidden for a clean frame.
```

```api
```