webeditor3d/src/runtime-three/runtime-scene-build.js

import { getModelInstances } from "../assets/model-instances";
import { cloneWorldSettings } from "../document/world-settings";
import { getEntityInstances, getPrimaryPlayerStartEntity } from "../entities/entity-instances";
import { getBoxBrushBounds } from "../geometry/box-brush";
import { buildBoxBrushDerivedMeshData } from "../geometry/box-brush-mesh";
import { buildGeneratedModelCollider } from "../geometry/model-instance-collider-generation";
import { cloneInteractionLink, getInteractionLinks } from "../interactions/interaction-links";
import { cloneMaterialDef } from "../materials/starter-material-library";
import { cloneBoxBrushGeometry, cloneFaceUvState } from "../document/brushes";
import { assertRuntimeSceneBuildable } from "./runtime-scene-validation";
import { FIRST_PERSON_PLAYER_SHAPE } from "./player-collision";
function cloneVec3(vector) {
    return {
        x: vector.x,
        y: vector.y,
        z: vector.z
    };
}
function resolveRuntimeMaterial(document, materialId) {
    if (materialId === null) {
        return null;
    }
    const material = document.materials[materialId];
    if (material === undefined) {
        throw new Error(`Runtime build could not resolve material ${materialId}.`);
    }
    return cloneMaterialDef(material);
}
function buildRuntimeBrush(brush, document) {
    return {
        id: brush.id,
        kind: "box",
        center: cloneVec3(brush.center),
        rotationDegrees: cloneVec3(brush.rotationDegrees),
        size: cloneVec3(brush.size),
        geometry: cloneBoxBrushGeometry(brush.geometry),
        faces: {
            posX: {
                materialId: brush.faces.posX.materialId,
                material: resolveRuntimeMaterial(document, brush.faces.posX.materialId),
                uv: cloneFaceUvState(brush.faces.posX.uv)
            },
            negX: {
                materialId: brush.faces.negX.materialId,
                material: resolveRuntimeMaterial(document, brush.faces.negX.materialId),
                uv: cloneFaceUvState(brush.faces.negX.uv)
            },
            posY: {
                materialId: brush.faces.posY.materialId,
                material: resolveRuntimeMaterial(document, brush.faces.posY.materialId),
                uv: cloneFaceUvState(brush.faces.posY.uv)
            },
            negY: {
                materialId: brush.faces.negY.materialId,
                material: resolveRuntimeMaterial(document, brush.faces.negY.materialId),
                uv: cloneFaceUvState(brush.faces.negY.uv)
            },
            posZ: {
                materialId: brush.faces.posZ.materialId,
                material: resolveRuntimeMaterial(document, brush.faces.posZ.materialId),
                uv: cloneFaceUvState(brush.faces.posZ.uv)
            },
            negZ: {
                materialId: brush.faces.negZ.materialId,
                material: resolveRuntimeMaterial(document, brush.faces.negZ.materialId),
                uv: cloneFaceUvState(brush.faces.negZ.uv)
            }
        }
    };
}
function buildRuntimeCollider(brush) {
    const bounds = getBoxBrushBounds(brush);
    const derivedMesh = buildBoxBrushDerivedMeshData(brush);
    return {
        kind: "trimesh",
        source: "brush",
        brushId: brush.id,
        center: cloneVec3(brush.center),
        rotationDegrees: cloneVec3(brush.rotationDegrees),
        vertices: derivedMesh.colliderVertices,
        indices: derivedMesh.colliderIndices,
        worldBounds: {
            min: cloneVec3(bounds.min),
            max: cloneVec3(bounds.max)
        }
    };
}
function buildRuntimeModelInstance(modelInstance) {
    return {
        instanceId: modelInstance.id,
        assetId: modelInstance.assetId,
        name: modelInstance.name,
        position: cloneVec3(modelInstance.position),
        rotationDegrees: cloneVec3(modelInstance.rotationDegrees),
        scale: cloneVec3(modelInstance.scale),
        animationClipName: modelInstance.animationClipName,
        animationAutoplay: modelInstance.animationAutoplay
    };
}
function getColliderBounds(collider) {
    if (collider.source === "brush") {
        return {
            min: cloneVec3(collider.worldBounds.min),
            max: cloneVec3(collider.worldBounds.max)
        };
    }
    return {
        min: cloneVec3(collider.worldBounds.min),
        max: cloneVec3(collider.worldBounds.max)
    };
}
function combineColliderBounds(colliders) {
    if (colliders.length === 0) {
        return null;
    }
    const firstBounds = getColliderBounds(colliders[0]);
    const min = cloneVec3(firstBounds.min);
    const max = cloneVec3(firstBounds.max);
    for (const collider of colliders.slice(1)) {
        const bounds = getColliderBounds(collider);
        min.x = Math.min(min.x, bounds.min.x);
        min.y = Math.min(min.y, bounds.min.y);
        min.z = Math.min(min.z, bounds.min.z);
        max.x = Math.max(max.x, bounds.max.x);
        max.y = Math.max(max.y, bounds.max.y);
        max.z = Math.max(max.z, bounds.max.z);
    }
    return {
        min,
        max,
        center: {
            x: (min.x + max.x) * 0.5,
            y: (min.y + max.y) * 0.5,
            z: (min.z + max.z) * 0.5
        },
        size: {
            x: max.x - min.x,
            y: max.y - min.y,
            z: max.z - min.z
        }
    };
}
function buildFallbackSpawn(sceneBounds) {
    if (sceneBounds === null) {
        return {
            source: "fallback",
            entityId: null,
            position: {
                x: 0,
                y: 0,
                z: -4
            },
            yawDegrees: 0
        };
    }
    return {
        source: "fallback",
        entityId: null,
        position: {
            x: sceneBounds.center.x,
            y: sceneBounds.max.y + 0.1,
            z: sceneBounds.max.z + 3
        },
        yawDegrees: 180
    };
}
function buildRuntimeSceneCollections(document) {
    const runtimeEntities = {
        playerStarts: [],
        soundEmitters: [],
        triggerVolumes: [],
        teleportTargets: [],
        interactables: []
    };
    const localLights = {
        pointLights: [],
        spotLights: []
    };
    for (const entity of getEntityInstances(document.entities)) {
        switch (entity.kind) {
            case "pointLight":
                localLights.pointLights.push({
                    entityId: entity.id,
                    position: cloneVec3(entity.position),
                    colorHex: entity.colorHex,
                    intensity: entity.intensity,
                    distance: entity.distance
                });
                break;
            case "spotLight":
                localLights.spotLights.push({
                    entityId: entity.id,
                    position: cloneVec3(entity.position),
                    direction: cloneVec3(entity.direction),
                    colorHex: entity.colorHex,
                    intensity: entity.intensity,
                    distance: entity.distance,
                    angleDegrees: entity.angleDegrees
                });
                break;
            case "playerStart":
                runtimeEntities.playerStarts.push({
                    entityId: entity.id,
                    position: cloneVec3(entity.position),
                    yawDegrees: entity.yawDegrees,
                    collider: buildRuntimePlayerShape(entity)
                });
                break;
            case "soundEmitter":
                runtimeEntities.soundEmitters.push({
                    entityId: entity.id,
                    position: cloneVec3(entity.position),
                    audioAssetId: entity.audioAssetId,
                    volume: entity.volume,
                    refDistance: entity.refDistance,
                    maxDistance: entity.maxDistance,
                    autoplay: entity.autoplay,
                    loop: entity.loop
                });
                break;
            case "triggerVolume":
                runtimeEntities.triggerVolumes.push({
                    entityId: entity.id,
                    position: cloneVec3(entity.position),
                    size: cloneVec3(entity.size),
                    // Derive from links so flags are always correct regardless of stored entity state
                    triggerOnEnter: Object.values(document.interactionLinks).some((l) => l.sourceEntityId === entity.id && l.trigger === "enter"),
                    triggerOnExit: Object.values(document.interactionLinks).some((l) => l.sourceEntityId === entity.id && l.trigger === "exit")
                });
                break;
            case "teleportTarget":
                runtimeEntities.teleportTargets.push({
                    entityId: entity.id,
                    position: cloneVec3(entity.position),
                    yawDegrees: entity.yawDegrees
                });
                break;
            case "interactable":
                runtimeEntities.interactables.push({
                    entityId: entity.id,
                    position: cloneVec3(entity.position),
                    radius: entity.radius,
                    prompt: entity.prompt,
                    enabled: entity.enabled
                });
                break;
            default:
                assertNever(entity);
        }
    }
    return {
        entities: runtimeEntities,
        localLights
    };
}
function assertNever(value) {
    throw new Error(`Unsupported runtime entity: ${String(value.kind)}`);
}
function buildRuntimePlayerShape(playerStartEntity) {
    if (playerStartEntity === null) {
        return FIRST_PERSON_PLAYER_SHAPE;
    }
    switch (playerStartEntity.collider.mode) {
        case "capsule":
            return {
                mode: "capsule",
                radius: playerStartEntity.collider.capsuleRadius,
                height: playerStartEntity.collider.capsuleHeight,
                eyeHeight: playerStartEntity.collider.eyeHeight
            };
        case "box":
            return {
                mode: "box",
                size: cloneVec3(playerStartEntity.collider.boxSize),
                eyeHeight: playerStartEntity.collider.eyeHeight
            };
        case "none":
            return {
                mode: "none",
                eyeHeight: playerStartEntity.collider.eyeHeight
            };
    }
}
export function buildRuntimeSceneFromDocument(document, options = {}) {
    assertRuntimeSceneBuildable(document, {
        navigationMode: options.navigationMode ?? "orbitVisitor",
        loadedModelAssets: options.loadedModelAssets
    });
    const brushes = Object.values(document.brushes).map((brush) => buildRuntimeBrush(brush, document));
    const colliders = Object.values(document.brushes).map((brush) => buildRuntimeCollider(brush));
    const modelInstances = getModelInstances(document.modelInstances).map(buildRuntimeModelInstance);
    const collections = buildRuntimeSceneCollections(document);
    const interactionLinks = getInteractionLinks(document.interactionLinks).map((link) => cloneInteractionLink(link));
    const playerStartEntity = getPrimaryPlayerStartEntity(document.entities);
    const playerCollider = buildRuntimePlayerShape(playerStartEntity);
    for (const modelInstance of getModelInstances(document.modelInstances)) {
        const asset = document.assets[modelInstance.assetId];
        if (asset === undefined || asset.kind !== "model") {
            continue;
        }
        const generatedCollider = buildGeneratedModelCollider(modelInstance, asset, options.loadedModelAssets?.[modelInstance.assetId]);
        if (generatedCollider !== null) {
            colliders.push(generatedCollider);
        }
    }
    const combinedSceneBounds = combineColliderBounds(colliders);
    const playerStart = playerStartEntity === null
        ? null
        : {
            entityId: playerStartEntity.id,
            position: cloneVec3(playerStartEntity.position),
            yawDegrees: playerStartEntity.yawDegrees,
            collider: playerCollider
        };
    return {
        world: cloneWorldSettings(document.world),
        localLights: collections.localLights,
        brushes,
        colliders,
        sceneBounds: combinedSceneBounds,
        modelInstances,
        entities: collections.entities,
        interactionLinks,
        playerStart,
        playerCollider,
        spawn: playerStart === null
            ? buildFallbackSpawn(combinedSceneBounds)
            : {
                source: "playerStart",
                entityId: playerStart.entityId,
                position: cloneVec3(playerStart.position),
                yawDegrees: playerStart.yawDegrees
            }
    };
}