Back to FabImage Studio website
You are here: Start » Filter Reference » Surface Basics » 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.