Back to FabImage Library website

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

ResamplePoint3DGrid


Header: FIL.h
Namespace: fil
Module: Vision3DStandard

Creates a surface structure from Point3DGrid taking into account X and Y coordinates and trying to preserve continuity of the surface.

Syntax

C++
C#
 
void fil::ResamplePoint3DGrid
(
	const fil::Point3DGrid& inPoint3DGrid,
	const fil::ValueLimits_f64& inXLimits,
	const fil::ValueLimits_f64& inYLimits,
	const double inZOffset,
	const double inZScale,
	fil::PlainType::Type inPointType,
	fil::SurfaceMultipointHeight::Type inMultipointHeight,
	fil::Surface& outSurface,
	ftl::Optional<double&> outMinX = ftl::NIL,
	ftl::Optional<double&> outMinY = ftl::NIL,
	fil::Region& diagSurfaceValidPointsRegion
)

Parameters

Name Type Range Default Description
Input value
 inPoint3DGrid const Point3DGrid&
Input value
 inXLimits const ValueLimits_f64&
Input value
 inYLimits const ValueLimits_f64&
Input value
 inZOffset const double
Input value
 inZScale const double 0.000001 - 1.0D
Input value
 inPointType PlainType::Type Int16 Type of single point Z coordinate
Input value
 inMultipointHeight SurfaceMultipointHeight::Type Mean Determines the Z coordinate of a surface point created from more than one point
Output value
 outSurface Surface&
Output value
 outMinX Optional<double&> NIL
Output value
 outMinY Optional<double&> NIL
Diagnostic input
 diagSurfaceValidPointsRegion Region& Region of locations where the surface points are valid

Optional Outputs

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

Read more about Optional Outputs.

Errors

List of possible exceptions:

Error type Description
DomainError Empty point array in ResamplePoint3DGrid.
DomainError Incorrect coordinate limits in ResamplePoint3DGrid.
DomainError Surface dimensions too big in ResamplePoint3DGrid.