Loads the css from Loader.css
Gets or sets the background color of the loader as a hex string
Data associated with a loadable
Direct access to the game object event dispatcher.
Gets or sets the color of the loading bar, default is Color.White
Positions the top left corner of the loading bar If not set, the loader automatically positions the loading bar
Positions the top left corner of the logo image If not set, the loader automatically positions the logo
Positions the top left corner of the play button. If not set, the loader automatically positions the play button
Get/set play button text
Returns the progress of the loader as a number between [0, 1] inclusive.
Add a resource to the loader to load
Resource to add
Add a list of resources to the loader to load
The list of resources to load
Clean up generated elements for the loader
Loader draw function. Draws the default Excalibur loading screen.
Override logo
, logoWidth
, logoHeight
and backgroundColor
properties
to customize the drawing, or just override entire method.
Emits a new event
Name of the event to emit
Data associated with this event
Returns true if the loader has completely loaded all resources
Begin loading all of the supplied resources, returning a promise that resolves when loading of all is complete AND the user has clicked the "Play button"
Alias for removeEventListener
. If only the eventName is specified
it will remove all handlers registered for that specific event. If the eventName
and the handler instance are specified only that handler will be removed.
Name of the event to listen for
Event handler for the thrown event
Alias for addEventListener
. You can listen for a variety of
events off of the engine; see the events section below for a complete list.
Name of the event to listen for
Event handler for the thrown event
Once listens to an event one time, then unsubscribes from that event
The name of the event to subscribe to once
The handler of the event that will be auto unsubscribed
Shows the play button and returns a promise that resolves when clicked
Return a html button element for excalibur to use as a play button
Pre-loading assets
The loader provides a mechanism to preload multiple resources at one time. The loader must be passed to the engine in order to trigger the loading progress bar.
The Loader itself implements Loadable so you can load loaders.
Example: Pre-loading resources for a game
Customize the Loader
The loader can be customized to show different, text, logo, background color, and button.