GenerateCalibrationPoints


Generates artificial points for camera calibration. Doesn't support distortion.

Applications:Calibration testing.

Syntax

C++
C#
Python
 
def GenerateCalibrationPoints(
	inImageSize: Size,
	/,
	*,
	inPointsX: int = 10,
	inPointsY: int = 10,
	inWorldPointSpacing: float = 1.0,
	inPlaneRotationAxis: Vector3D = Vector3D(0.0, 0.0, 1.0),
	inPlaneRotationAngle: float = 0.0,
	inPlaneTranslation: Vector3D = Vector3D(0.0, 0.0, 10.0),
	inCameraType: CameraModelType = CameraModelType.PinholeCameraModel,
	inFocalLengthOrMagnificationX: float = 100.0,
	inFocalLengthOrMagnificationY: float | None = None,
	inPrincipalPoint: Point2D | None = None
)
-> (
	outImageGrid: list[AnnotatedPoint2D],
	outWorldPoints: list[Point2D]
)

Parameters

Name Type Default Description
Input value inPointsX int 10 Number of points in X direction on the calibration plane.
Input value inPointsY int 10 Number of points in Y direction on the calibration plane.
Input value inWorldPointSpacing float 1.0 Distances between consecutive points on the calibration plane.
Input value inPlaneRotationAxis Vector3D Vector3D(0.0, 0.0, 1.0) Calibration plane rotation axis.
Input value inPlaneRotationAngle float 0.0 Calibration plane rotation angle.
Input value inPlaneTranslation Vector3D Vector3D(0.0, 0.0, 10.0) Calibration plane translation (applied after rotation).
Input value inCameraType CameraModelType CameraModelType.PinholeCameraModel Calibration camera model (pinhole, telecentric or line scan)
Input value inFocalLengthOrMagnificationX float 100.0
Input value inFocalLengthOrMagnificationY float | None None
Input value inPrincipalPoint Point2D | None None By default is on the center of output image
Input value inImageSize Size The size of image that artificial camera captures
Output value outImageGrid list[AnnotatedPoint2D]
Output value outWorldPoints list[Point2D]