composeScene function

SceneDocument composeScene(
  1. SceneDocument document, {
  2. required PrefabResolver resolve,
  3. Map<LocalId, PrefabMemberOrigin>? memberOrigins,
})

Expands every prefab instance in document, returning a new document with no instance nodes. A document with no instances is returned unchanged.

resolve loads a referenced prefab document. A cyclic reference (a prefab that instantiates itself, directly or transitively) is broken with a warning rather than recursing forever.

When memberOrigins is given, it is filled with one entry per composed node that came from an instance (keyed by composed id), so a caller can map composed content back to the instance and prefab-local id it edits.

Implementation

SceneDocument composeScene(
  SceneDocument document, {
  required PrefabResolver resolve,
  Map<LocalId, PrefabMemberOrigin>? memberOrigins,
}) => _compose(document, resolve, <String>{}, memberOrigins);