Table of Contents
ITGIS_Shape.AddPointBearing_2 method
DK for ActiveX | TatukGIS_XDK11.ITGIS_Shape.AddPointBearing_2 | Methods | Properties
Adds a point using a bearing and distance measured from the last vertex, with optional compass interpretation.
Syntax
// C# public WordBool AddPointBearing_2( double _bearing, double _distance, WordBool _compass );
' VisualBasic Public Function AddPointBearing_2( ByVal _bearing As Double, ByVal _distance As Double, ByVal _compass As WordBool ) As WordBool
// Oxygene public function AddPointBearing_2( _bearing : Double; _distance : Double; _compass : WordBool ) : WordBool;
Parameters
| Name | Type | Description |
|---|---|---|
| _bearing | double Double | bearing in radians |
| _distance | double Double | distance from the last vertex in layer units |
| _compass | WordBool | True to interpret the bearing as compass-oriented; False to use map-space orientation |
Result
| Type | Description |
|---|---|
| WordBool | True if the point was added successfully; otherwise False. |
Remarks
PURPOSE: Extends geometry from directional input while supporting both compass-style and map-space bearing conventions.
BEHAVIOR: Interprets the supplied bearing according to _compass, computes the target point from the last vertex, and 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.