apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld (Operator)

Name

apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld — Determine the pointwise distance of two contours using an XLD distance transform.

Signature

apply_distance_transform_xld(Contour : ContourOut : DistanceTransformID : )

Description

The operator apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXld determines for each point in ContourContourContourContourContourcontour the minimal distance to the reference contour using its XLD distance transform DistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformID. The returned contour ContourOutContourOutContourOutContourOutContourOutcontourOut consists of ContourContourContourContourContourcontour with the attribute 'distance'"distance""distance""distance""distance""distance" containing the calculated distances. They can be accessed by querying the attribute 'distance'"distance""distance""distance""distance""distance" with get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldget_contour_attrib_xldGetContourAttribXldGetContourAttribXld.

Note that the distances depend on the parameters of create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld: 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""point_to_point" or 'point_to_segment'"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_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

ContourContourContourContourContourcontour (input_object) xld_cont(-array) → object

Contour(s) for whose points the distances are calculated.

ContourOutContourOutContourOutContourOutContourOutcontourOut (output_object) xld_cont(-array) → object

Copy of ContourContourContourContourContourcontour containing the distances as an attribute.

DistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformID (input_control) xld_dist_trans → (integer)

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_xldCreateDistanceTransformXldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXld, read_distance_transform_xldread_distance_transform_xldReadDistanceTransformXldread_distance_transform_xldReadDistanceTransformXldReadDistanceTransformXld, deserialize_distance_transform_xlddeserialize_distance_transform_xldDeserializeDistanceTransformXlddeserialize_distance_transform_xldDeserializeDistanceTransformXldDeserializeDistanceTransformXld, set_distance_transform_xld_paramset_distance_transform_xld_paramSetDistanceTransformXldParamset_distance_transform_xld_paramSetDistanceTransformXldParamSetDistanceTransformXldParam

Possible Successors

get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldget_contour_attrib_xldGetContourAttribXldGetContourAttribXld, segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXld

Alternatives

distance_contours_xlddistance_contours_xldDistanceContoursXlddistance_contours_xldDistanceContoursXldDistanceContoursXld

See also

get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldget_contour_attrib_xldGetContourAttribXldGetContourAttribXld, set_distance_transform_xld_paramset_distance_transform_xld_paramSetDistanceTransformXldParamset_distance_transform_xld_paramSetDistanceTransformXldParamSetDistanceTransformXldParam, write_distance_transform_xldwrite_distance_transform_xldWriteDistanceTransformXldwrite_distance_transform_xldWriteDistanceTransformXldWriteDistanceTransformXld, serialize_distance_transform_xldserialize_distance_transform_xldSerializeDistanceTransformXldserialize_distance_transform_xldSerializeDistanceTransformXldSerializeDistanceTransformXld, clear_distance_transform_xldclear_distance_transform_xldClearDistanceTransformXldclear_distance_transform_xldClearDistanceTransformXldClearDistanceTransformXld

Module

Foundation