Back to FabImage Library website

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

ProjectPointPerspective


Header: FIL.h
Namespace: fil
Module: Vision3DLite

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

Syntax

C++
C#
 
void fil::ProjectPointPerspective
(
	const fil::Point3D& inPoint3D,
	const fil::Point2D& inCenter,
	const fil::Point3D& inFocalPoint,
	float inFocalLength,
	fil::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.