api:dk11:java:tatukgis.jdk.tgis_topology.combine_tgis_shape_tgis_shape_tgis_topologycombinetype_boolean
Table of Contents
TGIS_Topology.Combine(TGIS_Shape, TGIS_Shape, TGIS_TopologyCombineType, bool) method
DK11 for Java | tatukgis.jdk.TGIS_Topology.Combine | Overloads | Constructors | Methods | Properties | Events
Compute a new shape from the two shapes provided, based on a given operation.
Syntax
// Java public TGIS_Shape Combine( TGIS_Shape _shpA, TGIS_Shape _shpB, TGIS_TopologyCombineType _operation, bool _fixshape );
// Oxygene public function Combine( _shpA : TGIS_Shape; _shpB : TGIS_Shape; _operation : TGIS_TopologyCombineType; _fixshape : Boolean ) : TGIS_Shape;
Parameters
| Name | Type | Description |
|---|---|---|
| _shpA | TGIS_Shape | first shape |
| _shpB | TGIS_Shape | second shape |
| _operation | TGIS_TopologyCombineType | operation code; what kind of operation should be perform between (_shpA) and (_shpB) |
| _fixshape | bool Boolean | if True, then checks and eventually fixes the input shapes for common topological problems, like self-crossings, overlapped parts etc. |
Result
| Type | Description |
|---|---|
| TGIS_Shape | returns new shape combined out of two others based on given type of operation |
Remarks
See TGIS_Shape.Combine for example.
Tip for Intersection operation
When using with many shapes e.g. in loop, check input shapes extents before to improve performance.
// pseudocode: if GisIsCommonExtent(_shpA, _shpB) out = TGIS_Topology.Combine(_shpA, _shpB, TGIS_TopologyCombineType.Intersection) ;
References
2023/03/24 01:43