Options
All
  • Public
  • Public/Protected
  • All
Menu

Class PanoramaGroup

全景图组

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

  • new PanoramaGroup(panoramaDataList: PanoramaData[], options: object, initializeAllPanoramas?: undefined | false | true): PanoramaGroup
  • example
    panoMgr = new PanoramaGroup(panoramaDataList, 2, {
 floorModel,
 groundParams,
});
stage.bindElement(panoMgr);

    Parameters

    • panoramaDataList: PanoramaData[]
    • options: object
      • Optional globalScale?: undefined | number
      • Optional groundParams?: GroundParameters
      • Optional indicatorHeight?: undefined | number
      • Optional indicatorImageURL?: undefined | string
      • Optional indicatorPositionMap?: Map<number, Vector3>
      • Optional indicatorWidth?: undefined | number
      • Optional invisibleIndicatorImageURL?: undefined | string
      • Optional modelElement?: NS_THREE.Object3D
    • Optional initializeAllPanoramas: undefined | false | true

    Returns PanoramaGroup

Properties

boundBox

boundBox: Mesh | null

currentPanoramaID

currentPanoramaID: number

group

group: Group

maxWorldDistance

maxWorldDistance: number

modelElement

modelElement: Object3D | null

panoramaDatas

panoramaDatas: Map<number, PanoramaData>

Static DefaultVisibleRadius

DefaultVisibleRadius: number = 10

Static IndicatorOffsetZ

IndicatorOffsetZ: number = 0.1

Static IndicatorRadius

IndicatorRadius: number = 0.1

Methods

addGroupViewConfiguration

addViewConfiguration

  • 配置组中所有全景图在不同view中的显示状态

    Parameters

    Returns Promise<void>

bindModelElement

  • bindModelElement(modelElement?: NS_THREE.Object3D): void

  • 绑定模型Element对象（用于创建天空包围盒供全景切换时使用）

    Parameters

    • Optional modelElement: NS_THREE.Object3D

      模型Element对象

    Returns void

dispose

  • dispose(exceptForCubeTextureOfPID?: undefined | number): void

  • Parameters

    • Optional exceptForCubeTextureOfPID: undefined | number

    Returns void

getAllPanoramas

  • getAllPanoramas(): Promise<(undefined | Panorama)[]>

  • Returns Promise<(undefined | Panorama)[]>

getIndicatorMaterial

  • Parameters

    Returns Material | undefined

getIndicatorPosition

  • getIndicatorPosition(pid: number): Vector3 | undefined

  • Parameters

    • pid: number

    Returns Vector3 | undefined

getIndicatorSize

  • getIndicatorSize(): number[]

  • 查询当前设置的地面全景点标识尺寸

    Returns number[]

    number数组，依次是width, height

getIndicatorVisibility

  • getIndicatorVisibility(pid: number): boolean

  • Parameters

    • pid: number

    Returns boolean

getPanoramaByPID

  • getPanoramaByPID(pid: number): Promise<Panorama | undefined>

  • 获得指定ID的全景点对象

    Parameters

    • pid: number

      全景点ID

    Returns Promise<Panorama | undefined>

getPanoramaByPIDInstant

  • getPanoramaByPIDInstant(pid: number): Panorama | null

  • 立刻获得指定ID的全景点对象

    Parameters

    • pid: number

      全景点ID

    Returns Panorama | null

initializePanoramasIfNecessary

  • initializePanoramasIfNecessary(preInitStrategy: "all" | number | number[]): Promise<(undefined | Panorama)[]>

  • 指定预构建全景对象的顺序策略

    Parameters

    • preInitStrategy: "all" | number | number[]

      多义参数，表示具体的创建顺序 当为'all'时，直接按构造函数中panoramaDataList的顺序创建全部全景对象 当为一个整数值时，表示一个全景PID，将按全景点邻接关系以广度优先搜索的顺序创建全景对象 当为一个整数数组时，以数组指定的PID顺序依次创建

    Returns Promise<(undefined | Panorama)[]>

intersectIndicators

  • intersectIndicators(rayOrigin: Vector3, rayDirection: Vector3): number

  • 与全景点标志作相交测试 若有任一个全景点标志与射线相交则返回最近一个的相应PID 若没有则返回-1

    Parameters

    • rayOrigin: Vector3

      射线起点

    • rayDirection: Vector3

      射线方向

    Returns number

intersectIndicatorsOnScreen

  • intersectIndicatorsOnScreen(screenPosition: Vector2, radius: number, __namedParameters: object, camera: Camera): number

  • Parameters

    • screenPosition: Vector2
    • radius: number
    • __namedParameters: object
      • screenHeight: number
      • screenWidth: number
    • camera: Camera

    Returns number

panoramaIDsAround

  • panoramaIDsAround(centerPID: number, view?: View): number[] | null

  • Parameters

    • centerPID: number
    • Optional view: View

    Returns number[] | null

preloadCubeTexturesOfPIDs

  • preloadCubeTexturesOfPIDs(pids: number[], waitForReadyCount: number): Promise<CubeTexture[]>

  • 获取一组全景点的立方体贴图，若没命中则异步加载

    Parameters

    • pids: number[]

      全景点ID数组

    • waitForReadyCount: number

      指定函数必须在pids中的前多少个全景点立方体贴图获取到以后才能返回 比如在即将显示一个全景点时，指定必须等指定全景点的立方体贴图获取到后才能返回，而其周围全景点可以同时预加载但不用等

    Returns Promise<CubeTexture[]>

presentPanorama

  • presentPanorama(panorama: Panorama, hdTiles: number[][], ldTiles: number[][]): Promise<void>

  • 加载指定全景图并加入场景（显示要通过PanoramaController）

    Parameters

    • panorama: Panorama

      要加载的全景图

    • hdTiles: number[][]
    • ldTiles: number[][]

    Returns Promise<void>

presentPanoramaAround

  • presentPanoramaAround(currentPID: number, hdTiles: number[][], ldTiles: number[][], view?: View): Promise<void>

  • 设置当前位于的全景点位。将加载指定全景点并预加载其相邻全景点

    Parameters

    • currentPID: number

      全景点位ID

    • hdTiles: number[][]
    • ldTiles: number[][]
    • Optional view: View

    Returns Promise<void>

presentPanoramaIndicators

  • presentPanoramaIndicators(pidPositionMap: Map<number, Vector3>): void

  • 显示指定全景点位标签

    Parameters

    • pidPositionMap: Map<number, Vector3>

      从PID映射到全景点位位置的Map

    Returns void

presentPanoramaIndicatorsAround

  • presentPanoramaIndicatorsAround(pid: number, view?: View): Promise<void>

  • 显示指定全景点及其相邻全景点上的标签

    Parameters

    • pid: number

      “中心”全景点ID，一般指摄像机当前所在的全景点PID

    • Optional view: View

    Returns Promise<void>

presentPanoramaOfPID

  • presentPanoramaOfPID(pid: number, hdTiles: number[][], ldTiles: number[][]): Promise<void>

  • 加载指定PID的全景图并加入场景（显示要通过PanoramaController）

    Parameters

    • pid: number

      要加载的全景图ID

    • hdTiles: number[][]
    • ldTiles: number[][]

    Returns Promise<void>

putPanorama

  • 添加全景点

    Parameters

    Returns void

setBoundBoxAppearance

  • setBoundBoxAppearance(material: Material): void

  • Parameters

    • material: Material

    Returns void

setIndicatorHidden

  • setIndicatorHidden(hidden: boolean, pid?: number | number[]): void

  • Parameters

    • hidden: boolean
    • Optional pid: number | number[]

    Returns void

setIndicatorImageURL

  • setIndicatorImageURL(url: string): void

  • Parameters

    • url: string

    Returns void

setIndicatorMaterial

  • 设定全景点位标签的原型对象，每个全景点位的标签会以该原型对象为母本clone出来

    Parameters

    • material: Material
    • mode: IndicatorDisplayMode

      点位的展示模式

    • visibility: boolean

      点位的显隐状态设置

    Returns void

setIndicatorMeshPrototype

  • setIndicatorMeshPrototype(mesh: Mesh): void

  • Parameters

    • mesh: Mesh

    Returns void

setIndicatorSize

  • setIndicatorSize(width: number, height: number): void

  • 改变地面全景点标识的尺寸

    Parameters

    • width: number

      宽度

    • height: number

      高度

    Returns void

setIndicatorVisibility

  • setIndicatorVisibility(visibility: boolean, pid?: number | number[]): void

  • 设置指定全景点位的显示/隐藏状态

    Parameters

    • visibility: boolean

      显示/隐藏状态

    • Optional pid: number | number[]

      可选，可以是全景图点位PID数组，也可以是单个PID, 若不设置则应用到本PanoramaGroup的所有全景点位上

    Returns void

setMaxWorldDistance

  • setMaxWorldDistance(distance: number): void

  • Parameters

    • distance: number

    Returns void

updateIndicatorGeometry

  • updateIndicatorGeometry(): void

  • Returns void

updateIndicatorsPositions

  • updateIndicatorsPositions(): Promise<void>

  • Returns Promise<void>

Static getBoundBox

  • getBoundBox(rootObj: Object3D | null): Mesh | null

  • Parameters

    • rootObj: Object3D | null

    Returns Mesh | null