ClassesClassesClassesClasses | | | | Operators

test_region_pointtest_region_pointTestRegionPointtest_region_pointTestRegionPointTestRegionPoint (Operator)

Name

test_region_pointtest_region_pointTestRegionPointtest_region_pointTestRegionPointTestRegionPoint — Test if the region contains a 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 TestRegionPoint(const HObject& Regions, const HTuple& Row, const HTuple& Column, HTuple* IsInside)

Hlong HRegion::TestRegionPoint(Hlong Row, Hlong 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_pointTestRegionPointtest_region_pointTestRegionPointTestRegionPoint tests if at least one input region of RegionsRegionsRegionsRegionsRegionsregions contains the test point (RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn). Is this the case, IsInsideIsInsideIsInsideIsInsideIsInsideisInside 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")SetSystem("no_object_result","true")set_system("no_object_result","true")SetSystem("no_object_result","true")SetSystem("no_object_result","true") IsInsideIsInsideIsInsideIsInsideIsInsideisInside 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 IsInsideIsInsideIsInsideIsInsideIsInsideisInside is set to FALSE , i.e., an empty region behaves as if it did not exist.

Parallelization

Parameters

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Region(s) to be examined.

RowRowRowRowRowrow (input_control)  point.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Line index of the test pixel.

Default value: 100

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

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumnColumncolumn (input_control)  point.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column index of the test pixel.

Default value: 100

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

Minimum increment: 1

Recommended increment: 1

IsInsideIsInsideIsInsideIsInsideIsInsideisInside (output_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (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_pointTestRegionPointtest_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>)SetSystem("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

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection

Alternatives

union1union1Union1union1Union1Union1, intersectionintersectionIntersectionintersectionIntersectionIntersection, area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter

See also

select_region_pointselect_region_pointSelectRegionPointselect_region_pointSelectRegionPointSelectRegionPoint

Module

Foundation


ClassesClassesClassesClasses | | | | Operators