GraphicsLayer - YouScene Documentation

GraphicsLayer

矢量几何图层

new YS.GraphicsLayer(options, global)

矢量几何形状图层，管理Graphics类数据，常用addEntity和addGeometry，add方法；推荐使用add方法

Name Type Description

options

Object

对象有下面这些属性:

Name	Type	Default	Description
`id`	String		optional 唯一标识
`name`	String		optional 名称
`category`	String		optional 图层分组
`visible`	Boolean	`true`	optional 是否可见
`isAddTree`	Boolean	`true`	optional 是否添加到图层树上
`treeIcon`	String		optional 图层树上显示的图标，默认不显示

global YSEarth ys.earth

Implements:

FloatLayer

Example:

var graphicsLayer = youScene.layers.addGraphicsLayer({
           id:'GraphicsLayer',
           name:'GraphicsLayer',
           visible: true,
           isAddTree: true
       });

Demo:

http://ys.infoearth.com:9090/Sandcastle/index.html#name=GraphicsLayer

Methods

add(options) → Graphics

添加数据实体

Name	Type	Description
`options`	Graphics \| Object	要添加的Graphics实例或者构造Graphics的参数

Returns:

返回添加的数据对象

Example:

graphicsLayer.add(new YS.Graphics({
          color: { r: 0, g: 1, b: 1, a: 1 },
          position: { x: 109.0, y: 25.0, z: 100000 },
          box: { x: 100000, y: 100000, z: 100000 }
      }));

addEntity(options) → Graphics

添加数据实体

Name Type Description

options

Object | Cesium.Entity

要添加的数据对象或者Graphics实例

Name	Type	Description
`id`	String	optional 对象的唯一标识符。如果没有提供，则生成GUID。
`name`	String	optional 向用户显示的可读名称，名称可不必唯一。
`show`	Boolean	optional 是否显示实体对象及其子项。
`position`	PositionProperty	optional 实体的位置。
`box`	BoxGraphics	optional 与此实体关联的盒子对象。
`corridor`	CorridorGraphics	optional 与实体关联的走廊对象。
`cylinder`	CylinderGraphics	optional 与实体关联的圆柱体对象。
`ellipse`	EllipseGraphics	optional 与实体关联的椭圆形对象。
`ellipsoid`	EllipsoidGraphics	optional 与实体关联的椭球体对象。
`path`	PathGraphics	optional 与实体关联的路径对象。
`polylineVolume`	PolylineVolumeGraphics	optional 与实体关联的多段线柱体对象。
`rectangle`	RectangleGraphics	optional 与实体关联的矩形对象。
`wall`	WallGraphics	optional 与实体关联的围墙对象。

Returns:

返回添加的数据对象

Example:

graphicsLayer.addEntity({
          position: Cesium.Cartesian3.fromDegrees(107.0, 32.0),
          ellipse: {
              semiMinorAxis: 300000.0,
              semiMajorAxis: 300000.0,
              outline: true,
              outlineColor: Cesium.Color.RED,
              outlineWidth: 4,
              height: 0,
              material: Cesium.Color.WHITE             
          }
      });

addLayer(global)

添加图层

Name	Type	Description
`global`	Object	三维球对象（YouScene.earth）

addPrimitive(options) → Graphics

添加数据几何

Name Type Description

options

Object | Cesium.Primitive

要添加的数据对象或者Graphics实例

Name	Type	Default	Description
`id`	String		optional 对象的唯一标识符。如果没有提供，则生成GUID。
`show`	Boolean		optional 是否显示实体对象及其子项。
`color`	Color	`Cesium.Color.WHITE`	optional 几何的绘制颜色
`geometry`	Cesium.Geometry		optional 几何对象,instance和geometry任意有一个即可
`appearance`	Cesium.Appearance	`PerInstanceColorAppearance`	optional 外观形式，默认单色
`instance`	Cesium.GeometryInstance		optional 几何实例，instance和geometry任意有一个即可

Returns:

返回添加的数据对象

Example:

graphicsLayer.addPrimitive({
      show: true,
      color: Cesium.Color.RED,
      geometry: new Cesium.CircleGeometry({
          center: YS.MathEngine.xyzToCartesian3({ x: 102, y: 25, z: 10000 }),
          radius: 100000//米  
      })
  });

clear()

清空

destroy()

销毁

Implements:

getById(id) → Feature

根据id获取图层内对象

Name	Type	Description
`id`	String	对象的id

Returns:

返回查找到的对象，找不到返回undefined

Implements:

FloatLayer#getById

getByIndex(index) → Feature

根据索引获取图层内对象

Name	Type	Description
`index`	Number	对象的索引号，[0, count)

Returns:

返回查找到的对象，找不到返回undefined

Implements:

FloatLayer#getByIndex

remove(feature) → Boolean

移除数据

Name	Type	Description
`feature`	Graphics	实体数据对象

Returns:

删除成功返回true，失败返回false

removeById(id) → Boolean

通过id移除数据

Name	Type	Description
`id`	String	唯一标识

Returns:

删除成功返回true，失败返回false