ScreenObj

new CooSDK.ScreenObj(props)

分屏窗口对象。分屏是将三维场景进行多屏展示的功能。每个子屏都会独立渲染自身加载的数据，通过分屏功能，可以在同一位置加载不同数据进行数据对比。

Name Type Description
props Object optional

包含如下属性的Object：

Name Type Default Description
aspect Number 1 optional

分屏窗口相机宽高比。
backColor ColorObj null optional

天空盒背景颜色，其与textureUrl为互斥选项，如未设置则以textureUrl参数设置为准。
center Vector3Obj new Vector3Obj(0,0,0) optional

分屏窗口初始中心点。建议不需要改动。
eye Vector3Obj new Vector3Obj(0,0,15) optional

分屏窗口初始观察点。建议不需要改动。
fovy Number 35 optional

分屏窗口相机视野角度。
isOrtho Boolean false optional

分屏窗口相机是否为正交投影模式，false表示透视投影。
name String "" optional

分屏窗口相机名称。
renderOrder Number 2 optional

分屏窗口绘制顺序。
textureUrl String null optional

天空盒背景纹理，其与backColor为互斥选项，如未设置则采用默认纹理。
up Vector3Obj new Vector3Obj(0,1,0) optional

分屏窗口初始上方向。建议不需要改动。
viewPort Vector4Obj new Vector4Obj(0.5,0,0.5,1) optional

分屏窗口大小。用百分比表示。4个参数分别代表：x轴起始点比例，y轴起始点比例，宽度比例、高度比例（均基于三维地图窗口）。
zFar Number 68000000 optional

分屏窗口相机远截面距离。
zNear Number 100 optional

分屏窗口相机近截面距离。
Example:
// 创建分屏窗口对象，屏幕位置为屏幕右侧半屏
var screenObj = new CooSDK.ScreenObj({
     name: "屏幕1",
     viewPort: new CooSDK.Vector4Obj(0.5, 0, 0.5,1)
});

// 通常在创建分屏后，原先主屏也应相应改变大小，屏幕位置为屏幕左侧半屏
cooMap.viewPort = new CooSDK.Vector4Obj(0, 0, 0.5, 1);
Demo:

Members

aspect : Number

获取或者设置分屏窗口相机宽高比。

Default Value: 1

backColor : ColorObj

获取或者设置天空盒背景颜色，其与textureUrl为互斥选项，如未设置则以textureUrl参数设置为准。

Default Value: null

center : Vector3Obj

获取或者设置分屏窗口初始中心点。建议不需要改动。

Default Value: new Vector3Obj(0,0,0)

eye : Vector3Obj

获取或者设置分屏窗口初始观察点。建议不需要改动。

Default Value: new Vector3Obj(0,0,15)

fovy : Number

获取或者设置分屏窗口相机视野角度。

Default Value: 35

isOrtho : Boolean

获取或者设置分屏窗口相机是否为正交投影模式，false表示透视投影。

Default Value: false

name : Stirng

获取或者设置分屏窗口相机名称。

Default Value: ""

renderOrder : Number

获取或者设置分屏窗口绘制顺序。

Default Value: 2

textureUrl : String

获取或者设置天空盒背景纹理，其与backColor为互斥选项，如未设置则采用默认纹理。

Default Value: null

up : Vector3Obj

获取或者设置分屏窗口初始上方向。建议不需要改动。

Default Value: new Vector3Obj(0,1,0)

viewPort : Vector4Obj

获取或者设置分屏窗口大小。用百分比表示。4个参数分别代表：x轴起始点比例，y轴起始点比例，宽度比例、高度比例（均基于三维地图窗口）。

Default Value: new Vector4Obj(0.5,0,0.5,1)

zFar : Number

获取或者设置分屏窗口相机远截面距离。

Default Value: 68000000

zNear : Number

获取或者设置分屏窗口相机近截面距离。

Default Value: 100

Methods

destroy()

从场景中销毁自身。

Returns:

null 空值。

Example:
// 销毁对象
screenObj = screenObj.destroy();
// 通常主屏需要自行还原
cooMap.viewPort = new CooSDK.Vector4Obj(0, 0, 1, 1);

update(props)

更新相关参数。

Name Type Description
props Object optional

包含如下属性的Object：

Name Type Default Description
viewPort Vector4Obj new Vector4Obj(0.5,0,0.5,1) optional

分屏窗口大小。用百分比表示。4个参数分别代表：x轴起始点比例，y轴起始点比例，宽度比例、高度比例（均基于三维地图窗口）。
Example:
// 修改屏幕位置大小为屏幕上侧半屏
screenObj.viewPort = new CooSDK.Vector4Obj(0, 0, 1, 0.5);
// 修改屏幕位置大小为屏幕下侧半屏
cooMap.viewPort = new CooSDK.Vector4Obj(0, 0.5, 1, 0.5);