HALCON Reference Manual 10.0.2
Table of Contents / Regions / Tests ClassesClassesClasses | | | Operators

test_region_pointtest_region_pointtest_region_pointTestRegionPointTestRegionPoint (Operator)

Name

test_region_pointtest_region_pointtest_region_pointTestRegionPointTestRegionPoint — Test if the region consists of the given point.

Signature

test_region_point(Regions : : Row, Column : IsInside)

Herror test_region_point(const Hobject Regions, const Hlong Row, const Hlong Column, Hlong* IsInside)

Herror T_test_region_point(const Hobject Regions, const Htuple Row, const Htuple Column, Htuple* IsInside)

Herror test_region_point(Hobject Regions, const HTuple& Row, const HTuple& Column, Hlong* IsInside)

Hlong HRegion::TestRegionPoint(const HTuple& Row, const HTuple& Column) const

Hlong HRegionArray::TestRegionPoint(const HTuple& Row, const HTuple& Column) const

void HOperatorSetX.TestRegionPoint(
[in] IHUntypedObjectX* Regions, [in] VARIANT Row, [in] VARIANT Column, [out] VARIANT* IsInside)

Hlong HRegionX.TestRegionPoint(
[in] Hlong Row, [in] Hlong Column)

static void HOperatorSet.TestRegionPoint(HObject regions, HTuple row, HTuple column, out HTuple isInside)

int HRegion.TestRegionPoint(int row, int column)

Description

test_region_pointtest_region_pointtest_region_pointTestRegionPointTestRegionPoint tests if at least one input region of RegionsRegionsRegionsRegionsregions consists of the test point (RowRowRowRowrow,ColumnColumnColumnColumncolumn). Is this the case, IsInsideIsInsideIsInsideIsInsideisInside is set to TRUE, else to FALSE

Attention

In case of empty input (= no region) and set_system('no_object_result','true')set_system("no_object_result","true")set_system("no_object_result","true")SetSystem("no_object_result","true")SetSystem("no_object_result","true") IsInsideIsInsideIsInsideIsInsideisInside is set to FALSE (no region contains the pixel).

The test pixel is not contained in an empty region (no pixel of the region corresponds to the pixel). If all regions are empty IsInsideIsInsideIsInsideIsInsideisInside is set to FALSE , i.e., an empty region behaves as if it did not exist.

Parallelization

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionXHobject

Region(s) to be examined.

RowRowRowRowrow (input_control)  point.y HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Line index of the test pixel.

Default value: 100

Typical range of values: 0 ≤ Row Row Row Row row ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumncolumn (input_control)  point.x HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column index of the test pixel.

Default value: 100

Typical range of values: 0 ≤ Column Column Column Column column ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 1

IsInsideIsInsideIsInsideIsInsideisInside (output_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

boolean result value.

Complexity

If F is the area of one region and N is the number of regions, the runtime complexity is O(ln(sqrt(F)) * N).

Result

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

Possible Predecessors

thresholdthresholdthresholdThresholdThreshold, regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionconnectionConnectionConnection

Alternatives

union1union1union1Union1Union1, intersectionintersectionintersectionIntersectionIntersection, area_centerarea_centerarea_centerAreaCenterAreaCenter

See also

select_region_pointselect_region_pointselect_region_pointSelectRegionPointSelectRegionPoint

Module

Foundation


Table of Contents / Regions / Tests ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH