Class Five

如视 VR Web展示器

Example

// 初始化构造函数
const five = new Five();
// 将绘制区域添加到页面上
five.appendTo(document.body);
// 加载 Work 数据
five.load({...});

Hierarchy (view full)

Subscribe<EventTypes>
- Five

Index

Constructors

constructor

Accessors

enableEDL enableHQ enableIOSEDR enablePostProcessing helperVisible model observers panoIndex postProcessingType work works dracoPath ktx2Path version

Constructors

constructor

new Five(initArgs?): Five
Parameters
- initArgs: FiveInitArgs = {}
Returns Five
Overrides Subscribe.constructor
- Defined in lib/five/application/five.ts:323

Properties

camera

camera: Camera

内部使用的 Camera

currentMode

currentMode: Mode

当前展示的模式

ident

ident: string

imageOptions

imageOptions: ImageOptions

全景图的配置参数

Description

可以动态对配置在 work 数据中的全景图片在 runtime 做 url 调整。平衡加载时间和图片质量

info

info: {
    memory: {
        geometries: number;
        textures: number;
    };
    render: {
        calls: number;
        frame: number;
        lines: number;
        points: number;
        triangles: number;
    };
}

Type declaration

memory: {
geometries: number;
textures: number;
}
- geometries: number
- textures: number
render: {
    calls: number;
    frame: number;
    lines: number;
    points: number;
    triangles: number;
}
- calls: number
- frame: number
- lines: number
- points: number
- triangles: number

modelRenderTarget

modelRenderTarget: WebGLRenderTarget

模型渲染缓冲

modelScene

modelScene: Scene

内部模型部分使用的 THREE.Scene

modelSceneNeedsRender

modelSceneNeedsRender: boolean

模型是否需要更新渲染

Description

可以设置modelNeedsRender为true，通知five进行模型渲染的更新

models

models: Models

当前加载的模型

needsRender

needsRender: boolean

是否需要渲染

Description

如果初始化设置了 onlyRenderIfNeeds: true, 则会激活按需渲染可以通过设置 five.needsRender = true 来告知，five 会在下一帧渲染画面。

pano

pano: Pano

当前点位序号

paused

paused: boolean

自动播放状态是否暂停

Description

可以通过 five.play five.pause 方法播放或暂停

plugins

plugins: {
[key: string]: FivePluginInstance<any>;
}

插件暴露的方法

Type declaration

[key: string]: FivePluginInstance<any>

`Optional` renderer

renderer?: WebGLRenderer

当前使用的 THREE.WebGLRenderer。

Description

如果初始化时传入了 renderer 则直接时该值否则会通过 preserveDrawingBuffer backgroundColor backgroundAlpha antialias 创建一个 THREE.WebGLRenderer

scene

scene: Scene

非模型部分使用的 THREE.Scene

scissor

scissor: Scissor

当前设置的 scissor

Description

可通过初始化，或者 setScissor 方式设置 scissor 是将屏幕中的内容渲染到 renderer 的指定区域。页面整体长宽均为 1。通过类似 css 的 left bottom width height 来确定区域。

Example

scissor: { left: 0.75, bottom: 0, width: 0.25, height: 1 }

state

state: State

当前状态

Description

five 设置了以下状态

- mode: Mode
- panoIndex: number
- longitude: number
- latitude: number
- fov: number
- offset: THREE.Vector3

可以通过 five.state 和 five.setState 来获取和设置。
通过 state 设置后，five 会通过合适的动画运动来达到设置的位置。
来迎合一些通过数据驱动的场景。

textureOptions

textureOptions: TextureOptions

模型贴图的配置参数

Description

可以动态对配置在 work 数据中的模型贴图在 runtime 做 url 调整。平衡加载时间和图片质量

videoTexture

videoTexture: VideoTexture

模型贴图的配置参数

Description

可以动态对配置在 work 数据中的模型贴图在 runtime 做 url 调整。平衡加载时间和图片质量

xrCustomObjectsScene

xrCustomObjectsScene: Scene

供外部放置需要在xr场景下产生遮挡的物体们

`Static` Line

Line: any = null

Deprecated

请使用 import { Line } from "@realsee/five/line" 代替;

`Static` Mode

Mode: Mirror<Mode> = ...

Five 的显示模式，可以通过 five.changeMode five.setState 来切换

Description

Panorama 全景图游走模式
Model 模型游走模式
Floorplan 模型查看模式
Topview 户型图模式
VRPanorama VR眼镜模式
XRPanorama VR硬件模式

Accessors

enableEDL

get enableEDL(): boolean
是否开启EDL模式

Returns boolean
- Defined in lib/five/application/five.ts:750
set enableEDL(enable): void
Parameters
- enable: boolean
Returns void
- Defined in lib/five/application/five.ts:754

enableHQ

get enableHQ(): boolean
Returns boolean
- Defined in lib/five/application/five.ts:767
set enableHQ(enable): void
Parameters
- enable: boolean
Returns void
- Defined in lib/five/application/five.ts:771

enableIOSEDR

get enableIOSEDR(): boolean
是否开启 IOS EDR 模式需要客户端配合并且开启 five.enablepostProcessing = true

Returns boolean
- Defined in lib/five/application/five.ts:724
set enableIOSEDR(enable): void
Parameters
- enable: boolean
Returns void
- Defined in lib/five/application/five.ts:727

enablePostProcessing

get enablePostProcessing(): boolean
是否开启后处理

Returns boolean
- Defined in lib/five/application/five.ts:786
set enablePostProcessing(enable): void
Parameters
- enable: boolean
Returns void
- Defined in lib/five/application/five.ts:789

helperVisible

get helperVisible(): boolean
帮助元素显示/隐藏

Returns boolean
- Defined in lib/five/application/five.ts:705
set helperVisible(visible): void
Parameters
- visible: boolean
Returns void
- Defined in lib/five/application/five.ts:708

model

get model(): Model
Returns Model
- Defined in lib/five/application/five.ts:1073

observers

get observers(): WorkResolvedObserver[]
获取观测点

Returns WorkResolvedObserver[]
- Defined in lib/five/application/five.ts:1740

panoIndex

get panoIndex(): number
Returns number
- Defined in lib/five/application/five.ts:538

postProcessingType

get postProcessingType(): PostProcessingType
后处理类型

Returns PostProcessingType
- Defined in lib/five/application/five.ts:739

work

get work(): Work
Returns Work
- Defined in lib/five/application/five.ts:1069

works

get works(): Works
当前加载的 work 数据

Returns Works
- Defined in lib/five/application/five.ts:1056

`Static` dracoPath

get dracoPath(): string
Returns string
- Defined in lib/five/application/five.ts:102
set dracoPath(path): void
Parameters
- path: string
Returns void
- Defined in lib/five/application/five.ts:106

`Static` ktx2Path

get ktx2Path(): string
Returns string
- Defined in lib/five/application/five.ts:110
set ktx2Path(path): void
Parameters
- path: string
Returns void
- Defined in lib/five/application/five.ts:114

`Static` version

get version(): string
Returns string
- Defined in lib/five/application/five.ts:97

Methods

addExtraElement

addExtraElement(element): (() => void)
绑定一个额外 DOM 区域，接受触控/鼠标事件
Parameters
- element: HTMLElement
Returns (() => void)
解除该绑定
- - (): void
  - Returns void
- Defined in lib/five/application/five.ts:938

appendTo

appendTo(element, size?): void
将显示区域加载到页面 DOM 中
Parameters
- element: HTMLElement
  加载到页面的 DOM 元素
- size: {
  height?: number;
  width?: number;
  } = {}
  显示区域尺寸默认铺满这个 DOM 元素
  - Optional height?: number
  - Optional width?: number
Returns void
Description
如果你是传入的 renderer. 则你需要自行来方式显示区域该方法并不生效
- Defined in lib/five/application/five.ts:857

aroundScissor

aroundScissor(callback): void
Parameters
- callback: (() => void)
  - - (): void
    - Returns void
Returns void
- Defined in lib/five/application/five.ts:2371

changeMode

changeMode<T>(mode, state?, options?, userAction?, force?): Promise<void>
切换模态
Type Parameters
- T extends Mode
Parameters
- mode: T
  切换到的模态
- state: Partial<Omit<State, "mode">> = {}
  切换完成时的姿态
- Optional options: number | {
  duration?: number;
  effect?: MovePanoEffect;
  }
  模态切换动画用时
- userAction: boolean = true
  是否时用户动作触发默认 true
- force: boolean = false
  必须重新初始化 controller
Returns Promise<void>
- Defined in lib/five/application/five.ts:1483

dispose

dispose(): void
析构 five 对象。

Returns void
Description
一旦调用了析构方法，则不能再使用当前 five 对象了。你可以新建一个新的。
- Defined in lib/five/application/five.ts:624

emit

emit<K>(name, ...data): boolean
触发事件
Type Parameters
- K extends "error" | "dispose" | "gesture.pan" | "gesture.tap" | "gesture.press" | "gesture.pinch" | "gesture.mousewheel" | "gesture.mousemove" | "gesture.momentum" | "initAnimation.start" | "initAnimation.end" | "camera.update" | "intersect.update" | "pano.select" | "pano.request" | "pano.moveTo" | "pano.moving" | "pano.arrived" | "pano.cancel" | "pano.error" | "pano.texture.load" | "pano.texture.progress" | "pano.texture.success" | "pano.texture.error" | "pano.texture.abort" | "xr.session.end" | "xr.session.start" | "xr.gesture.tap" | "xr.gesture.press" | "xr.gesture.buttonUp" | "xr.gesture.buttonDown" | "xr.controller.update" | (keyof LegacyEventType) | "works.request" | "works.load" | "works.ready" | "state.set" | "state.change" | "state.synced" | "currentState.change" | "model.request" | "model.load" | "model.error" | "model.changeShownFloor" | "models.load" | "models.refined" | "render.prepare" | "render" | "mode.change.request" | "mode.change" | "helpers.visible" | "network.resource" | "fps"
  预设的监听事件名称
Parameters
- name: K
  事件类型
- Rest ...data: Parameters<EventTypes[K]>
  触发事件的数据
Returns boolean
canceled 是否被触发取消
Inherited from Subscribe.emit
- Defined in lib/five/utils/subscribe.ts:134

exitFullscreen

exitFullscreen(): void
退出全屏

Returns void
- Defined in lib/five/application/five.ts:2599

getCameraLocal

getCameraLocal(): {
    lookAtVector: Vector3;
    phi: number;
    theta: number;
}
获取当前相机的姿态（用于内部的 python 脚本截图）

Returns {
    lookAtVector: Vector3;
    phi: number;
    theta: number;
}
- lookAtVector: Vector3
- phi: number
- theta: number
Deprecated
这是用于内部的 python 脚本截图
- Defined in lib/five/application/five.ts:1039

getCurrentState

getCurrentState(): State
Returns State
- Defined in lib/five/application/five.ts:2188

getDrawingBufferSize

getDrawingBufferSize(target): Vector2
Parameters
- target: Vector2
Returns Vector2
- Defined in lib/five/application/five.ts:978

getElement

getElement(): HTMLCanvasElement
获取显示用的画布（Canvas DOM节点）

Returns HTMLCanvasElement
- Defined in lib/five/application/five.ts:1733

getGPUPicking

getGPUPicking(x, y, colorMap, pixelRatio?, color?): string | false
GPU Picking 获取选中的 mesh
Parameters
- x: number
  屏幕坐标 x
- y: number
  屏幕坐标 y
- colorMap: {
  [key: string]: THREE.Color;
  }
  需要选取的 mesh 的颜色与 uuid 的映射
  - [key: string]: THREE.Color
- pixelRatio: number = 1
- color: Vector3 = ...
  指定的模型颜色
Returns string | false
选中 mesh 的 uuid
- Defined in lib/five/application/five.ts:550

getLongitudeAndLatitude

getLongitudeAndLatitude(): Pick<Pose, "longitude" | "latitude">
获取当前相机经纬度

Returns Pick<Pose, "longitude" | "latitude">
Deprecated
请使用使用 getPose
- Defined in lib/five/application/five.ts:1022

getOffset

getOffset(): Vector3
获取当前相机位置

Returns Vector3
Deprecated
请使用使用 getPose
- Defined in lib/five/application/five.ts:1031

getPixels

getPixels(x, y, width, height, pixelRatio?): Uint8Array
获取画面中的像素颜色
Parameters
- x: number
  获取像素区域的起始坐标 x
- y: number
  获取像素区域的起始坐标 y
- width: number
  获取像素区域的宽度
- height: number
  获取像素区域的高度
- pixelRatio: number = 1
  获取区域的像素比
Returns Uint8Array
rgba颜色平铺的 Uint8Array
- Defined in lib/five/application/five.ts:1668

getPose

getPose(): Pose
获取当前相机姿态, 可以使用 getCurrentState 代替

Returns Pose
- Defined in lib/five/application/five.ts:963

getRenderObjects

getRenderObjects(object?): Object3D[]
获取当前在屏幕视锥中的 mesh。
Parameters
- Optional object: Object3D
  如果传入则检查这个对象中的mesh，如果不传，则检查整个 scene
Returns Object3D[]
- Defined in lib/five/application/five.ts:2168

getSize

getSize(target): Vector2
Parameters
- target: Vector2
Returns Vector2
- Defined in lib/five/application/five.ts:968

hasListener

hasListener(name): boolean
判断是否注册了事件
Parameters
- name: "error" | "dispose" | "gesture.pan" | "gesture.tap" | "gesture.press" | "gesture.pinch" | "gesture.mousewheel" | "gesture.mousemove" | "gesture.momentum" | "initAnimation.start" | "initAnimation.end" | "camera.update" | "intersect.update" | "pano.select" | "pano.request" | "pano.moveTo" | "pano.moving" | "pano.arrived" | "pano.cancel" | "pano.error" | "pano.texture.load" | "pano.texture.progress" | "pano.texture.success" | "pano.texture.error" | "pano.texture.abort" | "xr.session.end" | "xr.session.start" | "xr.gesture.tap" | "xr.gesture.press" | "xr.gesture.buttonUp" | "xr.gesture.buttonDown" | "xr.controller.update" | (keyof LegacyEventType) | "works.request" | "works.load" | "works.ready" | "state.set" | "state.change" | "state.synced" | "currentState.change" | "model.request" | "model.load" | "model.error" | "model.changeShownFloor" | "models.load" | "models.refined" | "render.prepare" | "render" | "mode.change.request" | "mode.change" | "helpers.visible" | "network.resource" | "fps"
  事件类型
Returns boolean
Inherited from Subscribe.hasListener
- Defined in lib/five/utils/subscribe.ts:45

load

load(inputWork, state?, options?, userAction?): Promise<void>
加载 Work 数据
Parameters
- inputWork: string | string[] | LooseWork | Work | Work[] | LooseWork[] | LooseWorkWithExtrinsics[] | Promise<LooseWork | Work | Work[] | LooseWork[] | LooseWorkWithExtrinsics[]>
  Work 数据
- Optional state: "initial" | Partial<State> | "inherit"
  初始化姿态
  - "inherit" 使用当前姿态
  - "initial" 使用 Work 数据中的 initial 姿态
  - State 自定义姿态
- Optional options: number | FiveLoadOptions
  切换时间, 切换效果
- userAction: boolean = true
Returns Promise<void>
- Defined in lib/five/application/five.ts:1086

moveToPano

moveToPano(pano, options?, userAction?): Promise<void>
转化到 Panorama 模态，并移动到对应序号的观察点。
Parameters
- pano: number | Pano | `${string}[${number}]`
- options: MovePanoOptions = {}
  移动点位参数
- userAction: boolean = true
  是否用户触犯
Returns Promise<void>
- Defined in lib/five/application/five.ts:2066

off

off<K>(name?, callback?): void
解除事件

如果 name 不传的话解除对应所有事件如果 name, callback 不传的话解除所有name的所有事件
Type Parameters
- K extends "error" | "dispose" | "gesture.pan" | "gesture.tap" | "gesture.press" | "gesture.pinch" | "gesture.mousewheel" | "gesture.mousemove" | "gesture.momentum" | "initAnimation.start" | "initAnimation.end" | "camera.update" | "intersect.update" | "pano.select" | "pano.request" | "pano.moveTo" | "pano.moving" | "pano.arrived" | "pano.cancel" | "pano.error" | "pano.texture.load" | "pano.texture.progress" | "pano.texture.success" | "pano.texture.error" | "pano.texture.abort" | "xr.session.end" | "xr.session.start" | "xr.gesture.tap" | "xr.gesture.press" | "xr.gesture.buttonUp" | "xr.gesture.buttonDown" | "xr.controller.update" | (keyof LegacyEventType) | "works.request" | "works.load" | "works.ready" | "state.set" | "state.change" | "state.synced" | "currentState.change" | "model.request" | "model.load" | "model.error" | "model.changeShownFloor" | "models.load" | "models.refined" | "render.prepare" | "render" | "mode.change.request" | "mode.change" | "helpers.visible" | "network.resource" | "fps"
  预设的监听事件名称
Parameters
- Optional name: K
  事件类型
- Optional callback: ((...args) => ReturnType<EventTypes[K]>)
  事件回调函数
  - - (...args): ReturnType<EventTypes[K]>
    - Parameters
      Rest ...args: Parameters<EventTypes[K]>
      Returns ReturnType<EventTypes[K]>
Returns void
Inherited from Subscribe.off
- Defined in lib/five/utils/subscribe.ts:99

on

on<K>(name, callback, once?): (() => void)
注册事件
Type Parameters
- K extends "error" | "dispose" | "gesture.pan" | "gesture.tap" | "gesture.press" | "gesture.pinch" | "gesture.mousewheel" | "gesture.mousemove" | "gesture.momentum" | "initAnimation.start" | "initAnimation.end" | "camera.update" | "intersect.update" | "pano.select" | "pano.request" | "pano.moveTo" | "pano.moving" | "pano.arrived" | "pano.cancel" | "pano.error" | "pano.texture.load" | "pano.texture.progress" | "pano.texture.success" | "pano.texture.error" | "pano.texture.abort" | "xr.session.end" | "xr.session.start" | "xr.gesture.tap" | "xr.gesture.press" | "xr.gesture.buttonUp" | "xr.gesture.buttonDown" | "xr.controller.update" | (keyof LegacyEventType) | "works.request" | "works.load" | "works.ready" | "state.set" | "state.change" | "state.synced" | "currentState.change" | "model.request" | "model.load" | "model.error" | "model.changeShownFloor" | "models.load" | "models.refined" | "render.prepare" | "render" | "mode.change.request" | "mode.change" | "helpers.visible" | "network.resource" | "fps"
  预设的监听事件名称
Parameters
- name: K
  事件类型
- callback: ((...args) => ReturnType<EventTypes[K]>)
  事件回调函数
  - - (...args): ReturnType<EventTypes[K]>
    - Parameters
      Rest ...args: Parameters<EventTypes[K]>
      Returns ReturnType<EventTypes[K]>
- Optional once: boolean
  是否只执行一次
Returns (() => void)
解除事件
- - (): void
  - Returns void
Inherited from Subscribe.on
- Defined in lib/five/utils/subscribe.ts:59

once

once<K>(name, callback): (() => void)
注册事件(是否只执行一次)
Type Parameters
- K extends "error" | "dispose" | "gesture.pan" | "gesture.tap" | "gesture.press" | "gesture.pinch" | "gesture.mousewheel" | "gesture.mousemove" | "gesture.momentum" | "initAnimation.start" | "initAnimation.end" | "camera.update" | "intersect.update" | "pano.select" | "pano.request" | "pano.moveTo" | "pano.moving" | "pano.arrived" | "pano.cancel" | "pano.error" | "pano.texture.load" | "pano.texture.progress" | "pano.texture.success" | "pano.texture.error" | "pano.texture.abort" | "xr.session.end" | "xr.session.start" | "xr.gesture.tap" | "xr.gesture.press" | "xr.gesture.buttonUp" | "xr.gesture.buttonDown" | "xr.controller.update" | (keyof LegacyEventType) | "works.request" | "works.load" | "works.ready" | "state.set" | "state.change" | "state.synced" | "currentState.change" | "model.request" | "model.load" | "model.error" | "model.changeShownFloor" | "models.load" | "models.refined" | "render.prepare" | "render" | "mode.change.request" | "mode.change" | "helpers.visible" | "network.resource" | "fps"
  预设的监听事件名称
Parameters
- name: K
  事件类型
- callback: ((...args) => ReturnType<EventTypes[K]>)
  事件回调函数
  - - (...args): ReturnType<EventTypes[K]>
    - Parameters
      Rest ...args: Parameters<EventTypes[K]>
      Returns ReturnType<EventTypes[K]>
Returns (() => void)
解除事件
- - (): void
  - Returns void
Inherited from Subscribe.once
- Defined in lib/five/utils/subscribe.ts:83

pause

pause(): void
暂停自动播放

Returns void
- Defined in lib/five/application/five.ts:2047

play

play(): void
Returns void
- Defined in lib/five/application/five.ts:2054

preloadPano

preloadPano(pano, callback?): Promise<number>
预加载点位图片资源
Parameters
- pano: number | Pano | `${string}[${number}]`
  观察点序号
- callback: ((costs) => void) = noop
  加载完成回调, 并传递加载用时。
  - - (costs): void
    - Parameters
      costs: number
      Returns void
Returns Promise<number>
加载完成的 Promise 参数同 callback
- Defined in lib/five/application/five.ts:2112

project2d

project2d(vector, testModel?): Vector2
计算三维坐标对应到屏幕的二维坐标
Parameters
- vector: Vector3
  三维坐标
- testModel: boolean = false
  是否计算模型遮挡
Returns Vector2
二维坐标或者 null

Description
如果三维坐标不在屏幕中，则返回 null
- Defined in lib/five/application/five.ts:2143

ready

ready(args?): Promise<void>
当前页面静态
Parameters
- args: {
  tile?: boolean;
  } = {}
  - Optional tile?: boolean
Returns Promise<void>
- Defined in lib/five/application/five.ts:2577

refresh

refresh(size?, pixelRatio?): void
设置显示区域尺寸
Parameters
- size: {
  height?: number;
  width?: number;
  } = {}
  显示区域尺寸默认铺满这个 DOM 元素
  - Optional height?: number
  - Optional width?: number
- Optional pixelRatio: number
  像素比默认继承之前的设置
Returns void
Description
如果你是传入的 renderer. 则你需要自行来设置显示区域尺寸，该方法并不生效
- Defined in lib/five/application/five.ts:886

removeExtraElement

removeExtraElement(element): void
解除绑定的一个额外 DOM 区域
Parameters
- element: HTMLElement
Returns void
- Defined in lib/five/application/five.ts:951

render

render(callback?, updateObjectResolution?): any
强制渲染
Parameters
- Optional callback: (() => void)
  渲染完成回调
  - - (): void
    - Returns void
- updateObjectResolution: boolean = false
Returns any
Description
调用 five.render() 和设置 five.needsRender = true 均可在按需渲染时，使得画面渲染一次区别在于：
- five.needsRender = true 为在下帧渲染画面
- five.render() 在当前帧渲染画面推荐使用 five.needsRender = true, 可以更加流畅。但是如果需要截图等同步操作，可以使用 five.render()
- Defined in lib/five/application/five.ts:1755

requestFullscreen

requestFullscreen(): void
请求全屏

Returns void
- Defined in lib/five/application/five.ts:2588

reset

reset(): Promise<void>
Returns Promise<void>
- Defined in lib/five/application/five.ts:1401

reset_

reset_(): Promise<void>
Returns Promise<void>
- Defined in lib/five/application/five.ts:1411

setScissor

setScissor(scissor): void
设置 scissor
Parameters
- scissor: Scissor
  指定区域 scissor 是将屏幕中的内容渲染到 renderer 的指定区域。请确保在 five 初始化时传入 renderer 对象页面整体长宽均为 1。通过类似 css 的 left bottom width height 来确定区域。
Returns void
Example
```
five.setScissor({ left: 0.75, bottom: 0, width: 0.25, height: 1 })
```
- Defined in lib/five/application/five.ts:693

setState

setState(state, immediately?, userAction?): void

设置 State

Parameters

state: Partial<State>
目标状态
immediately: boolean = false
是否马上转换，马上转换会尽快达到目标状态，尽量减少中间状态，更少动画。
userAction: boolean = true
是否是用户触发的动作

Returns void

Description

five 设置了以下状态

- mode: Mode
- panoIndex: number
- longitude: number
- latitude: number
- fov: number
- offset: THREE.Vector3

可以通过 five.state 和 five.setState 来获取和设置。
通过 state 设置后，five 会通过合适的动画运动来达到设置的位置。
来迎合一些通过数据驱动的场景。

updateCamera

updateCamera(pose, duration, userAction?): Promise<void>
移动相机。（不触发点位移动）
Parameters
- pose: Partial<Pose>
  相机目标位置
- duration: number
  动画触发的时常
- userAction: boolean = true
  是否用户触发
Returns Promise<void>
Promise 是否移动成功

Description
如果动画中途被打断（用户触发行为，或者调用 setState, load, changeMode）的等会 Promise.reject。运动完成则 Promise.resolve
- Defined in lib/five/application/five.ts:998

updateCameraWithKeyframes

updateCameraWithKeyframes(keyframes, duration, userAction?): Promise<void>
通过帧动画移动相机。（不触发点位移动）
Parameters
- keyframes: {
      key?: string;
      progress: number;
      value: Pose;
  }[]
  动画帧
- duration: number
  动画触发的时常
- userAction: boolean = true
  是否用户触发
Returns Promise<void>
Promise 是否移动成功

Description
如果动画中途被打断（用户触发行为，或者调用 setState, load, changeMode）的等会 Promise.reject。运动完成则 Promise.resolve
- Defined in lib/five/application/five.ts:1013

updateConfiguration

updateConfiguration(args, refresh?): void
Parameters
- args: Pick<FiveInitArgs, "model" | "panorama" | "textureOptions" | "imageOptions" | "floorplan" | "topview" | "mapview" | "vrPanorama">
- refresh: boolean = true
Returns void
- Defined in lib/five/application/five.ts:797

updateTime

updateTime(time, deltaTime, ...args): void
Parameters
- time: number
- deltaTime: number
- Rest ...args: any[]
Returns void
- Defined in lib/five/application/five.ts:1795

waitUnitl

waitUnitl<K>(name): Promise<Parameters<EventTypes[K]>>
等待事件
Type Parameters
- K extends "error" | "dispose" | "gesture.pan" | "gesture.tap" | "gesture.press" | "gesture.pinch" | "gesture.mousewheel" | "gesture.mousemove" | "gesture.momentum" | "initAnimation.start" | "initAnimation.end" | "camera.update" | "intersect.update" | "pano.select" | "pano.request" | "pano.moveTo" | "pano.moving" | "pano.arrived" | "pano.cancel" | "pano.error" | "pano.texture.load" | "pano.texture.progress" | "pano.texture.success" | "pano.texture.error" | "pano.texture.abort" | "xr.session.end" | "xr.session.start" | "xr.gesture.tap" | "xr.gesture.press" | "xr.gesture.buttonUp" | "xr.gesture.buttonDown" | "xr.controller.update" | (keyof LegacyEventType) | "works.request" | "works.load" | "works.ready" | "state.set" | "state.change" | "state.synced" | "currentState.change" | "model.request" | "model.load" | "model.error" | "model.changeShownFloor" | "models.load" | "models.refined" | "render.prepare" | "render" | "mode.change.request" | "mode.change" | "helpers.visible" | "network.resource" | "fps"
  预设的监听事件名称
Parameters
- name: K
  事件类型
Returns Promise<Parameters<EventTypes[K]>>
触发事件的数据
Inherited from Subscribe.waitUnitl
- Defined in lib/five/utils/subscribe.ts:159

Class Five

Example

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns Five

Properties

camera

currentMode

ident

imageOptions

Description

info

Type declaration

memory: { geometries: number; textures: number; }

geometries: number

textures: number

render: { calls: number; frame: number; lines: number; points: number; triangles: number; }

calls: number

frame: number

lines: number

points: number

triangles: number

modelRenderTarget

modelScene

modelSceneNeedsRender

Description

models

needsRender

Description

pano

paused

Description

plugins

Type declaration

[key: string]: FivePluginInstance<any>

Optional renderer

Description

scene

scissor

Description

Example

state

Description

textureOptions

Description

videoTexture

Description

xrCustomObjectsScene

Static Line

Deprecated

Static Mode

Description

Accessors

enableEDL

Returns boolean

Parameters

Returns void

enableHQ

Returns boolean

Parameters

Returns void

enableIOSEDR

Returns boolean

Parameters

Returns void

enablePostProcessing

Returns boolean

Parameters

Returns void

helperVisible

Returns boolean

Parameters

Returns void

memory: {
geometries: number;
textures: number;
}

render: {
calls: number;
frame: number;
lines: number;
points: number;
triangles: number;
}

`Optional` renderer

`Static` Line

`Static` Mode

`Static` dracoPath

`Static` ktx2Path

`Static` version

`Optional` height?: number

`Optional` width?: number

Returns {
lookAtVector: Vector3;
phi: number;
theta: number;
}