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.