You are here: Start » Function Reference » Geometry 2D Features » PointsBoundingRectangle_OrNil

PointsBoundingRectangle_OrNil

Computes the smallest rectangle containing an array of points; returns NIL when the array is empty.

Syntax

void avl::PointsBoundingRectangle_OrNil
(
	const atl::Array<avl::Point2D>& inPoints,
	avl::BoundingRectangleFeature::Type inBoundingRectangleFeature,
	float inReferenceAngle,
	avl::RectangleOrientation::Type inRectangleOrientation,
	atl::Conditional<avl::Rectangle2D>& outBoundingRectangle,
	atl::Conditional<avl::Point2D>& outCenter,
	atl::Conditional<float>& outLongSide,
	atl::Conditional<float>& outShortSide
)

void PointsBoundingRectangle_OrNil
(
	Point2D[] inPoints,
	BoundingRectangleFeature inBoundingRectangleFeature,
	float inReferenceAngle,
	RectangleOrientation inRectangleOrientation,
	out Rectangle2D? outBoundingRectangle,
	out Point2D? outCenter,
	out float? outLongSide,
	out float? outShortSide
)

Parameters

Name	Type	Default	Description
inPoints	const Array<Point2D>&		Input array of points
inBoundingRectangleFeature	BoundingRectangleFeature::Type	MinimalArea	Determines what kind of bounding rectangle will be computed
inReferenceAngle	float	0.0f	The middle angle of the valid range of the output rectangle's angle
inRectangleOrientation	RectangleOrientation::Type	Horizontal	Orientation of the output rectangle
outBoundingRectangle	Conditional<Rectangle2D>&		Smallest bounding rectangle of the input points
outCenter	Conditional<Point2D>&		Center of the bounding rectangle
outLongSide	Conditional<float>&		Length of the bounding rectangle long side
outShortSide	Conditional<float>&		Length of the bounding rectangle short side