CreateLinearRingGeometry

Creates a linear ring. A linear ring closes itself automatically on every AddPoint/DeletePoint by adding a copy of the first point as the last point.

 

JavaScript

 

CreateLinearRingGeometry(

       Vertices)

 

C#

 

ILinearRing CreateLinearRingGeometry(

       object Vertices)

 

C++

 

HRESULT CreateLinearRingGeometry(

       VARIANT Vertices,

       ILinearRing** pVal)

 

Parameters

Vertices

Any of the following can be passed:

·          LinearRing WKT
See: “Well-KnownText Representation for Geometric Objects” in the “Overview” chapter for background information on WKT and WKB.

·          A Safe Array of Vertices– An array that contains triplets of doubles. Each triplet is composed of an x-coordinate, a y-coordinate, and a height. The height is represented in meters and the x- and y-coordinates are represented in the coordinate system’s units. You can use the ITerrain66 interface to retrieve information about the coordinate system.

Note:    In creating a closed ring (polygon), the first point (vertex) should also be listed as the last point.

Note:    As of IE11, VBScript which includes the VBArray object that returns a SafeArray, is considered deprecated. In order to continue using this TerraExplorer API using JavaScript, add the following meta tag in the head section, to enable you to choose which version of Internet Explorer the HTML page should be rendered in (in this case IE10):
<meta http-equiv="X-UA-Compatible" content="IE=10" />

·          Array of IPosition66 objects

Return Value

pVal

An ILinearRing object representing the created object.

Exceptions

See:  HRESULT Return Values for a list of possible values returned by the HRESULT.