apply_distance_transform_xldT_apply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld (Operator)
Name
apply_distance_transform_xldT_apply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld — Determine the pointwise distance of two contours using an XLD distance
transform.
Signature
Description
The operator apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldApplyDistanceTransformXld determines for
each point in ContourContourContourContourcontour the minimal distance to the reference contour
using its XLD distance transform DistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformID.
The returned contour ContourOutContourOutContourOutContourOutcontourOut consists of
ContourContourContourContourcontour with the attribute 'distance'"distance""distance""distance""distance" containing the
calculated distances. They can be accessed by querying the attribute
'distance'"distance""distance""distance""distance" with get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld. See the operator
reference of get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld for further information about
contour attributes.
Note that the distances depend on the parameters of
create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXldCreateDistanceTransformXld:
The distances are clipped to the maximum distance specified by the parameter
MaxDistance. The parameter Mode determines whether the distances are
calculated 'point_to_point'"point_to_point""point_to_point""point_to_point""point_to_point" or 'point_to_segment'"point_to_segment""point_to_segment""point_to_segment""point_to_segment".
For further details please refer to the documentation of
create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXldCreateDistanceTransformXld.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ContourContourContourContourcontour (input_object) xld_cont(-array) → objectHXLDContHXLDContHobject
Contour(s) for whose points the distances are
calculated.
DistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformID (input_control) xld_dist_trans → HXLDDistTrans, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the XLD distance transform of the
reference contour.
Result
If all parameters are correct, the operator returns the
value 2 (H_MSG_TRUE). Otherwise, an exception is raised.
Possible Predecessors
create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXldCreateDistanceTransformXld,
read_distance_transform_xldread_distance_transform_xldReadDistanceTransformXldReadDistanceTransformXldReadDistanceTransformXld,
deserialize_distance_transform_xlddeserialize_distance_transform_xldDeserializeDistanceTransformXldDeserializeDistanceTransformXldDeserializeDistanceTransformXld,
set_distance_transform_xld_paramset_distance_transform_xld_paramSetDistanceTransformXldParamSetDistanceTransformXldParamSetDistanceTransformXldParam
Possible Successors
get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld,
segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXldSegmentContourAttribXld
Alternatives
distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXldDistanceContoursXld
See also
get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld,
set_distance_transform_xld_paramset_distance_transform_xld_paramSetDistanceTransformXldParamSetDistanceTransformXldParamSetDistanceTransformXldParam,
write_distance_transform_xldwrite_distance_transform_xldWriteDistanceTransformXldWriteDistanceTransformXldWriteDistanceTransformXld,
serialize_distance_transform_xldserialize_distance_transform_xldSerializeDistanceTransformXldSerializeDistanceTransformXldSerializeDistanceTransformXld,
clear_distance_transform_xldclear_distance_transform_xldClearDistanceTransformXldClearDistanceTransformXldClearDistanceTransformXld
Module
Foundation