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. |