You are here: Start » Function Reference » Surface Spatial Transforms » CropSurface_Dynamic

CropSurface_Dynamic

Header:	FIL.h
Namespace:	fil

Removes from the surface points that are relatively too distant from their average neighbor points in a local rectangular neighborhood.

Syntax

void fil::CropSurface_Dynamic
(
	const fil::Surface& inSurface,
	ftl::Optional<const fil::Region&> inRoi,
	int inRadiusX,
	ftl::Optional<int> inRadiusY,
	ftl::Optional<float> inMinRelativeHeight,
	ftl::Optional<float> inMaxRelativeHeight,
	float inHysteresis,
	bool inPreserveDimensions,
	fil::Surface& outSurface,
	ftl::Optional<fil::Region&> outRejected = ftl::NIL,
	fil::Surface& diagBaseSurface = ftl::Dummy&lt;fil::Surface&gt;()
)

Parameters

Name	Type	Range	Default	Description
inSurface	const Surface&			Input surface
inRoi	Optional<const Region&>		NIL	Region of interest
inRadiusX	int	0 -	1	Horizontal radius of internal mean blur
inRadiusY	Optional<int>	0 -	NIL	Vertical radius of internal mean blur (Auto = inRadiusX)
inMinRelativeHeight	Optional<float>		NIL	Minimum relative height of a point to be not removed
inMaxRelativeHeight	Optional<float>		NIL	Maximum relative height of a point to be not removed
inHysteresis	float	0.0 -	0.0f	Defines how much the threshold criteria are lowered for points neighboring with other not removed points
inPreserveDimensions	bool		False	Flag indicating whether the surface dimensions should be preserved or not
outSurface	Surface&
outRejected	Optional<Region&>		NIL	Region of locations where points are removed
diagBaseSurface	Surface&			Diagnostic blurred input surface

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outRejected.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

List of possible exceptions:

Error type	Description
DomainError	Region of interest exceeds an input surface in CropSurface_Dynamic.