You are here: Start » Function Reference » Surface » Surface Basics » ImagePointToSurfaceCoordinates

ImagePointToSurfaceCoordinates

Header:	FIL.h
Namespace:	fil
Module:	Vision3DStandard

Finds the surface coordinates of image point.

Applications: Transformation of results found on the image associated with the surface to the surface coordinates.

Syntax

void fil::ImagePointToSurfaceCoordinates
(
	const fil::Point2D& inImagePoint,
	const fil::SurfaceCoordinatesFormat& inSurfaceCoordinatesFormat,
	fil::Point2D& outSurfacePoint,
	ftl::Optional<fil::Point3D&> outSurfacePoint3D = ftl::NIL
)

Parameters

Name	Type	Default	Description
inImagePoint	const Point2D&
inSurfaceCoordinatesFormat	const SurfaceCoordinatesFormat&		Offsets and scales on X and Y axes of the surface associated with the image objects were found on
outSurfacePoint	Point2D&
outSurfacePoint3D	Optional<Point3D&>	NIL

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outSurfacePoint3D.