# Graphic

#### new Cesium.Graphic(options)
MapGIS/Entity/Graphic.js 78

图元

Name | Type | Description
--- | --- | ---
`options` | Object |
Name | Type | Default | Description
--- | --- | --- | ---
`type` | String |  | optional 图元类型`Graphic.graphicType` // * @param {String} [options.id] 图元ID
`positions` | Array.<Cartesian3> | Array.<Number> |  | optional 图元坐标信息,笛卡尔世界坐标为cartesian3,经纬度数组为例如[-115.0, 37.0, 100000.0, -107.0, 33.0, 150000.0]
`style` | Object |  | optional 图元样式信息 详情参见`Style`
`editPointStyle` | Object |  | optional 编辑点样式信息 详情参见`Style.EditPointStyle`
`attributes` | Object |  | optional 图元属性
`name` | String |  | optional 图元名称
`show` | Boolean | `true` | optional 图元是否显示
`asynchronous` | Boolean | `false` | optional 默认为阻塞式更新，true为异步更新，false为阻塞式更新。
`heading` | Number | `0.0` | optional 偏航角，弧度。
`pitch` | Number | `0.0` | optional 俯仰角，弧度。
`roll` | Number | `0.0` | optional 翻滚角，弧度。
`transformX` | Number | `0.0` | optional 局部坐标系X方向平移量，单位米，X方向为纬线方向
`transformY` | Number | `0.0` | optional 局部坐标系Y方向平移量，单位米，Y方向为经线方向
`transformZ` | Number | `0.0` | optional 局部坐标系Z方向平移量，单位米，Z方向为垂直地表方向

##### Example:

    var graphic = new Graphic({type:label,style:{text:'mapgis'}});

### Members

#### static Cesium.Graphic.graphicType
MapGIS/Entity/Graphic.js 1887

图元类型

##### Properties:

Name | Type | Attributes | Default | Description
--- | --- | --- | --- | ---
`point` | String | <optional> | 'point' | 点，类型（type）为point时样式参数参照`Style.PointStyle`
`label` | String | <optional> | 'label' | 文本,类型（type）为label时样式参数参照`Style.LabelStyle`
`billboard` | String | <optional> | 'billboard' | 广告牌，类型(type)为billboard时样式参数参照`Style.BillboardStyle`
`polyline` | String | <optional> | 'polyline' | 线，类型(type)为polyline时样式参数参照`Style.PolylineStyle`
`polylineVolume` | String | <optional> | 'polylineVolume' | 圆管线，类型(type)为polylineVolume时样式参数参照`Style.PolylineVolumeStyle`
`polygon` | String | <optional> | 'polygon' | 面（区），类型(type)为polygon时样式参数参照`Style.PolygonStyle`
`rectangle` | String | <optional> | 'rectangle' | 矩形，类型(type)为rectangle时样式参数参照`Style.RectangleStyle`
`square` | String | <optional> | 'square' | 正方形，类型(type)square`Style.SquareStyle`
`circle` | String | <optional> | 'circle' | 圆，类型(type)为circle时样式参数参照`Style.CircleStyle`
`corridor` | String | <optional> | 'corridor' | 方管线，类型(type)为corridor时样式参数参照`Style.CorridorStyle`
`cylinder` | String | <optional> | 'cylinder' | 圆台（圆锥），类型(type)为cylinder时样式参数参照`Style.CylinderStyle`
`ellipsoid` | String | <optional> | 'ellipsoid' | 椭球，类型(type)为ellipsoid时样式参数参照`Style.EllipsoidStyle`
`sphere` | String | <optional> | 'sphere' | 圆球，类型(type)为sphere时样式参数参照`Style.SphereStyle`
`wall` | String | <optional> | 'wall' | 墙，类型(type)为wall时样式参数参照`Style.WallStyle`
`box` | String | <optional> | 'box' | 盒子,类型（type）为box时样式参数参照`Style.BoxStyle`
`model` | String | <optional> | 'model' | gltf模型,类型（type）为model时样式参数参照`Style.ModelStyle`

#### allowPicking : Boolean
MapGIS/Entity/Graphic.js 296

图形对象是否可以选中

#### asynchronous : Boolean
MapGIS/Entity/Graphic.js 303

图形对象是否阻塞更新，一般设置为false避免更新时闪烁

#### readonly attributes : Object
MapGIS/Entity/Graphic.js 238

图形对象属性键值对

#### readonly boundingSphere : BoundingSphere
MapGIS/Entity/Graphic.js 213

图元对象包围盒

#### coordinate : Array.<Cartesian3>
MapGIS/Entity/Graphic.js 196

图形实体位置数组(经纬度+高程，度)

#### editing : Boolean
MapGIS/Entity/Graphic.js 281

图形对象是否在编辑状态

#### heading : Number
MapGIS/Entity/Graphic.js 310

图形对象偏航角，弧度。

#### readonly id : String
MapGIS/Entity/Graphic.js 176

图形ID

#### isPoint : Boolean
MapGIS/Entity/Graphic.js 263

图形是否为点，文本或者广告牌

#### readonly modelMatrix : Matrix4
MapGIS/Entity/Graphic.js 205

图元对象旋转平移矩阵

#### name : Number
MapGIS/Entity/Graphic.js 249

图形对象名称

#### readonly parentLayer : GraphicsLayer
MapGIS/Entity/Graphic.js 163

图元父图层

#### pitch : Number
MapGIS/Entity/Graphic.js 317

图形对象俯仰角，弧度。

#### positions : Array.<Cartesian3>
MapGIS/Entity/Graphic.js 187

图形实体位置数组

#### readonly primitive : Primitive
MapGIS/Entity/Graphic.js 352

图形对象primitive

#### roll : Number
MapGIS/Entity/Graphic.js 324

图形对象翻滚角，弧度。

#### show : Boolean
MapGIS/Entity/Graphic.js 274

图形是否显示

#### readonly style : Style
MapGIS/Entity/Graphic.js 223

图元对象样式信息

##### Example:

    var graphic = new Graphic({type:label,style:{text:'mapgis'}});
    graphic.style.text = 'mapgispro';

#### transformX : Number
MapGIS/Entity/Graphic.js 331

图形对象局部坐标系X方向平移量，单位米，X方向为纬线方向

#### transformY : Number
MapGIS/Entity/Graphic.js 338

图形对象局部坐标系y方向平移量，单位米，y方向为经线方向

#### transformZ : Number
MapGIS/Entity/Graphic.js 345

图形对象局部坐标系z方向平移量，单位米，z方向为垂直地表方向

#### readonly type : String
MapGIS/Entity/Graphic.js 151

图元类型 参照`Graphic.graphicType`

### Methods

#### addAttributes(key, value)
MapGIS/Entity/Graphic.js 1706

给图元添加属性字段

Name | Type | Description
--- | --- | ---
`key` | String | 关键字
`value` | String | Object | 值

#### addTo(layer)
MapGIS/Entity/Graphic.js 1761

添加到图层上，同 layer.addGraphic

Name | Type | Description
--- | --- | ---
`layer` | GraphicsLayer | 图层对象

#### getDistances() → Array.<Number>
MapGIS/Entity/Graphic.js 1770

计算顶点坐标之间的距离

##### Returns:

返回坐标之间的距离数组

#### remove()
MapGIS/Entity/Graphic.js 1842

从图层中移除图元