Back to Aurora Vision Studio website

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

SkipEmptySurfaceRegion


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.
Name Type Description
Input value inSurface Surface
Input value inRegion Region Input region
Output value outNotEmptySurfaceRegion Region?
Output value outIsNotEmpty Bool

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.