select_xld_pointselect_xld_pointSelectXldPointSelectXldPoint (Operator)

Name

select_xld_pointselect_xld_pointSelectXldPointSelectXldPoint — Choose all contours or polygons containing a given point.

Signature

select_xld_point(XLDs : DestXLDs : Row, Column : )

Herror select_xld_point(const Hobject XLDs, Hobject* DestXLDs, double Row, double Column)

Herror T_select_xld_point(const Hobject XLDs, Hobject* DestXLDs, const Htuple Row, const Htuple Column)

void SelectXldPoint(const HObject& XLDs, HObject* DestXLDs, const HTuple& Row, const HTuple& Column)

HXLD HXLD::SelectXldPoint(const HTuple& Row, const HTuple& Column) const

HXLD HXLD::SelectXldPoint(double Row, double Column) const

HXLDCont HXLDCont::SelectXldPoint(const HTuple& Row, const HTuple& Column) const

HXLDCont HXLDCont::SelectXldPoint(double Row, double Column) const

HXLDPoly HXLDPoly::SelectXldPoint(const HTuple& Row, const HTuple& Column) const

HXLDPoly HXLDPoly::SelectXldPoint(double Row, double Column) const

HXLDPara HXLDPara::SelectXldPoint(const HTuple& Row, const HTuple& Column) const

HXLDPara HXLDPara::SelectXldPoint(double Row, double Column) const

HXLDModPara HXLDModPara::SelectXldPoint(const HTuple& Row, const HTuple& Column) const

HXLDModPara HXLDModPara::SelectXldPoint(double Row, double Column) const

HXLDExtPara HXLDExtPara::SelectXldPoint(const HTuple& Row, const HTuple& Column) const

HXLDExtPara HXLDExtPara::SelectXldPoint(double Row, double Column) const

static void HOperatorSet.SelectXldPoint(HObject XLDs, out HObject destXLDs, HTuple row, HTuple column)

HXLD HXLD.SelectXldPoint(HTuple row, HTuple column)

HXLD HXLD.SelectXldPoint(double row, double column)

HXLDCont HXLDCont.SelectXldPoint(HTuple row, HTuple column)

HXLDCont HXLDCont.SelectXldPoint(double row, double column)

HXLDPoly HXLDPoly.SelectXldPoint(HTuple row, HTuple column)

HXLDPoly HXLDPoly.SelectXldPoint(double row, double column)

HXLDPara HXLDPara.SelectXldPoint(HTuple row, HTuple column)

HXLDPara HXLDPara.SelectXldPoint(double row, double column)

HXLDModPara HXLDModPara.SelectXldPoint(HTuple row, HTuple column)

HXLDModPara HXLDModPara.SelectXldPoint(double row, double column)

HXLDExtPara HXLDExtPara.SelectXldPoint(HTuple row, HTuple column)

HXLDExtPara HXLDExtPara.SelectXldPoint(double row, double column)

Description

The operator select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint selects all contours or polygons from XLDsXLDsXLDsXLDsXLDs containing the test point (RowRowRowRowrow,ColumnColumnColumnColumncolumn). If the contours or polygons overlap, more than one contour or polygon might contain the point. In this case, all these contours or polygons are returned. If no contour or polygon contains the indicated point, an empty object is returned. It is assumed that the contours or polygons are closed. If this is not the case, select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint will artificially close the contours or polygons. Nevertheless, it is strongly recommended to pass only meaningful and closed contours or polygons in XLDsXLDsXLDsXLDsXLDs by calling select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXld with the parameter 'closed'"closed""closed""closed""closed" before calling select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint.

Attention

If the test point is on the border of a contour or polygon, select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint will deliver unpredictable results, i.e., the contour or polygon may be or may not be added to DestXLDsDestXLDsDestXLDsDestXLDsdestXLDs, depending on arbitrary factors such as how the polygon is oriented with respect to the coordinate system. Note further that for points in the near proximity of the contour or polygon sides, a reliable classification is practically impossible because of numerical inaccuracies.

Execution Information

Parameters

XLDsXLDsXLDsXLDsXLDs (input_object)  xld(-array) objectHXLDHXLDHobject

Contours or polygons to be examined.

DestXLDsDestXLDsDestXLDsDestXLDsdestXLDs (output_object)  xld(-array) objectHXLDHXLDHobject *

All contours or polygons containing the test point.

RowRowRowRowrow (input_control)  point.y HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Line coordinate of the test point.

Default value: 100.0

ColumnColumnColumnColumncolumn (input_control)  point.x HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column coordinate of the test point.

Default value: 100.0

Result

The operator select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint returns the value 2 (H_MSG_TRUE) if the parameters are correct. The behavior in case of empty input (no input contours or polygons available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXld, close_contours_xldclose_contours_xldCloseContoursXldCloseContoursXldCloseContoursXld, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPix

Alternatives

test_xld_pointtest_xld_pointTestXldPointTestXldPointTestXldPoint

Module

Foundation