Portal (door, opening, or generic transition) between two adjacent SpaceGraphNodes. Carries the world-space mid-point of the portal plus the through-direction so the tour planner can build cross-portal camera trajectories that thread the door rather than clip into the surrounding wall.

For IFC sources, dataObjectId typically references an IfcDoor or IfcOpeningElement. For the geometry fallback extractor, edges are synthesised from wall-aperture detection and dataObjectId is omitted.

interface SpaceGraphEdge {
    dataObjectId?: string;
    from: string;
    height?: number;
    id: string;
    normal: Vec3;
    position: Vec3;
    sceneObjectId?: string;
    to: string;
    width?: number;
}

Properties

dataObjectId?: string

DataObject id, e.g. an IfcDoor global id.

from: string

SpaceGraphNode.id of one of the two adjacent spaces.

height?: number

Portal height in world units, if known.

id: string

Unique edge id within the parent SpaceGraph.

normal: Vec3

Unit normal pointing from from toward to. Used by samplers to bias viewpoint look-direction toward the exit door, and by the tour planner to orient mid-portal flight tangents.

position: Vec3

World-space mid-point of the portal opening.

sceneObjectId?: string

SceneObject id backing the portal (e.g. the door's SceneObject).

to: string

SpaceGraphNode.id of the other adjacent space.

width?: number

Portal width in world units, if known.