Back to Aurora Vision Library website

You are here: Start » Function Reference » Geometry 3D » Geometry 3D Spatial Transforms » ProjectPointPerspective

ProjectPointPerspective


Header: AVL.h
Namespace: avl
Module: Vision3DLite

Converts a point through a perspective projection, parallel to the Z axis.

Syntax

C++
C#
 
void avl::ProjectPointPerspective
(
	const avl::Point3D& inPoint3D,
	const avl::Point2D& inCenter,
	const avl::Point3D& inFocalPoint,
	float inFocalLength,
	avl::Point2D& outPoint2D
)

Parameters

Name Type Default Description
Input value inPoint3D const Point3D&
Input value inCenter const Point2D& Center of projection, i.e. the target for projected points (x_focal, y_focal, z)
Input value inFocalPoint const Point3D& The camera center, i.e. the point we measure (x, y, z) against
Input value inFocalLength float The multiplier for the x and y coordinates, which is divided by z. If negative, projects in opposite direction.
Output value outPoint2D Point2D&

Errors

List of possible exceptions:

Error type Description
DomainError Projected point coplanar with the focal point, but not equal to it in ProjectPointPerspective.