IMVCameraUndistortion

The IMVCameraUndistortion interface contains methods and properties to configure the MV Camera Undistortion filter.

Methods:

GetCameraData Get current camera and objective data.
GetCameraParameter Get the current camera parameter.
LoadCameraParameter Save camera parameter into a file.
Undistortion Enable the undistortion function from the filter.

Header file: IMVCameraUndistortion.h
Interface definition language file: IMVCameraUndistortion.idl
Typelib: MVCameraUndistortion
Interface ID: IID_IMVCameraUndistortion


Method IMVCameraUndistortion::GetCameraData

Declaration: Sub GetCameraData(CameraLabel As String, CameraType As String, ChipWidth As Double, ChipHeight As Double, ObjectiveLabel As String, FocalLength As Double)

Get current camera and objective data.

Parameter:

CameraLabel A friendly name for the camera.
CameraType The camera type.
ChipWidth The camera chip width in mm.
ChipHeight The camera chip height in mm.
ObjectiveLabel Name for the objective.
FocalLength Focal length from the objective in mm.
C Prototype:

HRESULT GetCameraData(BSTR* CameraLabel, BSTR* CameraType, DOUBLE* ChipWidth, DOUBLE* ChipHeight, BSTR* ObjectiveLabel, DOUBLE* FocalLength);


Method IMVCameraUndistortion::GetCameraParameter

Declaration: Sub GetCameraParameter(FocalLength1 As Double, FocalLength2 As Double, Distortion1 As Double, Distortion2 As Double, Distortion3 As Double, Distortion4 As Double, PrincipalPoint1 As Double, PrincipalPoint2 As Double)

Get the current camera parameter.

Parameter:

FocalLength1 The first focal length in pixel size.
FocalLength2 The second focal length in pixel size.
Distortion1 The first distortion parameter.
Distortion2 The second distortion parameter.
Distortion3 The third distortion parameter.
Distortion4 The fourth distortion parameter.
PrincipalPoint1 x-coordinate from the principal point.
PrincipalPoint2 y-coordinate from the principal point.
C Prototype:

HRESULT GetCameraParameter(DOUBLE* FocalLength1, DOUBLE* FocalLength2, DOUBLE* Distortion1, DOUBLE* Distortion2, DOUBLE* Distortion3, DOUBLE* Distortion4, DOUBLE* PrincipalPoint1, DOUBLE* PrincipalPoint2);


Method IMVCameraUndistortion::LoadCameraParameter

Declaration: Sub LoadCameraParameter(Path As String)

Save camera parameter into a file.

Parameter:

Path Path to the camera parameter file (*.mvc).
C Prototype:

HRESULT LoadCameraParameter(BSTR Path);


Property IMVCameraUndistortion::Undistortion

Declaration: Property Get/Put Undistortion As Boolean

Enable the undistortion function from the filter.

C Prototype:

HRESULT put_Undistortion(VARIANT_BOOL newVal);
HRESULT get_Undistortion(VARIANT_BOOL *pVal);