Mappedin JS - v6.14.0
    Preparing search index...

    Type Alias TMultiFloorViewOptions

    Options for controlling multi-floor view. When enabled, displays all floors in a building stacked vertically below the active floor, allowing users to see the building's vertical structure and navigate between floors. The active floor is fully rendered while lower floors appear as semi-transparent footprints.

    type TMultiFloorViewOptions = {
        __EXPERIMENTAL_darkenSpacesExposedToAbove?: boolean;
        enabled?: boolean;
        floorGap?: number | "auto";
        floorGapMultiplier?: number;
        footprintColor?: string | Partial<Record<Floor["id"], string>>;
        footprintOpacity?: number;
        footprintOutline?: boolean;
        footprintsHidden?: boolean;
        spacesOpenToBelowEnabled?: boolean;
        updateCameraElevationOnFloorChange?: boolean;
    }
    Index

    Properties

    __EXPERIMENTAL_darkenSpacesExposedToAbove? enabled? floorGap? floorGapMultiplier? footprintColor? footprintOpacity? footprintOutline? footprintsHidden? spacesOpenToBelowEnabled? updateCameraElevationOnFloorChange?

    Properties

    Optional Experimental__EXPERIMENTAL_darkenSpacesExposedToAbove

    __EXPERIMENTAL_darkenSpacesExposedToAbove?: boolean

    Whether to darken spaces that are exposed to the floor above. Only applies when spacesOpenToBelowEnabled is true.

    true
    @experimental
    enabled?: boolean

    Enable multi-floor view to show floors stacked vertically below the active floor.

    true
    floorGap?: number | "auto"

    The vertical spacing between floors, measured in meters. This controls how far apart the floors appear when stacked. If a number is provided, this value will be used for all floors. If 'auto' is provided, then the gap will be calculated based on the sum of all previous floors' max height or the default gap of 10 meters if no max height is present for any of the provided floors.

    'auto'
    floorGapMultiplier?: number

    Multiplier applied to each floor's maxHeight when calculating the floor gap. Only used when floorGap is 'auto'. Set to 1 to use the floor's maxHeight directly without scaling.

    3.333 (creates ~10m visual separation for typical 3m floors)
    footprintColor?: string | Partial<Record<Floor["id"], string>>

    The color of the floor footprints when in multi-floor view. Accepts either:

    • A CSS color string (hex, rgb, rgba, named colors) applied to all floors
    • An object mapping floor IDs to color strings for per-floor coloring

    When using an object, floors without a specified color will use the internal default ('#ffffff').

    // Single color for all floors
    footprintColor: '#ff0000'

    // Per-floor colors
    footprintColor: {
      'floor-1': '#ff0000',
      'floor-2': '#00ff00',
      'floor-3': '#0000ff'
    }

    '#ffffff'
    footprintOpacity?: number

    The opacity of the floor footprints when in multi-floor view.

    1
    footprintOutline?: boolean

    The outline of the floor footprints when in multi-floor view.

    true
    footprintsHidden?: boolean

    When true, footprints remain hidden and ignore all state updates. This prevents footprint geometry from interfering with raycasting.

    false
    spacesOpenToBelowEnabled?: boolean

    Whether to enable spaces open to below (ceiling cutouts that expose lower floors).

    When this is enabled, and spaces that have kind "void" or "otb" will be cut out of the ceiling exposing the floor below. Any holes in the footprint will also be cut out but will have walls built around them.

    false
    @experimental
    updateCameraElevationOnFloorChange?: boolean

    Automatically adjust the camera elevation when switching floors to match the floor's altitude.

    true

    Settings

    Member Visibility

    On This Page

    Properties