Back to Aurora Vision Library website
You are here: Start » Function Reference » Surface » Surface Basics » SkipEmptySurfaceRegion
SkipEmptySurfaceRegion
| Header: | AVL.h |
|---|---|
| Namespace: | avl |
| Module: | Vision3DStandard |
If the input surface contains at least one valid point in a given region, then the region is copied to the output; otherwise Nil is returned.
Applications: Secures against domain errors caused by regions with no valid point, e.g. just before the SurfaceMassCenter filter is to be invoked.
Syntax
C++
C#
void avl::SkipEmptySurfaceRegion ( const avl::Surface& inSurface, const avl::Region& inRegion, atl::Conditional<avl::Region>& outNotEmptySurfaceRegion, bool& outIsNotEmpty )
Parameters
| Name | Type | Default | Description | |
|---|---|---|---|---|
![]() |
inSurface | const Surface& | ||
![]() |
inRegion | const Region& | Input region | |
![]() |
outNotEmptySurfaceRegion | Conditional<Region>& | ||
![]() |
outIsNotEmpty | bool& |
Errors
List of possible exceptions:
| Error type | Description |
|---|---|
| DomainError | Input region frame exceeds the input surface frame in SkipEmptySurfaceRegion. |


