ClassesClassesClassesClasses | | | | Operators

union_straight_contours_histo_xldT_union_straight_contours_histo_xldUnionStraightContoursHistoXldunion_straight_contours_histo_xldUnionStraightContoursHistoXldUnionStraightContoursHistoXld (Operator)

Name

union_straight_contours_histo_xldT_union_straight_contours_histo_xldUnionStraightContoursHistoXldunion_straight_contours_histo_xldUnionStraightContoursHistoXldUnionStraightContoursHistoXld — Compute the union of neighboring straight contours that have a similar distance from a given line.

Warning

union_straight_contours_histo_xldunion_straight_contours_histo_xldUnionStraightContoursHistoXldunion_straight_contours_histo_xldUnionStraightContoursHistoXldUnionStraightContoursHistoXld is obsolete and is only provided for reasons of backward compatibility. New applications should use the operators of the chapter 1D Measuring instead.

Signature

union_straight_contours_histo_xld(Contours : UnionContours, SelectedContours : RefLineStartRow, RefLineStartColumn, RefLineEndRow, RefLineEndColumn, Width, MaxWidth, FilterSize : HistoValues)

Herror T_union_straight_contours_histo_xld(const Hobject Contours, Hobject* UnionContours, Hobject* SelectedContours, const Htuple RefLineStartRow, const Htuple RefLineStartColumn, const Htuple RefLineEndRow, const Htuple RefLineEndColumn, const Htuple Width, const Htuple MaxWidth, const Htuple FilterSize, Htuple* HistoValues)

Herror union_straight_contours_histo_xld(Hobject Contours, Hobject* UnionContours, Hobject* SelectedContours, const HTuple& RefLineStartRow, const HTuple& RefLineStartColumn, const HTuple& RefLineEndRow, const HTuple& RefLineEndColumn, const HTuple& Width, const HTuple& MaxWidth, const HTuple& FilterSize, HTuple* HistoValues)

HXLDContArray HXLDContArray::UnionStraightContoursHistoXld(HXLDContArray* SelectedContours, const HTuple& RefLineStartRow, const HTuple& RefLineStartColumn, const HTuple& RefLineEndRow, const HTuple& RefLineEndColumn, const HTuple& Width, const HTuple& MaxWidth, const HTuple& FilterSize, HTuple* HistoValues) const

void UnionStraightContoursHistoXld(const HObject& Contours, HObject* UnionContours, HObject* SelectedContours, const HTuple& RefLineStartRow, const HTuple& RefLineStartColumn, const HTuple& RefLineEndRow, const HTuple& RefLineEndColumn, const HTuple& Width, const HTuple& MaxWidth, const HTuple& FilterSize, HTuple* HistoValues)

HXLDCont HXLDCont::UnionStraightContoursHistoXld(HXLDCont* SelectedContours, Hlong RefLineStartRow, Hlong RefLineStartColumn, Hlong RefLineEndRow, Hlong RefLineEndColumn, Hlong Width, Hlong MaxWidth, Hlong FilterSize, HTuple* HistoValues) const

void HOperatorSetX.UnionStraightContoursHistoXld(
[in] IHUntypedObjectX* Contours, [out] IHUntypedObjectX*UnionContours, [out] IHUntypedObjectX*SelectedContours, [in] VARIANT RefLineStartRow, [in] VARIANT RefLineStartColumn, [in] VARIANT RefLineEndRow, [in] VARIANT RefLineEndColumn, [in] VARIANT Width, [in] VARIANT MaxWidth, [in] VARIANT FilterSize, [out] VARIANT* HistoValues)

IHXLDContX* HXLDContX.UnionStraightContoursHistoXld(
[out] IHXLDContX*SelectedContours, [in] Hlong RefLineStartRow, [in] Hlong RefLineStartColumn, [in] Hlong RefLineEndRow, [in] Hlong RefLineEndColumn, [in] Hlong Width, [in] Hlong MaxWidth, [in] Hlong FilterSize, [out] VARIANT* HistoValues)

static void HOperatorSet.UnionStraightContoursHistoXld(HObject contours, out HObject unionContours, out HObject selectedContours, HTuple refLineStartRow, HTuple refLineStartColumn, HTuple refLineEndRow, HTuple refLineEndColumn, HTuple width, HTuple maxWidth, HTuple filterSize, out HTuple histoValues)

HXLDCont HXLDCont.UnionStraightContoursHistoXld(out HXLDCont selectedContours, int refLineStartRow, int refLineStartColumn, int refLineEndRow, int refLineEndColumn, int width, int maxWidth, int filterSize, out HTuple histoValues)

Description

union_straight_contours_histo_xldunion_straight_contours_histo_xldUnionStraightContoursHistoXldunion_straight_contours_histo_xldUnionStraightContoursHistoXldUnionStraightContoursHistoXld merges neighboring XLD contours ContoursContoursContoursContoursContourscontours if certain criteria are fulfilled.

The maximum and minium distances of the contours to a given reference line are calculated. From this distances a histogram is created. If the histogram should be smoothed, FilterSizeFilterSizeFilterSizeFilterSizeFilterSizefilterSize must be greater than one. Afterwards, the resulting histogram is divided into ranges (from minima to minima). Contours which lie in the same range are concatenated to a new contour. If the width of the range is greater than MaxWidthMaxWidthMaxWidthMaxWidthMaxWidthmaxWidth, all contours in this range are ignored (removed). If a contour lies in two ranges or more it is ignored, too. If there are parallel contours, there is a risk of merging neighboring contours.

The parameters of the regression lines are calculated newly for merged contours.

The resulting contours cannot be displayed.

Attention

Before the contour parameters can be returned by union_straight_contours_histo_xldunion_straight_contours_histo_xldUnionStraightContoursHistoXldunion_straight_contours_histo_xldUnionStraightContoursHistoXldUnionStraightContoursHistoXld, the parameters of the regression line to the contour must be calculated by calling regress_contours_xldregress_contours_xldRegressContoursXldregress_contours_xldRegressContoursXldRegressContoursXld. Note further that already closed contours are not considered for a union anymore.

Parallelization

Parameters

ContoursContoursContoursContoursContourscontours (input_object)  xld_cont-array objectHXLDContHXLDContHXLDContArrayHXLDContXHobject

Input XLD contours.

UnionContoursUnionContoursUnionContoursUnionContoursUnionContoursunionContours (output_object)  xld_cont-array objectHXLDContHXLDContHXLDContArrayHXLDContXHobject *

Output XLD contours.

SelectedContoursSelectedContoursSelectedContoursSelectedContoursSelectedContoursselectedContours (output_object)  xld_cont-array objectHXLDContHXLDContHXLDContArrayHXLDContXHobject *

Output XLD contours.

RefLineStartRowRefLineStartRowRefLineStartRowRefLineStartRowRefLineStartRowrefLineStartRow (input_control)  line.begin.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

y coordinate of the starting point of the reference line.

Default value: 0

RefLineStartColumnRefLineStartColumnRefLineStartColumnRefLineStartColumnRefLineStartColumnrefLineStartColumn (input_control)  line.begin.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

x coordinate of the starting point of the reference line.

Default value: 0

RefLineEndRowRefLineEndRowRefLineEndRowRefLineEndRowRefLineEndRowrefLineEndRow (input_control)  line.end.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

y coordinate of the endpoint of the reference line.

Default value: 0

RefLineEndColumnRefLineEndColumnRefLineEndColumnRefLineEndColumnRefLineEndColumnrefLineEndColumn (input_control)  line.end.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

x coordinate of the endpoint of the reference line.

Default value: 0

WidthWidthWidthWidthWidthwidth (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximum distance.

Default value: 1

MaxWidthMaxWidthMaxWidthMaxWidthMaxWidthmaxWidth (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximum Width between two minimas.

Default value: 1

FilterSizeFilterSizeFilterSizeFilterSizeFilterSizefilterSize (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Size of Smoothfilter

Default value: 1

Typical range of values: 1 ≤ FilterSize FilterSize FilterSize FilterSize FilterSize filterSize ≤ 63

HistoValuesHistoValuesHistoValuesHistoValuesHistoValueshistoValues (output_control)  integer-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Output Values of Histogram.

Possible Predecessors

regress_contours_xldregress_contours_xldRegressContoursXldregress_contours_xldRegressContoursXldRegressContoursXld

See also

fit_line_contour_xldfit_line_contour_xldFitLineContourXldfit_line_contour_xldFitLineContourXldFitLineContourXld, get_contour_xldget_contour_xldGetContourXldget_contour_xldGetContourXldGetContourXld, get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldget_contour_attrib_xldGetContourAttribXldGetContourAttribXld, gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXld, lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss, lines_facetlines_facetLinesFacetlines_facetLinesFacetLinesFacet, edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix, get_regress_params_xldget_regress_params_xldGetRegressParamsXldget_regress_params_xldGetRegressParamsXldGetRegressParamsXld, get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXld, query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXld

Module

Foundation


ClassesClassesClassesClasses | | | | Operators