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
Input value inSurface const Surface&
Input value inRegion const Region& Input region
Output value outNotEmptySurfaceRegion Conditional<Region>&
Output value outIsNotEmpty bool&

Errors

List of possible exceptions:

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