LearnCalibrationPoints Method

NI Vision for Visual Basic

LearnCalibrationPoints Method

Syntax

CWIMAQVision.LearnCalibrationPoints ImageToCalibrate, PixelToRealWorldMapping, LearnCalibrationOptions, QualityScore [, Regions]

Return Type

Long

On success, this method returns 0. On failure, this method returns a negative number.

Purpose

Learns a calibration from a set of pixel coordinates and corresponding real-world coordinates.

Remarks

Use this method with U8, I16, SGL, RGB32, and HSL32 images.

If this method is used, a grid image is not required.

Parameters

ImageToCalibrate As CWIMAQImage

The template used for calibrating your system.

PixelToRealWorldMapping As CWIMAQCalibrationPoints

Specifies a set of reference points used in learning a calibration transformation.

LearnCalibrationOptions As CWIMAQLearnCalibrationOptions

Contains the settings used to determine how the algorithm calibrates your imaging setup.

QualityScore As Single

Quality score of the learning process, with a range of 0-1000. A quality of 1000 means that the feature points were well-learned by the chosen algorithm. The score does not necessarily reflect the absolute accuracy of the estimated calibration mapping.

Regions As Variant

[Optional] Determines the region of the image you want to use in the learning process. All calibration points that are outside the defined region are not used when estimating the calibration transformation.

See Also

CWIMAQVision.LearnCalibrationGrid

CWIMAQVision.SetSimpleCalibration