# Video3D
查阅Cesium API

#### new mars3d.graphic.Video3D(options)
graphic/custom/Video3D.js 50

视频融合（投射3D，贴物体表面），该对象暂不支持鼠标交互和拾取

参数名称 | 类型 | 描述信息
--- | --- | ---
`options` | object | 参数对象，包括以下：
参数名称 | 类型 | 默认值 | 描述信息
--- | --- | --- | ---
`position` | LngLatPoint | Cesium.Cartesian3 | Array.<number> |  | 相机位置
`targetPosition` | LngLatPoint | Cesium.Cartesian3 | Array.<number> |  | 可选 目标视点位置,可以替代style中的相机heading\pitch\roll方向和distance距离参数
`style` | Video3D.StyleOptions |  | 样式信息
`attr` | object | BaseGraphic.AjaxAttr |  | 可选 附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
`play` | boolean | `true` | 可选 初始化后默认是播放还是停止状态
`synchronizer` | boolean |  | 可选 是否内部加VideoSynchronizer同步时钟
`id` | string | number | `createGuid()` | 可选 矢量数据id标识
`name` | string |  | 可选 矢量数据名称
`show` | boolean | `true` | 可选 矢量数据是否显示
`eventParent` | BaseClass | boolean |  | 可选 指定的事件冒泡对象，默认为所加入的图层对象，false时不冒泡事件
`flyTo` | boolean |  | 可选 加载完成数据后是否自动飞行定位到数据所在的区域。
`flyToOptions` | object |  | 可选 加载完成数据后是否自动飞行定位到数据所在的区域的对应 `BaseGraphic#flyTo`方法参数。

##### 参考:

- `支持的事件类型`

### 继承自

- ViewShed

### 属性值

#### angle : number
graphic/custom/ViewShed.js 91

水平张角，半场角度

继承自:
  - ViewShed#angle

#### angle2 : number
graphic/custom/ViewShed.js 104

垂直张角，半场角度

继承自:
  - ViewShed#angle2

#### 只读 camera : Cesium.Camera
graphic/custom/ViewShed.js 189

相机对象

继承自:
  - ViewShed#camera

#### 只读 container : HTMLVideoElement
graphic/custom/Video3D.js 90

对应的视频DOM元素

#### distance : number
graphic/custom/Video3D.js 98

最远投射距离，单位：米

#### flipx : boolean
graphic/custom/Video3D.js 111

是否X方向翻转视频

#### hiddenAreaColor : Cesium.Color
graphic/custom/ViewShed.js 129

不可视区域颜色

继承自:
  - ViewShed#hiddenAreaColor

#### opacity : number
graphic/custom/ViewShed.js 141

混合系数0-1

继承自:
  - ViewShed#opacity

#### play : boolean
graphic/custom/Video3D.js 123

暂停或播放 视频

#### 只读 shadowMap : Cesium.ShadowMap
graphic/custom/ViewShed.js 180

场景的ShadowMap阴影图

继承自:
  - ViewShed#shadowMap

#### showFrustum : boolean
graphic/custom/ViewShed.js 153

是否显示视椎体框线

继承自:
  - ViewShed#showFrustum

#### targetPosition : Cesium.Cartesian3|LngLatPoint
graphic/custom/ViewShed.js 197

目标点位置(笛卡尔坐标)

继承自:
  - ViewShed#targetPosition

#### visibleAreaColor : Cesium.Color
graphic/custom/ViewShed.js 117

可视区域颜色

继承自:
  - ViewShed#visibleAreaColor

### 方法

#### setOpacity(value) → void
graphic/custom/ViewShed.js 574

设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。 对象本身透明度请用 graphic.setStyle({ opacity: value })

参数名称 | 类型 | 描述信息
--- | --- | ---
`value` | number | 透明度

##### 返回值:

无

继承自:
  - ViewShed#setOpacity

#### setView() → void
graphic/custom/ViewShed.js 552

定位至相机的第一视角

##### 返回值:

无

继承自:
  - ViewShed#setView

#### startDraw(layer) → void
graphic/custom/ViewShed.js 585

开始绘制矢量数据，绘制的数据会加载在layer图层。

参数名称 | 类型 | 描述信息
--- | --- | ---
`layer` | GraphicLayer | 图层

##### 返回值:

无

继承自:
  - ViewShed#startDraw

#### stopDraw() → void
graphic/custom/ViewShed.js 610

停止绘制

##### 返回值:

无

继承自:
  - ViewShed#stopDraw

### 定义的类型

#### mars3d.graphic.Video3D.StyleOptions
graphic/custom/Video3D.js 23

视频融合（投射3D，贴物体表面） 支持的样式信息

##### 属性:

属性名称 | 类型 | 可选 | 默认值 | 描述信息
--- | --- | --- | --- | ---
`container` | HTMLVideoElement | <可选> |  | video视频DOM容器
`url` | string | <可选> |  | 视频的URL路径,与DOM二选一
`maskImage` | string | <可选> |  | 遮盖融合的图片url地址，可以用于视频的四周羽化效果。
`angle` | number |  |  | 水平张角(度数)，半场角度
`angle2` | number |  |  | 垂直张角(度数)，半场角度
`distance` | number | <可选> |  | 投射最远距离，单位：米
`heading` | number | <可选> | 0 | 方向角 （度数值，0至360度）
`pitch` | number | <可选> | 0 | 俯仰角（度数值，0至360度）
`roll` | number | <可选> | 0 | 翻滚角（度数值，0至360度）
`opacity` | number | <可选> | 1.0 | 透明度 0.0 - 1.0
`flipx` | boolean | <可选> | false | 是否X方向翻转图片
`flipy` | boolean | <可选> | false | 是否Y方向翻转图片
`hiddenAreaColor` | Cesium.Color | string | <可选> | new Cesium.Color(0, 0, 0, 0.5) | 无视频投影区域的颜色
`showFrustum` | boolean | <可选> | false | 是否显示视椎体框线
`distanceDisplayCondition` | boolean | Cesium.DistanceDisplayCondition | <可选> | false | 是否按视距显示 或 指定此框将显示在与摄像机的多大距离。
`distanceDisplayCondition_far` | number | <可选> | Number.MAX_VALUE | 最大距离
`distanceDisplayCondition_near` | number | <可选> | 0 | 最小距离