Class: GroundPolylinePrimitive

// 1. Draw a polyline on terrain with a basic color material

var instance = new SuperMap3D.GeometryInstance({
  geometry : new SuperMap3D.GroundPolylineGeometry({
     positions : SuperMap3D.Cartesian3.fromDegreesArray([
         -112.1340164450331, 36.05494287836128,
         -112.08821010582645, 36.097804071380715
     ]),
     width : 4.0
  }),
  id : 'object returned when this instance is picked and to get/set per-instance attributes'
});

scene.groundPrimitives.add(new SuperMap3D.GroundPolylinePrimitive({
  geometryInstances : instance,
  appearance : new SuperMap3D.PolylineMaterialAppearance()
}));

// 2. Draw a looped polyline on terrain with per-instance color and a distance display condition.
// Distance display conditions for polylines on terrain are based on an approximate terrain height
// instead of true terrain height.

var instance = new SuperMap3D.GeometryInstance({
  geometry : new SuperMap3D.GroundPolylineGeometry({
     positions : SuperMap3D.Cartesian3.fromDegreesArray([
         -112.1340164450331, 36.05494287836128,
         -112.08821010582645, 36.097804071380715,
         -112.13296079730024, 36.168769146801104
     ]),
     loop : true,
     width : 4.0
  }),
  attributes : {
     color : SuperMap3D.ColorGeometryInstanceAttribute.fromColor(SuperMap3D.Color.fromCssColorString('green').withAlpha(0.7)),
     distanceDisplayCondition : new SuperMap3D.DistanceDisplayConditionGeometryInstanceAttribute(1000, 30000)
  },
  id : 'object returned when this instance is picked and to get/set per-instance attributes'
});

scene.groundPrimitives.add(new SuperMap3D.GroundPolylinePrimitive({
  geometryInstances : instance,
  appearance : new SuperMap3D.PolylineColorAppearance()
}));

Members

readonly allowPickingBoolean

当为true时，每个几何实例只能通过Scene#pick进行拾取。当为false时，可以节省 GPU 内存。

Default Value:

true

Methods

static initializeTerrainHeights(){Promise}

初始化地形的最小高度和最大高度。 只有在同步创建GroundPolylinePrimitive时才需要调用此方法。

Returns:

Type	Description
Promise	一个一旦地形高度加载完毕就会解析的Promise。

static isSupported(scene){Boolean}

检查给定的Scene是否支持GroundPolylinePrimitives。 GroundPolylinePrimitives需要支持WEBGL_depth_texture扩展。

Name	Type	Description
scene	Scene	当前场景。

Returns:

Type	Description
Boolean	当前场景是否支持GroundPolylinePrimitives。

destroy()

销毁此对象持有的 WebGL 资源。销毁一个对象可以确定性地释放 WebGL 资源，而不是依赖垃圾回收器来销毁这个对象。 一旦一个对象被销毁，它就不应该再被使用；调用除isDestroyed之外的任何函数都将导致抛出一个DeveloperError异常。 因此，应该像示例中那样，将返回值（undefined）赋值给该对象。

See:

• GroundPolylinePrimitive#isDestroyed

Throws:

该对象已被销毁，即调用了destroy()方法。

Type

DeveloperError

Example

e = e && e.destroy();

getGeometryInstanceAttributes(id){Object}

返回GeometryInstance的可修改的每个实例的属性。

Name	Type	Description
id	*	GeometryInstance的id

Throws:

在调用getGeometryInstanceAttributes之前，必须先调用update。

Type

DeveloperError

Returns:

Type	Description
Object	属性格式中的类型化数组，或者如果不存在具有该id的实例，则返回undefined。

Example

var attributes = primitive.getGeometryInstanceAttributes('an id');
attributes.color = SuperMap3D.ColorGeometryInstanceAttribute.toValue(SuperMap3D.Color.AQUA);
attributes.show = SuperMap3D.ShowGeometryInstanceAttribute.toValue(true);

isDestroyed(){Boolean}

如果该对象已被销毁，则返回 true；否则返回 false。 调用除isDestroyed之外的任何函数都将导致抛出一个DeveloperError异常。

See:

• GroundPolylinePrimitive#destroy

Returns:

Type	Description
Boolean	如果该对象已被销毁，则为true；否则为false。

update()

当Viewer或Widget渲染场景时，调用此方法以获取渲染此图元所需的绘制命令。 不要直接调用此方法。这里只是列出在渲染场景时可能传播的异常：

Throws:

• 对于同步的GroundPolylinePrimitive，您必须调用GroundPolylinePrimitive.initializeTerrainHeights()并等待返回的承诺解析。

  Type

  DeveloperError

• 要使用PolylineColorAppearance与GroundPolylinePrimitive，所有GeometryInstances都必须具有颜色属性。

  Type

  DeveloperError