Start » Filter Reference » Surface » Surface Basics » SkipEmptySurfaceRegion
Basic| 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 | |
|---|---|---|---|
 |
inSurface | Surface | |
|
inRegion | Region | Input region |
 |
outNotEmptySurfaceRegion | Region? | |
|
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.