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

apply_distance_transform_xld(Contour : ContourOut : DistanceTransformID : )

Herror T_apply_distance_transform_xld(const Hobject Contour, Hobject* ContourOut, const Htuple DistanceTransformID)

void ApplyDistanceTransformXld(const HObject& Contour, HObject* ContourOut, const HTuple& DistanceTransformID)

HXLDCont HXLDDistTrans::ApplyDistanceTransformXld(const HXLDCont& Contour) const

static void HOperatorSet.ApplyDistanceTransformXld(HObject contour, out HObject contourOut, HTuple distanceTransformID)

HXLDCont HXLDDistTrans.ApplyDistanceTransformXld(HXLDCont contour)

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

Parameters

ContourContourContourContourcontour (input_object)  xld_cont(-array) objectHXLDContHXLDContHobject

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

ContourOutContourOutContourOutContourOutcontourOut (output_object)  xld_cont(-array) objectHXLDContHXLDContHobject *

Copy of ContourContourContourContourcontour containing the distances as an attribute.

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