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

ProjectPointOntoSurface

Header:	FIL.h
Namespace:	fil
Module:	Vision3DStandard

Returns an interpolated single point of a surface given its coordinates in surface coordinate system.

Syntax

void fil::ProjectPointOntoSurface
(
	const fil::Surface& inSurface,
	const fil::Point2D& inPoint,
	int inInterpolationRadius,
	ftl::Optional<fil::Point3D&> outSurfaceRealPoint = ftl::NIL,
	ftl::Optional<fil::Point2D&> outSurfaceGridPoint = ftl::NIL
)

Parameters

Name	Type	Range	Default	Description
inSurface	const Surface&			Input surface
inPoint	const Point2D&			Coordinates of the input point in surface coordinate system
inInterpolationRadius	int	0 - 65535	0	Radius of vicinity being taken into account to interpolate not existing point
outSurfaceRealPoint	Optional<Point3D&>		NIL	Output point in surface coordinate system
outSurfaceGridPoint	Optional<Point2D&>		NIL	Output point in surface grid coordinate system

Optional Outputs

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