You are here: Start » Function Reference » Point3DGrid » Point3DGrid Spatial Transforms » AlignPoint3DGridToPlane

AlignPoint3DGridToPlane

Rotates a grid of 3D points with a rotation that transforms the input plane to be parallel to XY plane.

Syntax

void fil::AlignPoint3DGridToPlane
(
	const fil::Point3DGrid& inGrid,
	const fil::Plane3D& inPlane,
	fil::Point3DGrid& outGrid,
	ftl::Optional<fil::Matrix&> outTransform = ftl::NIL,
	ftl::Optional<fil::Matrix&> outInvertedTransform = ftl::NIL
)

Parameters

	Name	Type	Default	Description
	inGrid	const Point3DGrid&
	inPlane	const Plane3D&		The plane that determines rotation transform
	outGrid	Point3DGrid&
	outTransform	Optional<Matrix&>	NIL	Matrix of the transform used to align the input grid
	outInvertedTransform	Optional<Matrix&>	NIL	Matrix of the transform rotating the output grid to the input one

Optional Outputs

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

Read more about Optional Outputs.

Errors