PolylineGraphics

new SuperMap3D.PolylineGraphics(options)

Describes a polyline defined as a line strip. The first two positions define a line segment, and each additional position defines a line segment from the previous position. The segments can be linear connected points or great arcs.
Name Type Description
options Object optional Object with the following properties:
Name Type Default Description
positions Property optional A Property specifying the array of Cartesian3 positions that define the line strip.
followSurface Property true optional A boolean Property specifying whether the line segments should be great arcs or linearly connected.
width Property 1.0 optional A numeric Property specifying the width in pixels.
show Property true optional A boolean Property specifying the visibility of the polyline.
material MaterialProperty Color.WHITE optional A Property specifying the material used to draw the polyline.
granularity Property SuperMap3D.Math.RADIANS_PER_DEGREE optional A numeric Property specifying the angular distance between each latitude and longitude if followSurface is true.
shadows Property ShadowMode.DISABLED optional An enum Property specifying whether the polyline casts or receives shadows from each light source.
distanceDisplayCondition Property optional A Property specifying at what distance from the camera that this polyline will be displayed.
clampToGround Property false optional A Property make the property of classificationType effective.If we want the polyline clamped to the terrain or S3M Model, 3DTiles, use the classificationType to specify whether this polyline will clamp to terrain, S3M Model, 3D TIles, or all three when on the ground
classificationType Property ClassificationType.BOTH optional An enum Property specifying whether this polyline will clamp to terrain, S3M Model, 3D Tiles, or all three when on the ground. Valid only if the property of clampToGround was true.
Example:

    // Clamp To the Terrain, S3M Model or 3DTiles
    viewer.entities.add({
        polyline: {
            positions: [...],
            width: 4,
            material: SuperMap3D.Color.RED,
            clampToGround: true, // to make the classificationType effective, this property must be true.
            classificationType: SuperMap3D.ClassificationType.BOTH // to specify the polyline which to clamp, Terrain, S3M Model or 3DTiles.
        }
    })
See:

Members

readonlydefinitionChanged : Event

Gets the event that is raised whenever a property or sub-property is changed or modified.

distanceDisplayCondition : Property

Gets or sets the DistanceDisplayCondition Property specifying at what distance from the camera that this polyline will be displayed.

followSurface : Property

Gets or sets the boolean Property specifying whether the line segments should be great arcs or linearly connected.
Default Value: true

granularity : Property

Gets or sets the numeric Property specifying the angular distance between each latitude and longitude if followSurface is true.
Default Value: SuperMap3D.Math.RADIANS_PER_DEGREE

material : MaterialProperty

Gets or sets the Property specifying the material used to draw the polyline.
Default Value: Color.WHITE

positions : Property

Gets or sets the Property specifying the array of Cartesian3 positions that define the line strip.

shadows : Property

Get or sets the enum Property specifying whether the polyline casts or receives shadows from each light source.
Default Value: ShadowMode.DISABLED

show : Property

Gets or sets the boolean Property specifying the visibility of the polyline.
Default Value: true

width : Property

Gets or sets the numeric Property specifying the width in pixels.
Default Value: 1.0

clampToGround : Property

A Property make the property of classificationType effective.If we want the polyline clamped to the terrain or S3M Model, 3DTiles, use the classificationType to specify whether this polyline will clamp to terrain, S3M Model, 3D TIles, or all three when on the ground
Default Value: false

classificationType : Property

An enum Property specifying whether this polyline will clamp to terrain, S3M Model, 3D Tiles, or all three when on the ground. Valid only if the property of clampToGround was true.
Default Value: false

Methods

clone(result)PolylineGraphics

Duplicates this instance.
Name Type Description
result PolylineGraphics optional The object onto which to store the result.
Returns:
The modified result parameter or a new instance if one was not provided.

merge(source)

Assigns each unassigned property on this object to the value of the same property on the provided source object.
Name Type Description
source PolylineGraphics The object to be merged into this object.