abstract Marker(markerOptions)

所有标记类的基础。

使用指定的选项创建要插入到沙箱中的标记。 如果指定了沙箱(别名:地球),则在构建时将标记添加到沙箱中。

标记空间是起源于指定位置的当地Cooridnate系统。 X向东,Y向北,Z沿地球正常。

new abstract Marker(markerOptions)

创建标记的实例。

Parameters:
Name Type Description
markerOptions object

初始化选项

Properties
Name Type Attributes Default Description
position LngLatAlt

标记位置

earth Earth

标记附加的地球

sandbox Earth

地球的别名

visible bool <optional>
true

显示标记

name string <optional>
unknown

标记的名称

interactable bool <optional>
false

这个标记是否会响应鼠标事件

patrolRoutes function <optional>

标记的路线数据

Members

euler :object

Eular角度表示中的方向。 {x:绕X轴以弧度为单位的旋转角度,  y:弧度,  z:弧度,  顺序:旋转顺序,默认'XYZ'}。  用这个代替方向 如果你不熟悉数学。

See:
Example

Set orientation by Eular angles

 marker.euler = {x: Math.PI/6, y: Math.PI/4, z: Math.PI/3} // rotate around X-axis for 30 degree; Y for 45 degree; Z for 60 degree, in that order.
 marker.euler = {y: Math.PI/2} // rotate around Y-axis for 90 degree.

readonly ID :string

获取唯一的ID。

interactable :bool

如果标记是可交互的,则设置。设置为true以响应鼠标事件。

Example

Set interactable

 marker.interactable = true // make this marker interactable
 marker.interactable = !marker.interactable // flip interactable status

name :string

一串名字。

Example

Set name

 marker.name = 'this marker' // set name as 'this marker'
 marker.name = marker.name + ' suffix' // extend the name

orientation :object

通过均匀四元数{x,y,z,w}设置旋转。 使用EULAR 相反,如果你不知道如何使用这个。

See:
Example

Set orientation

 marker.orientation = {x: 0, y: 0, z: 0, w: 1}

position :LngLatAlt

改变当前位置{lng,lat,alt}。

Example

Set position

 marker.position = {
   lng: 113.93977612840078,
   lat: 22.5364271949327,
   alt: 12.3
 }

scale :number

设置标记的比例。

Example

Set scale

 marker.scale = 2.0 // set scale to 2.0
 marker.scale = marker.scale * 2.0 // make it two times bigger

visible :bool

设置标记的可见性。

Example

Set visible

 marker.visible = false // make this marker invisible
 marker.visible = !marker.visible // flip visible status

x :number

在x方向上设置标记的比例。

Example

Set scale x

 marker.x = 2.0 // set scale x to 2.0
 marker.x = marker.x * 2.0 // make it two times bigger in x direction

y :number

在y方向上设置标记的比例。

Example

Set scale y

 marker.y = 2.0 // set scale y to 2.0
 marker.y = marker.y * 2.0 // make it two times bigger in y direction

z :number

在z方向上设置标记的比例。

Example

Set scale z

 marker.z = 2.0 // set scale z to 2.0
 marker.z = marker.z * 2.0 // make it two times bigger in z direction

Methods

abstract animate(options)

传播的事件,正在渲染的新帧。

Parameters:
Name Type Description
options object

abstract destruct()

从沙箱中移除该标记并释放占用的资源。

Example

Destruct a marker

 marker.destruct()

detachControl()

分离并隐藏标记的控件小控件

Example

Detach control

 marker.detachControl()

dim()

Un-highlight the marker. (hide the blue fence of the marker)

Example

Un-highlight

 marker.dim()

light()

Highlight the marker. (show the blue fence of the marker)

Example

Highlight

 marker.light()

off(eventType, handler)

从事件中取消注册处理程序。

Parameters:
Name Type Description
eventType string
handler function
Example

Un-register interaction events

 marker.off('click')
 marker.off('mouseover')
 marker.off('mouseenter')
 marker.off('mouseleave')

on(eventType, handler)

用处理程序注册一个事件。 注意:一个事件只能有一个处理程序。

Parameters:
Name Type Description
eventType string

'click','mouseover','mouseenter','mouseleave'

handler function

事件处理器

Example

Register interaction events

 marker.on('click', function (event) {
   console.log('click on marker ', marker, event)
 })
 marker.on('mouseover', function (event) {
   console.log('mouse over marker ', marker, event)
 })
 marker.on('mouseenter', function (event) {
   console.log('mouse enter marker ', marker, event)
 })
 marker.on('mouseleave', function (event) {
   console.log('mouse leave marker ', marker, event)
 })
 marker.interactable = true // the marker must be interactable for events to take effects

orientationByHorizontalPoints(pts, flip) → {Quaternion}

从水平点得到重新定位的方向

Parameters:
Name Type Default Description
pts Array.<LngLatAlt>
flip bool false
Returns:
Quaternion

abstract sceneUpdated(options)

传播的定期事件处理程序。当场景内容更新时触发。

Parameters:
Name Type Description
options object

setControlMode(mode)

设置控件Gizmo的模式

Parameters:
Name Type Description
mode string

控件gizmo'translate','rotate'的模式

Example

Set the mode of the control

 marker.setControlMode('translate')
 marker.setControlMode('rotate')

shapeToEarth() → {Matrix4}

从shapeHolder-space到地球空间的变换矩阵

Returns:
Matrix4

shapeToScene() → {Matrix4}

从shapeHolder-space到scene-root的变换矩阵

Returns:
Matrix4

showControl(mode)

播放标记的{index}巡视路线

Parameters:
Name Type Description
mode string

控件gizmo的模式:'translate','rotate'

Example

Show control

 marker.showControl('translate') // show control used for translate
 marker.showControl('rotate') // show control used for rotate

abstract updateVisibility(options)

传播事件,屏幕可见性正在更新。

Parameters:
Name Type Description
options object