Class: ProjectionImage

ProjectionImage

new ProjectionImage(scene)

视频投放类。将图片或视频投放到场景中，可模拟建筑物上的广告幕布或大屏电视效果。

Name Type Description
scene Object

指定用于分析的场景对象。
Throws:

必须指定场景scene。

Type
DeveloperError
Example
//创建视频投放
var projectionImagee= new SuperMap3D.ProjectionImage(scene);.

Members

brightnessnumber

颜色调节 亮度

Default Value:
1.0

contrastnumber

颜色调节 对比度

Default Value:
1.0

directionnumber

获取或设置视频投放时投影仪的方位角，即顺时针与正北方向的夹角，取值范围：0度~360度。

Default Value:
0.0

distancenumber

获取或设置观察点到投影仪的距离。

Default Value:
200.0

fusionAlphanumber

获取或者设置视频投放的透明度

Default Value:
1.0

gammanumber

颜色调节 gamma

Default Value:
1.0

hintLineColorColor

获取或设置视频投放时提示线的颜色。

Default Value:
SuperMap3D.Color(1.0,1.0,1.0,1.0)

hintLineVisibleboolean

获取或设置视频投放时提示线的可见性。

Default Value:
true

horizontalFovnumber

获取或设置视频投放时投影仪的水平视角范围，单位：度。

Default Value:
90.0

huenumber

颜色调节 色调

Default Value:
0.0

modeProjectionMode

获取或者设置视频投放的渲染模式

Default Value:
ProjectionMode.ProjectToScene

pitchnumber

获取或设置视频投放时投影仪的俯仰角，该角指相机方向和水面方向的夹角，取向上为正，单位：度。

Default Value:
0.0

rollnumber

获取或设置视频投放时投影仪的翻滚角，该角绕相机方向的翻滚角度，顺时针为正，单位：度。

Default Value:
0.0

saturationnumber

颜色调节 饱和度

Default Value:
1.0

verticalFovnumber

获取或设置视频投放时投影仪的垂直视角范围，单位：度。

Default Value:
60.0

viewPositionArray

获取或设置视频投放观察者的位置。位置由经度、纬度和高程组成的数组表示。

Default Value:
[0.0,0.0,0.0]

visibleboolean

获取或者设置视频投放是否可见，默认为true。

Default Value:
true

visibleDistanceMaxnumber

获取或者设置视频投放的最大可见距离。(相机与视频投放位置的最大可见距离）

Default Value:
500

Methods

static fromInfo(scene, infoUrl, baseUrl){Promise}

从文件中读取多路视频，即通过文件同时添加多个视频进行投放。

Name Type Description
scene Scene

进行投放的场景
infoUrl string

视频的属性信息文件的地址或者路径
baseUrl string 可选

基础路径。 如果添加，则会和文件中视频的名字拼接成一个路径，如果不添加，则使用infoUrl文件中的父级路径作为baseUrl。
Returns:
Type Description
Promise 返回promise，包含创建的ProjectionImage对象。
Example
SuperMap3D.ProjectionImage.fromInfo(scene, './data/allprojectionInfo.xml', './media/')

addClipRegion(){boolean}

添加裁剪多边形。

Name Type Description
options.name string

多边形的名称
options.position Cartesian3

多边形的位置
Returns:
Type Description
boolean 多边形是否添加成功

build()

执行视频投放分析。

destroy()

销毁视频投放对象持有的资源。

getVisibleInViewport(index){boolean}

获取视频投放分析在指定视口的可见性。

Name Type Description
index number

指定的视口索引。
Throws:

索引值的范围为0-3。

Type
DeveloperError
Returns:
Type Description
boolean visible 可见性。

pixelToWorldCoordinates(x, y){Cartesian3}

图片像素坐标转地理坐标。

Name Type Description
x Cartesian3 可选

图片像素的x坐标
y Cartesian3 可选

图片像素的y坐标
Returns:
Type Description
Cartesian3 图片像素位置对应的地理坐标

pixelToWorldCoordinatesAsync(){Cartesian3}

异步的图片像素坐标转世界坐标

Returns:
Type Description
Cartesian3 图片像素位置对应的世界坐标

removeAllClipRegion(){boolean}

删除所有多边形。

Returns:
Type Description
boolean 是否删除成功

removeClipRegion(name){boolean}

删除指定名称的多边形。

Name Type Description
name string 可选

多边形名称
Returns:
Type Description
boolean 是否删除成功

setClipMode(mode){boolean}

设置裁剪模式。

Name Type Description
mode ModifyRegionMode

裁剪模式
Returns:
Type Description
boolean 是否添加成功

setDistDirByPoint(position)

通过点的[经度，纬度，高度]设置方向。

Name Type Description
position Array

位置
Throws:

位置是[经度，纬度，高度]并且不等于viewPosition。

Type
DeveloperError

setFusionLayers(layers)

设置图片融合的S3M图层。

Name Type Description
layers Array.<S3MTilesLayer>

S3M图层

setImage()

设置用于投放的图片或视频对象。

Name Type Description
options.url Array

指定图片资源的地址。
options.video Object

指定视频的地址，目前仅支持*.webm格式的视频，目前只支持.webm。
Throws:

必须指定options.url或options.video。

Type
DeveloperError

setInfo(url){Promise}

设置视频投放的位置信息，这些位置信息被保存在一个.xml的文件中，通过读取该文件的内容进行设置。

Name Type Description
url string

存储位置信息的文件的地址。
Returns:
Type Description
Promise

setVisibleInViewport(index)

设置视频投放分析在指定视口的可见性。

Name Type Description
index number

指定的视口索引。
Throws:

索引值的范围为0-3。

Type
DeveloperError