Back to Aurora Vision Library website

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

OpenSurfacePoints


Header: AVL.h
Namespace: avl
Module: Vision3DStandard

Removes some existing points from the input surface when some points in their vicinity are missing.

Syntax

C++
C#
 
void avl::OpenSurfacePoints
(
	const avl::Surface& inSurface,
	atl::Optional<const avl::Region&> inRoi,
	avl::KernelShape::Type inKernel,
	int inRadiusX,
	atl::Optional<int> inRadiusY,
	bool inPreserveDimensions,
	avl::Surface& outSurface
)

Parameters

Name Type Range Default Description
Input value inSurface const Surface& Input surface
Input value inRoi Optional<const Region&> NIL Region of interest
Input value inKernel KernelShape::Type Kernel shape (predefined)
Input value inRadiusX int 0 - 1 Nearly half of the kernel's width (2*R+1)
Input value inRadiusY Optional<int> 0 - NIL Nearly half of the kernel's height (2*R+1), or same as inRadiusX
Input value inPreserveDimensions bool Flag indicating whether the surface dimensions should be preserved or not
Output value outSurface Surface& Output surface

Description

The operation removes some existing points from the input surface when some points in their vicinity are missing. Internally the region of surface valid points is opened using defined kernel. The surface points in locations that have vanished because of the opening are removed and substituted with indefinite points.

Errors

List of possible exceptions:

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

See Also

  • SurfaceValidPointsRegion – Computes region of locations where points are valid in a surface and where they are invalid.
  • OpenRegion – Performs a morphological opening on a region using a predefined kernel.