Back to Adaptive Vision Library websiteYou are here:
Start »
Function Reference »
Region Combinators »
RegionDifference
Computes a region containing pixels from the first input region, but not from the second input region.
Syntax
C++
C#
void avl::RegionDifference
(
const avl::Region& inRegion1,
const avl::Region& inRegion2,
avl::Region& outRegion
)
void RegionDifference
(
Region inRegion1,
Region inRegion2,
out Region outRegion
)
Parameters
|
Name |
Type |
Default |
Description |
|
inRegion1 |
const Region& |
|
First input region |
|
inRegion2 |
const Region& |
|
Second input region |
|
outRegion |
Region& |
|
Output region |
Description
The operation computes the logical difference of two given regions. That is, the resulting region contains pixel locations that belong to the first input region but do not belong to the second one. Both dimensions (width and height) of the resulting region are set to the corresponding dimensions of the first input region.
Examples
Sample region inRegion1 |
Sample region inRegion2 |
RegionDifference(inRegion1, inRegion2) |
RegionDifference(inRegion2, inRegion1) |
Errors
Error type |
Description |
DomainError |
Input and output regions are not distinct in RegionDifference. |
See Also