intersectionintersectionIntersectionIntersectionintersection (Operator)

Name

intersectionintersectionIntersectionIntersectionintersection — Calculate the intersection of two regions.

Signature

Description

intersectionintersectionIntersectionIntersectionIntersectionintersection calculates the intersection of the regions in Region1Region1Region1Region1region1region_1 with the regions in Region2Region2Region2Region2region2region_2. Each region in Region1Region1Region1Region1region1region_1 is intersected with all regions in Region2Region2Region2Region2region2region_2. That is, internally all regions of Region2Region2Region2Region2region2region_2 are united to a single region before the individual regions of Region1Region1Region1Region1region1region_1 are intersected with the united region. The order of regions in RegionIntersectionRegionIntersectionRegionIntersectionRegionIntersectionregionIntersectionregion_intersection is identical to the order of regions in Region1Region1Region1Region1region1region_1.

Attention

Empty input regions are permitted. Because empty result regions are possible, the system flag 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region""store_empty_region" should be set appropriately.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Complexity

Let N be the number of regions in Region1Region1Region1Region1region1region_1, be their average area, and be the total area of all regions in Region2Region2Region2Region2region2region_2. Then the runtime complexity is .

Result

intersectionintersectionIntersectionIntersectionIntersectionintersection always returns 2 (H_MSG_TRUE). The behavior in case of empty input (no regions given) can be set via 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>)set_system("no_object_result",<Result>) and the behavior in case of an empty input region via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringPouringpouring

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

See also

union1union1Union1Union1Union1union1, union2union2Union2Union2Union2union2, complementcomplementComplementComplementComplementcomplement

Module

Foundation