apply_distance_transform_xldT_apply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldapply_distance_transform_xld (Operator)
Name
apply_distance_transform_xldT_apply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldapply_distance_transform_xld — Determine the pointwise distance of two contours using an XLD distance
transform.
Signature
Description
The operator apply_distance_transform_xldapply_distance_transform_xldApplyDistanceTransformXldApplyDistanceTransformXldapply_distance_transform_xld determines for
each point in ContourContourContourcontourcontour the minimal distance to the reference contour
using its XLD distance transform DistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformIDdistance_transform_id.
The returned contour ContourOutContourOutContourOutcontourOutcontour_out 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_xldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld. See the operator
reference of get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld for further information about
contour attributes.
Note that the distances depend on the parameters of
create_distance_transform_xldcreate_distance_transform_xldCreateDistanceTransformXldCreateDistanceTransformXldcreate_distance_transform_xld:
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_xldCreateDistanceTransformXldCreateDistanceTransformXldcreate_distance_transform_xld.
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) → objectHXLDContHObjectHObjectHobject
Contour(s) for whose points the distances are
calculated.
DistanceTransformIDDistanceTransformIDDistanceTransformIDdistanceTransformIDdistance_transform_id (input_control) xld_dist_trans → HXLDDistTrans, HTupleHHandleHTupleHtuple (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_xldCreateDistanceTransformXldCreateDistanceTransformXldcreate_distance_transform_xld,
read_distance_transform_xldread_distance_transform_xldReadDistanceTransformXldReadDistanceTransformXldread_distance_transform_xld,
deserialize_distance_transform_xlddeserialize_distance_transform_xldDeserializeDistanceTransformXldDeserializeDistanceTransformXlddeserialize_distance_transform_xld,
set_distance_transform_xld_paramset_distance_transform_xld_paramSetDistanceTransformXldParamSetDistanceTransformXldParamset_distance_transform_xld_param
Possible Successors
get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld,
segment_contour_attrib_xldsegment_contour_attrib_xldSegmentContourAttribXldSegmentContourAttribXldsegment_contour_attrib_xld
Alternatives
distance_contours_xlddistance_contours_xldDistanceContoursXldDistanceContoursXlddistance_contours_xld
See also
get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld,
set_distance_transform_xld_paramset_distance_transform_xld_paramSetDistanceTransformXldParamSetDistanceTransformXldParamset_distance_transform_xld_param,
write_distance_transform_xldwrite_distance_transform_xldWriteDistanceTransformXldWriteDistanceTransformXldwrite_distance_transform_xld,
serialize_distance_transform_xldserialize_distance_transform_xldSerializeDistanceTransformXldSerializeDistanceTransformXldserialize_distance_transform_xld,
clear_distance_transform_xldclear_distance_transform_xldClearDistanceTransformXldClearDistanceTransformXldclear_distance_transform_xld
Module
Foundation