Back to Aurora Vision Library website

You are here: Start » Function Reference » Geometry 3D » Geometry 3D Distance Metrics » CircleToPlaneDistance3D

CircleToPlaneDistance3D


Header: AVL.h
Namespace: avl
Module: Vision3DLite

Measures the distance between a circle in 3D and a plane.

Syntax

C++
C#
 
void avl::CircleToPlaneDistance3D
(
	const avl::Circle3D& inCircle3D,
	const avl::Plane3D& inPlane,
	float inResolution,
	float& outDistance,
	atl::Optional<avl::Segment3D&> outConnectingSegment3D = atl::NIL,
	atl::Optional<float&> outSignedDistance = atl::NIL
)

Parameters

Name Type Range Default Description
Input value inCircle3D const Circle3D&
Input value inPlane const Plane3D&
Input value inResolution float 0.0 - 1.0f Number of real-world units per one pixel
Output value outDistance float&
Output value outConnectingSegment3D Optional<Segment3D&> NIL
Output value outSignedDistance Optional<float&> NIL

Optional Outputs

The computation of following outputs can be switched off by passing value atl::NIL to these parameters: outConnectingSegment3D, outSignedDistance.

Read more about Optional Outputs.

Errors

List of possible exceptions:

Error type Description
DomainError Indefinite circle on input in CircleToPlaneDistance3D.
DomainError Indefinite plane on input in CircleToPlaneDistance3D.