Class SceneRegistry

Container for storing and loading of scenes. An instance of the registry is created on the AppBase object as AppBase#scenes.

Index

Constructors

constructor

Methods

add changeScene find findByUrl list loadScene loadSceneData loadSceneHierarchy loadSceneSettings remove unloadSceneData

Constructors

constructor

new SceneRegistry(app): SceneRegistry
Create a new SceneRegistry instance.
Parameters
- app: AppBase
  The application.
Returns SceneRegistry
- Defined in submodules/engine/src/framework/scene-registry.js:77

Methods

add

add(name, url): boolean
Add a new item to the scene registry.
Parameters
- name: string
  The name of the scene.
- url: string
  The url of the scene file.
Returns boolean
Returns true if the scene was successfully added to the registry, false otherwise.
- Defined in submodules/engine/src/framework/scene-registry.js:102

changeScene

changeScene(sceneItem, callback?): void
Change to a new scene. Calling this function will load the scene data, delete all entities and graph nodes under app.root and load the scene settings and hierarchy.
Parameters
- sceneItem: string | SceneRegistryItem
  The scene item (which can be found with SceneRegistry#find, URL of the scene file (e.g."scene_id.json") or name of the scene.
- Optionalcallback: ChangeSceneCallback
  The function to call after loading, passed (err, entity) where err is null if no errors occurred.
Returns void
Example
```
app.scenes.changeScene("Scene Name", function (err, entity) {
    if (!err) {
        // success
    } else {
        // error
    }
});
```
- Defined in submodules/engine/src/framework/scene-registry.js:400

find

find(name): SceneRegistryItem
Find a Scene by name and return the SceneRegistryItem.
Parameters
- name: string
  The name of the scene.
Returns SceneRegistryItem
The stored data about a scene or null if no scene with that name exists.
- Defined in submodules/engine/src/framework/scene-registry.js:124

findByUrl

findByUrl(url): SceneRegistryItem
Find a scene by the URL and return the SceneRegistryItem.
Parameters
- url: string
  The URL to search by.
Returns SceneRegistryItem
The stored data about a scene or null if no scene with that URL exists.
- Defined in submodules/engine/src/framework/scene-registry.js:139

list

list(): SceneRegistryItem[]
Return the list of scene.

Returns SceneRegistryItem[]
All items in the registry.
- Defined in submodules/engine/src/framework/scene-registry.js:91

loadScene

loadScene(url, callback): void
Load the scene hierarchy and scene settings. This is an internal method used by the AppBase.
Parameters
- url: string
  The URL of the scene file.
- callback: LoadSceneCallback
  The function called after the settings are applied. Passed (err, scene) where err is null if no error occurred and scene is the Scene.
Returns void
- Defined in submodules/engine/src/framework/scene-registry.js:424

loadSceneData

loadSceneData(sceneItem, callback): void
Loads and stores the scene data to reduce the number of the network requests when the same scenes are loaded multiple times. Can also be used to load data before calling SceneRegistry#loadSceneHierarchy and SceneRegistry#loadSceneSettings to make scene loading quicker for the user.
Parameters
- sceneItem: string | SceneRegistryItem
  The scene item (which can be found with SceneRegistry#find, URL of the scene file (e.g."scene_id.json") or name of the scene.
- callback: LoadSceneDataCallback
  The function to call after loading, passed (err, sceneItem) where err is null if no errors occurred.
Returns void
Example
```
const sceneItem = app.scenes.find("Scene Name");
app.scenes.loadSceneData(sceneItem, function (err, sceneItem) {
    if (err) {
        // error
    }
});
```
- Defined in submodules/engine/src/framework/scene-registry.js:261

loadSceneHierarchy

loadSceneHierarchy(sceneItem, callback): void
Load a scene file, create and initialize the Entity hierarchy and add the hierarchy to the application root Entity.
Parameters
- sceneItem: string | SceneRegistryItem
  The scene item (which can be found with SceneRegistry#find, URL of the scene file (e.g."scene_id.json") or name of the scene.
- callback: LoadHierarchyCallback
  The function to call after loading, passed (err, entity) where err is null if no errors occurred.
Returns void
Example
```
const sceneItem = app.scenes.find("Scene Name");
app.scenes.loadSceneHierarchy(sceneItem, function (err, entity) {
    if (!err) {
        const e = app.root.find("My New Entity");
    } else {
        // error
    }
});
```
- Defined in submodules/engine/src/framework/scene-registry.js:347

loadSceneSettings

loadSceneSettings(sceneItem, callback): void
Load a scene file and apply the scene settings to the current scene.
Parameters
- sceneItem: string | SceneRegistryItem
  The scene item (which can be found with SceneRegistry#find, URL of the scene file (e.g."scene_id.json") or name of the scene.
- callback: LoadSettingsCallback
  The function called after the settings are applied. Passed (err) where err is null if no error occurred.
Returns void
Example
```
const sceneItem = app.scenes.find("Scene Name");
app.scenes.loadSceneSettings(sceneItem, function (err) {
    if (!err) {
        // success
    } else {
        // error
    }
});
```
- Defined in submodules/engine/src/framework/scene-registry.js:368

remove

remove(name): void
Remove an item from the scene registry.
Parameters
- name: string
  The name of the scene.
Returns void
- Defined in submodules/engine/src/framework/scene-registry.js:152

unloadSceneData

unloadSceneData(sceneItem): void
Unloads scene data that has been loaded previously using SceneRegistry#loadSceneData.
Parameters
- sceneItem: string | SceneRegistryItem
  The scene item (which can be found with SceneRegistry#find or URL of the scene file. Usually this will be "scene_id.json".
Returns void
Example
```
const sceneItem = app.scenes.find("Scene Name");
app.scenes.unloadSceneData(sceneItem);
```
- Defined in submodules/engine/src/framework/scene-registry.js:274

Class SceneRegistry

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns SceneRegistry

Methods

add

Parameters

Returns boolean

changeScene

Parameters

Returns void

Example

find

Parameters

Returns SceneRegistryItem

findByUrl

Parameters

Returns SceneRegistryItem

list

Returns SceneRegistryItem[]

loadScene

Parameters

Returns void

loadSceneData

Parameters

Returns void

Example

loadSceneHierarchy

Parameters

Returns void

Example

loadSceneSettings

Parameters

Returns void

Example

remove

Parameters

Returns void

unloadSceneData

Parameters

Returns void

Example

Settings

On This Page