GeometryTouch (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / Managing databases / HFSQL / Spatial data management

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

GeometryTouch (Function)

In french: GéométrieTouche

Determines whether two geometries touch.

Two geometries touch:

if the boundaries of the two geometries intersect, but the interiors do NOT intersect.
if they have a point or segment of their boundaries in common.

Examples of touching geometries:


Geometries with a common point	Geometries with a common segment

Examples of non-touching geometries:


Disjoint geometries	Geometries with intersecting interiors

Example

// Two polygons with a point in common
o2DPolygon_1 is Polygon2D
Linestring2DAddPoint(o2DPolygon_1.Outline, -2.00, 2.00)
Linestring2DAddPoint(o2DPolygon_1.Outline, 0.00, 2.00)
Linestring2DAddPoint(o2DPolygon_1.Outline, 0.00, -2.00)
Linestring2DAddPoint(o2DPolygon_1.Outline, -2.00, -2.00)
// Add last point (same as first)
Linestring2DAddPoint(o2DPolygon_1.Outline, -2.00, 2.00)
// Corrects the new geometry
o2DPolygon_1 = GeometryCorrect(o2DPolygon_1)

o2DPolygon_2 is Polygon2D
Linestring2DAddPoint(o2DPolygon_2.Outline, 2.00, 2.00)
Linestring2DAddPoint(o2DPolygon_2.Outline, 2.00, -1.00)
Linestring2DAddPoint(o2DPolygon_2.Outline, 0.00, 0.00)
// Add last point (same as first)
Linestring2DAddPoint(o2DPolygon_2.Outline, 2.00, 2.00)
// Corrects the new geometry
o2DPolygon_2 = GeometryCorrect(o2DPolygon_2)

Trace(GeometryTouch(o2DPolygon_1, o2DPolygon_2))

Syntax

<Result> = GeometryTouch(<Geometry A> , <Geometry B>)

<Result>: Boolean

True if the two geometries touch,
False otherwise.
If an error occurs, the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo with the errMessage constant.

<Geometry A>: Variable containing spatial data

First geometry used. This geometry can correspond to one of the following variable types:
PointGeo.
Point2D.
LinestringGeo.
Linestring2D.
PolygonGeo.
Polygon2D.
MultiPointGeo.
MultiPoint2D.
MultiLinestringGeo.
MultiLinestring2D.
MultiPolygonGeo.
MultiPolygon2D.

<Geometry B>: Variable containing spatial data

Second geometry used. This geometry can correspond to one of the following variable types:
PointGeo.
Point2D.
LinestringGeo.
Linestring2D.
PolygonGeo.
Polygon2D.
MultiPointGeo.
MultiPoint2D.
MultiLinestringGeo.
MultiLinestring2D.
MultiPolygonGeo.
MultiPolygon2D.

Business / UI classification: Business Logic

Component: wd300hf.dll