symm_differencesymm_differenceSymmDifferenceSymmDifferencesymm_difference (Operator)

Name

symm_differencesymm_differenceSymmDifferenceSymmDifferencesymm_difference — Calculate the symmetric difference of two regions.

Signature

symm_difference(Region1, Region2 : RegionDifference : : )

Herror symm_difference(const Hobject Region1, const Hobject Region2, Hobject* RegionDifference)

Herror T_symm_difference(const Hobject Region1, const Hobject Region2, Hobject* RegionDifference)

void SymmDifference(const HObject& Region1, const HObject& Region2, HObject* RegionDifference)

HRegion HRegion::SymmDifference(const HRegion& Region2) const

static void HOperatorSet.SymmDifference(HObject region1, HObject region2, out HObject regionDifference)

HRegion HRegion.SymmDifference(HRegion region2)

def symm_difference(region_1: HObject, region_2: HObject) -> HObject

Description

symm_differencesymm_differenceSymmDifferenceSymmDifferenceSymmDifferencesymm_difference calculates the symmetric difference of two regions. Note that, internally, all regions of Region2Region2Region2Region2region2region_2 are united to a single region before the symmetric differences between the individual regions of Region1Region1Region1Region1region1region_1 and the united region are calculated. Two possible definitions of the symmetric difference can be seen in the example below. A third definition is to regard the exclusive or of the two regions.

Attention

Empty regions are valid for both parameters. On output, empty regions may result. The value of the system flag 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region""store_empty_region" determines the behavior in this case.

Execution Information

Parameters

Region1Region1Region1Region1region1region_1 (input_object)  region(-array) objectHRegionHObjectHRegionHobject

Input region 1.

Region2Region2Region2Region2region2region_2 (input_object)  region(-array) objectHRegionHObjectHRegionHobject

Input region 2.

RegionDifferenceRegionDifferenceRegionDifferenceRegionDifferenceregionDifferenceregion_difference (output_object)  region(-array) objectHRegionHObjectHRegionHobject *

Resulting region.

Example (HDevelop)

* Simulate the symmetric difference of Region1 and Region2 with
* difference and union:
difference(Region1, Region2, Diff1)
difference(Region2, Region1, Diff2)
union2(Diff1, Diff2, Difference)

* Simulate the symmetric difference of Region1 and Region2 with
* union, intersection, and difference:
union2(Region1, Region2, Union)
intersection(Region1, Region2, Intersection)
difference(Union, Intersection, Difference)

Result

symm_differencesymm_differenceSymmDifferenceSymmDifferenceSymmDifferencesymm_difference always returns the value 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 Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

See also

intersectionintersectionIntersectionIntersectionIntersectionintersection, union1union1Union1Union1Union1union1, union2union2Union2Union2Union2union2, complementcomplementComplementComplementComplementcomplement, differencedifferenceDifferenceDifferenceDifferencedifference

Module

Foundation