复合查看器#

基于 engine 封装的复合查看器，整合 3D Viewer、全景查看器（PanoramaViewer）和 2D 地图（OpenLayers Map）于一体，通过模式切换实现多种视图间的无缝协调。

类定义#

class CompositeViewer implements IEntity

属性#

类型#

CompositeViewerMode#

type CompositeViewerMode = "2D" | "3D" | "PANO" | "PANO_3D";

构造函数#

constructor(app: ViewerApp, options: { id?: EntityId; mode: CompositeViewerMode })

构造时自动挂载以下内建组件：

• BaseMapComponent
• LayerComponent
• DrawingComponent
• FlyThroughComponent
• IdentifyComponent

方法#

destroy()#

public destroy(): void

销毁当前 CompositeViewer，从 ViewerApp.compositeViewers 列表中移除自身。

changeMode(mode)#

public changeMode(mode: CompositeViewerMode): void

切换视图模式。切换时会派发 modeChange 事件；若从全景模式退出（PANO / PANO_3D → 其他模式），还会派发 exitPano 事件并重置 currentPano。

addViewer(viewer)#

public addViewer(viewer: Viewer): Viewer

添加一个已有的 3D Viewer 实例。如果已存在则打印警告并返回现有实例。添加后自动绑定以下原生事件并转发到 eventDispatcher：

• click → viewerClick
• move → viewerMouseMove
• identify → viewerIdentify / viewerIdentifyMap / viewerIdentifyPointCloud / viewerIdentifyBim
• cameramoveprecise → viewerCameramoveprecise
• bimFeatureTypeLoad → bimFeatureTypeLoad

返回值： Viewer — 添加的 Viewer 实例。

createViewer(containerId, options)#

public createViewer(containerId: string, options: ViewerOptions): Viewer

创建并添加 3D Viewer 实例。

返回值： Viewer — 新创建的 Viewer 实例。

addPanoViewer(panoViewer)#

public addPanoViewer(panoViewer: PanoramaViewer): PanoramaViewer

添加一个已有的全景查看器实例。如果已存在则打印警告并返回现有实例。添加后自动绑定以下原生事件并转发到 eventDispatcher：

• render → panoViewerRender
• panoLoad → panoLoad
• panoClick → panoClick
• identify → panoViewerIdentify
• pinpointStart → panoPinpointStart
• pinpointStop → panoPinpointStop

返回值： PanoramaViewer — 添加的全景查看器实例。

createPanoViewer(containerId, options?)#

public createPanoViewer(containerId: string, options?: PanoViewerOptions): PanoramaViewer

创建并添加全景查看器实例。

返回值： PanoramaViewer — 新创建的全景查看器实例。

createMap2d(containerId, mapUrl?)#

public createMap2d(containerId: string, mapUrl?: string): Map | null

创建 2D 地图（基于 OpenLayers）。默认使用香港地政总署底图，支持 EPSG:2326 投影。创建时会自动监听容器大小变化并更新地图尺寸。

返回值： Map | null — 创建的 OpenLayers Map 实例。

getPanoOpacity()#

public getPanoOpacity(): number | undefined

获取全景查看器当前的透明度值。

返回值： number | undefined — 透明度值（0-1），若无全景查看器则返回 undefined。

setPanoOpacity(opacity)#

public setPanoOpacity(opacity: number): void

设置全景查看器的透明度。设置成功后派发 panoOpacityChange 事件。

gotoPano(targetPano, nearbyPanoList, config?)#

public gotoPano(
    targetPano: PanoPoint,
    nearbyPanoList: PanoPoint[],
    config?: { heading?: number; pitch?: number }
): void

跳转到指定全景点。首次加载时调用 loadPano，后续切换时调用 switchPano。跳转后派发 switchPano 事件，并在非全景模式下自动切换到 PANO 模式。

事件 (CompositeViewerEventMap)#

通过 eventDispatcher.addEventListener(type, callback) 监听。