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

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
inPoint3DGrid	const Point3DGrid&
inXLimits	const ValueLimits_f64&
inYLimits	const ValueLimits_f64&
inZOffset	const double
inZScale	const double	0.000001 -	1.0D
inPointType	PlainType::Type		Int16	Type of single point Z coordinate
inMultipointHeight	SurfaceMultipointHeight::Type		Mean	Determines the Z coordinate of a surface point created from more than one point
outSurface	Surface&
outMinX	Optional<double&>		NIL
outMinY	Optional<double&>		NIL
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.

Remarks

This filter is kept only as a legacy feature and its use in new applications is discouraged as ArrangePoint3DGrid offers the same functionalities with higher flexibility when it comes to scale setting (which in turn is fixed at 2.5 for both the X and Y axis in the case of ResamplePoint3DGrid).

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.