Back to Aurora Vision Library website

You are here: Start » Function Reference » Surface » Surface Features » SurfaceToPlaneDistanceImage

SurfaceToPlaneDistanceImage


Header: AVL.h
Namespace: avl
Module: Vision3DStandard

Computes the image of the distances of the input surface points from a given plane.

Syntax

C++
C#
 
void avl::SurfaceToPlaneDistanceImage
(
	const avl::Surface& inSurface,
	atl::Optional<const avl::Region&> inRoi,
	const avl::Plane3D& inPlane,
	float inResolution,
	bool inSignedDistance,
	avl::Image& outDistanceImage
)

Parameters

Name Type Range Default Description
Input value inSurface const Surface& Input surface
Input value inRoi Optional<const Region&> NIL Range of pixels to be processed
Input value inPlane const Plane3D& Input plane
Input value inResolution float 0.0 - 1.0f Number of real-world units per one pixel
Input value inSignedDistance bool False Flag indicating whether to compute signed distance to the plane
Output value outDistanceImage Image&

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

List of possible exceptions:

Error type Description
DomainError Indefinite plane on input in SurfaceToPlaneDistanceImage.
DomainError Region of interest exceeds an input surface in SurfaceToPlaneDistanceImage.