GetMultiLine()

Summary

Gets the coordinates that describe the location of a multiple part line feature.

 

Syntax

pts = GetMultiLine(integer id)

 

Argument	Contents
id	The ID of the line feature

 

Returns

An array of arrays of coordinates in their topological order, one sub-array for each part of the line. The from node is the first coordinate and the to node is the last coordinate in a sub-array.

 

Notes

• The current layer must be a line layer.

• Some types of layers, such as Esri Shapefiles, can have lines with multiple parts. GetLine() indicates this with the NonUnique error. Use GetMultiLine() to get the coordinates for lines from layers of these types.

Example

pts = GetMultiLine(123)

dist = 0

for j = 1 to pts.length do

     for i = 1 to pts[j].length - 1 do

          dist = dist + GetDistance(pts[j][i], pts[j][i + 1])

          end

     end

ShowMessage("The length of the line is " + String(dist))

 

Error Codes

Error Type	Meaning
Error	Layer is not the correct type
NotFound	No line feature exists with the given ID

 

See Also

Function	Summary
GetLine()	Gets the coordinates that describe the location of a line feature
GetPoint()	Gets the location of the point feature with the specified ID
GetArea()	Get the coordinates that describe an area feature