You are here: Start » Function Reference » Surface » 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.

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

Syntax

void fil::SkipEmptySurfaceRegion
(
	const fil::Surface& inSurface,
	const fil::Region& inRegion,
	ftl::Conditional<fil::Region>& outNotEmptySurfaceRegion,
	bool& outIsNotEmpty
)

Parameters

	Name	Type	Default	Description
	inSurface	const Surface&
	inRegion	const Region&		Input region
	outNotEmptySurfaceRegion	Conditional<Region>&
	outIsNotEmpty	bool&

Errors