Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Surface Basics » SkipEmptySurfaceRegion

SkipEmptySurfaceRegion


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.

Name Type Description
inSurface Surface
inRegion Region Input region
outNotEmptySurfaceRegion Region?
outIsNotEmpty Bool

Applications

Secures against domain errors caused by regions with no valid point, e.g. just before the SurfaceMassCenter filter is to be invoked.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Input region frame exceeds the input surface frame in SkipEmptySurfaceRegion.

Complexity Level

This filter is available on Basic Complexity Level.