Table of Contents
ITGIS_Shape.AddPointBearing method
DK for ActiveX | TatukGIS_XDK11.ITGIS_Shape.AddPointBearing | Methods | Properties
Adds a point using a map-space bearing and distance measured from the last vertex.
Syntax
// C# public WordBool AddPointBearing( double _bearing, double _distance );
' VisualBasic Public Function AddPointBearing( ByVal _bearing As Double, ByVal _distance As Double ) As WordBool
// Oxygene public function AddPointBearing( _bearing : Double; _distance : Double ) : WordBool;
Parameters
| Name | Type | Description |
|---|---|---|
| _bearing | double Double | bearing in radians in map-space orientation |
| _distance | double Double | distance from the last vertex in layer units |
Result
| Type | Description |
|---|---|
| WordBool | True if the point was added successfully; otherwise False. |
Remarks
PURPOSE: Extends line or polygon geometry by computing the next vertex from directional and distance input.
BEHAVIOR: Calculates a new point from the last vertex using the supplied bearing and distance, then appends it to the current part.
CONSTRAINTS: Requires an existing last vertex from which the new point can be calculated.
If the _compass is True then the bearing will be calculated based on North. Otherwise the bearing is calculated as an angle between last vertex and new point. Shape must have at least one vertex (2 points) in a current part for non-compass computations and at least one point for compass computations. If point can not be added (because no vertex exist or an angle can not be calculated) then function return False.