Uninomicon

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== Entities.Scenes ======

==== SerializeUtility ====

SerializeUtility is responsible for writing entire Worlds to disk. It is written specifically for serializing Subscene Sections to disk in the editor, and then for streaming((see SceneSectionStreamingSystem)) them in efficiently during runtime. It can support other use cases, but it is not designed to.

SerializeUtility supports two modes for deserialization:
  * Blocking (''DeserializeWorld'')
  * Async (''BeginDeserializeWorld''/''EndDeserializeWorld'').

But only a blocking mode for serialization (''SerializeWorld''). This is reasonable because it's edit-time functionality, and runs via a background [[scriptedimporter|ScriptedImporter]].(([[scriptedimporter|ScriptedImporters]] run on separate Worker processes due to 2020.1's "Parallel Import" feature.))

==== Baking ====
There are two types of baking:
  - Full Rebakes
  - Incremental Bakes (''EntityDiffer'') ((Incremental bakes rely on a diffing + patching system known as EntityDiffer. This adds EntityGuid components to your entities.

A full rebake is triggered when:
  * A subscene is **opened**.
  * An assembly containing Baker classes is modified.

Incremental bakes are triggered when:
  * Open subscenes are modified.

==== Serialization ====
Subscenes are serialized to the binary format in several spots:
  - When closing an opened, dirty SubScene.
  - After modifying an assembly with bakers, triggering a full rebake.
  - When making a player build((Can be incremental)).

Serialization uses a ''ScriptedImporter'' called ''SubSceneImporter''. This importer is injected into the AssetDatabase directly, rather than using the normal attribute. The subscene unity files (ie. my_subscene.unity) do not get imported by this importer, rather, it operates on an in-memory "asset" representing the baked scene.

SubScene serialization can be debugged by placing breakpoints within SerializeUtility.SerializeWorld, and attaching to the Unity Import Worker process via the Rider "Attach to Unity Process..." dialogue.

==== SceneSectionStreamingSystem ====
==== AsyncLoadSceneOperation ====

These systems stream Sections of entities scenes((subscenes)) into a World. It's intended for use at runtime, but will also be used in the editor when Entity Subscenes are "Closed for Edit" in the Hierarchy.

The AsyncLoadSceneOperation and associated jobs use the Async Mode of SerializeUtility (see above).

Please fill all the letters into the box to prove you're human. H U᠎ V D Q Please keep this field empty:

Edit summary

Uninomicon

User Tools

Site Tools

Page Tools