distance_contours_xld — Calculate the pointwise distance from one contour to another.
distance_contours_xld calculates for each point in
ContourFrom the minimal distance to the contours in
The operator returns the contour
ContourOut which consists of
ContourFrom containing the computed distances in the
The distances can be accessed by querying the attribute
'distance' with the operator
See the operator reference of
get_contour_attrib_xld for further
information about contour attributes.
Mode determines which distances are calculated for each point
'point_to_point' calculates the minimal distance to the base
In contrast, 'point_to_segment' calculates the minimum
distance to the contour segments in
ContourTo (see the figure
Note that in many applications the mode 'point_to_segment'
suggests itself for an accurate result, whereas
'point_to_point' is considerably faster.
If m is the number of points in
ContourFrom, and n the number
of points in
has complexity O(mlog(n)) for 'point_to_point', and O(mn) for
In case the template contour
ContourTo is repeatedly used, the
apply_distance_transform_xld can be used as an alternative to
distance_contours_xld. For further details, please refer to
the documentation of
Contours for whose points the distances are calculated.
Contours to which the distances are calculated to.
ContourFrom containing the
distances as an attribute.
Compute the distance to points ('point_to_point') or to entire segments ('point_to_segment').
Default value: 'point_to_point'
List of values: 'point_to_point', 'point_to_segment'
If all parameters are correct, the operator returns the value 2 (H_MSG_TRUE). Otherwise, an exception is raised.