GetLine()
Summary
Gets the coordinates that describe the location of a line feature.
Syntax
pts = GetLine(integer id)
| Argument | Contents |
|---|---|
| id | The ID of the line feature |
Returns
An array of coordinates in their topological order. The from node is the first coordinate and the to node is the last coordinate in the 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 = GetLine(123)
dist = 0
for i = 1 to pts.length - 1 do
dist = dist + GetDistance(pts[i], pts[i + 1])
end
ShowMessage("The length of the line is " + String(dist))Error Codes
| Error Type | Meaning |
|---|---|
| NotFound | No line feature exists with the given ID |
| NonUnique | More than one line feature exists with the given ID |
See Also
| Function | Summary |
|---|---|
| GetArea() | Get the coordinates that describe an area feature |
| GetFeatureLength() | Returns the length of the feature in current map units |
| GetMultiLine() | Gets the coordinates that describe the location of a multiple part line feature |
| GetPoint() | Gets the location of the point feature with the specified ID |
| ReshapeLink() | Changes the coordinates of a line feature in a standard geographic file |