Struct RealmR1
One entry of the persisted realm catalog (Realms decision D-1): the IDENTITY of a named realm — the fields that decide which cell a position files into — so a later open can rebuild the realm's spatial layer before the application has said anything, and refuse a registration that would re-map every entity of it.
[Component("Typhon.Schema.Realm", 1)]
public struct RealmR1
- Inherited Members
Remarks
Realm 0 is not here. It keeps its single-world record (spatial.GridConfig), so a database that never names a realm is
byte-for-byte what it was. The catalog table is created the first time a realm other than 0 is registered.
Identity only. Policy (WhenUnobserved, divisors) and the grid's tuning knobs decide when things run, never where an entity is filed, so they are the application's to supply at each open — as for the realm-0 record.
Fields
CellSize
Cell edge length.
public double CellSize
Field Value
Generation
Incarnation of the id: 0 the first time an id is registered, and one more than the retired row's each time it is registered again.
public int Generation
Field Value
Remarks
It can only advance across an OPEN, and that is RLM-06 rather than an omission. An id unregistered during a session is not registrable again in
that session at all: it is reusable only after an open has proved the realm empty and retired its row, because a crash before the destroys are
checkpointed would otherwise replay the old realm's entities into the new one. So within one run every registered realm reads the generation it opened
with, and a consumer that keys on (id, generation) — the identity 12-realms § 1.1 defines — sees it change only across a restart.
Read it with Realms.GenerationOf(id); it is what the REALM block puts on the wire.
Id
The realm id.
public int Id
Field Value
MigrationHysteresisRatio
The cell-crossing hysteresis band, as a fraction of the cell (part of CC-02's contract, hence of identity).
public float MigrationHysteresisRatio
Field Value
SchemaName
Fully-qualified schema name of this record ("Typhon.Schema.Realm").
public const string SchemaName = "Typhon.Schema.Realm"
Field Value
State
Lifecycle state (Realms D5): StateLive, StateClosing (unregistered, not yet proven empty) or StateRetired (empty at an open; the id is free and a later registration reuses this row).
public int State
Field Value
StateClosing
Unregistered; reopened as Closing until an open finds it empty after recovery.
public const int StateClosing = 1
Field Value
StateLive
A registered realm.
public const int StateLive = 0
Field Value
StateRetired
Retired: its id may be registered again.
public const int StateRetired = 2
Field Value
WorldMaxX
World bounds, maximum corner.
public double WorldMaxX
Field Value
WorldMaxY
See WorldMaxX.
public double WorldMaxY
Field Value
WorldMaxZ
See WorldMaxX.
public double WorldMaxZ
Field Value
WorldMinX
World bounds, minimum corner.
public double WorldMinX
Field Value
WorldMinY
See WorldMinX.
public double WorldMinY
Field Value
WorldMinZ
See WorldMinX.
public double WorldMinZ