You are here: Start » Function Reference » Surface » Surface Features » SurfaceMultiplePointsAlongAxis

SurfaceMultiplePointsAlongAxis

Header:	FIL.h
Namespace:	fil
Module:	Vision3DStandard

Returns multiple arrays of surface points along X or Y axis.

Syntax

void fil::SurfaceMultiplePointsAlongAxis
(
	const fil::Surface& inSurface,
	ftl::Optional<const fil::Surface&> inSurface2,
	fil::Axis::Type inAxis,
	ftl::Optional<double> inCoordinateValueStart,
	ftl::Optional<double> inCoordinateValueEnd,
	ftl::Optional<double> inCoordinateValueStep,
	int inSmoothRadius,
	ftl::Optional<double> inMinOutputCoordinate,
	ftl::Optional<double> inMaxOutputCoordinate,
	ftl::Optional<int> inMaxInterpolationLength,
	ftl::Array<ftl::Array<fil::Point3D>>& outPoints,
	ftl::Optional<ftl::Array<double>&> outCoordinateValues = ftl::NIL
)

Parameters

Name	Type	Range	Default	Description
inSurface	const Surface&			Input surface
inSurface2	Optional<const Surface&>		NIL	Optional second input surface
inAxis	Axis::Type			Axis along which the points are extracted
inCoordinateValueStart	Optional<double>		NIL	Determines the coordinate the first row of points will be extracted from
inCoordinateValueEnd	Optional<double>		NIL	Limits the coordinate the last row of points will be extracted from
inCoordinateValueStep	Optional<double>	0 -	NIL	Determines the distance between consecutive extracted row of points
inSmoothRadius	int	0 -		Increases the number of neighbouring points taken into account extracting a single row of points
inMinOutputCoordinate	Optional<double>		NIL	Minimal second coordinate of the output points
inMaxOutputCoordinate	Optional<double>		NIL	Maximal second coordinate of the output points
inMaxInterpolationLength	Optional<int>	0 -	0	Maximal number of consecutive not existing points to be interpolated
outPoints	Array<Array<Point3D>>&			The resulting surface points
outCoordinateValues	Optional<Array<double>&>		NIL	The coordinates the output points were extracted from

Optional Outputs

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