Back to Aurora Vision Library website
You are here: Start » Function Reference » Surface » Surface Spatial Transforms » CropSurface_Dynamic
CropSurface_Dynamic
Header: | AVL.h |
---|---|
Namespace: | avl |
Module: | Vision3DStandard |
Removes from the surface points that are relatively too distant from their average neighbor points in a local rectangular neighborhood.
Syntax
C++
C#
void avl::CropSurface_Dynamic ( const avl::Surface& inSurface, atl::Optional<const avl::Region&> inRoi, int inRadiusX, atl::Optional<int> inRadiusY, atl::Optional<float> inMinRelativeHeight, atl::Optional<float> inMaxRelativeHeight, float inHysteresis, bool inPreserveDimensions, avl::Surface& outSurface, atl::Optional<avl::Region&> outRejected = atl::NIL, avl::Surface& diagBaseSurface = atl::Dummy<avl::Surface>() )
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 atl::NIL
to these parameters: outRejected.
Read more about Optional Outputs.
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. |