Back to FabImage Library website

You are here: Start » Function Reference » Computer Vision » Camera Calibration » FilterGridPoints

FilterGridPoints


Header: FIL.h
Namespace: fil
Module: Calibration

Select a subset of the given points that forms a grid.

Syntax

C++
C#
 
void fil::FilterGridPoints
(
	const ftl::Array<fil::Point2D>& inPoints,
	const ftl::Optional<int> inMaxAttempts,
	const ftl::Optional<int> inMaxOutlierCount,
	const float inMinLength,
	const ftl::Optional<float> inMaxLength,
	const float inMaxLengthRatio,
	const float inAngleRange,
	const float inBaseAspectRatioRange,
	const ftl::Optional<float> inBaseAspectRatio,
	const ftl::Optional<float> inBaseShear,
	const ftl::Optional<float> inBaseOrientation,
	ftl::Array<fil::Point2D>& outPointGrid,
	ftl::Array<fil::Segment2D>& diagValidSubgraph,
	float& diagMaxLength
)

Parameters

Name Type Range Default Description
Input value inPoints const Array<Point2D>&
Input value inMaxAttempts const Optional<int> 1 - NIL Maximum number of attempts at finding the grid
Input value inMaxOutlierCount const Optional<int> 0 - NIL Determines how many outlier points can be present to end the search
Input value inMinLength const float 0.0 - 0.0f Minimum length of a grid segment
Input value inMaxLength const Optional<float> 0.0 - 10.0f Maximum length of a grid segment, if set to Auto it will be approximated
Input value inMaxLengthRatio const float 1.0 - 2.0 1.3f Maximum ratio of two consecutive segments in the grid
Input value inAngleRange const float 0.0 - 45.0 16.0f Maximum variation of angles between neighbouring grid segments in degrees
Input value inBaseAspectRatioRange const float 0.0 - 1.0 0.3f Maximum variation of the base aspect ratio (ignores if base aspect ratio is not given)
Input value inBaseAspectRatio const Optional<float> 0.3 - 1.0 1.0f A reference aspect ratio of the grid
Input value inBaseShear const Optional<float> 0.0 - 60.0 0.0f A reference shear angle between grid directions that uses inMaxAngleRange as the maximum error range
Input value inBaseOrientation const Optional<float> 0.0 - 360.0 NIL A reference orientation of one of the grids directions
Output value outPointGrid Array<Point2D>& Detected grid
Diagnostic input diagValidSubgraph Array<Segment2D>& Graph forming a valid grid
Diagnostic input diagMaxLength float& Max length computed by the filter (applicable if inMaxLength is set to Auto)

Description

This is a simplified version of AnnotateGridPoints_Ransac. See the documentation of that filter for more detail.

See Also