EWorldShape::SetSensor
Initializes the calibration object using all given parameters.
Namespace: Euresys::Open_eVision
[C++]
void SetSensor(
int sensorWidth,
int sensorHeight,
float fieldWidth,
float fieldHeight,
float centerX,
float centerY,
float angle,
float tiltXAngle,
float tiltYAngle,
float perspectiveStrength,
float distortionStrength,
float opticalCenterX,
float opticalCenterY,
OEV_UINT32 calibrationModes
)
Parameters
sensorWidth
Logical size of the field of view, i.e. image size, in pixels.
sensorHeight
Logical size of the field of view, i.e. image size, in pixels.
fieldWidth
Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight
Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX
Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY
Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle
Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle
Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle
Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength
Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength
Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.
opticalCenterX
X Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
opticalCenterY
Y Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
calibrationModes
Desired calibration mode effects to be combined, as defined by ECalibrationMode. By default (argument omitted), the simplest model compatible with the given parameters is chosen.
Remarks
The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter EWorldShape::CalibrationModes, not a simpler one.
EWorldShape.SetSensor
Initializes the calibration object using all given parameters.
Namespace: Euresys.Open_eVision
[C#]
void SetSensor(
int sensorWidth,
int sensorHeight,
float fieldWidth,
float fieldHeight,
float centerX,
float centerY,
float angle,
float tiltXAngle,
float tiltYAngle,
float perspectiveStrength,
float distortionStrength,
float opticalCenterX,
float opticalCenterY,
uint calibrationModes
)
Parameters
sensorWidth
Logical size of the field of view, i.e. image size, in pixels.
sensorHeight
Logical size of the field of view, i.e. image size, in pixels.
fieldWidth
Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight
Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX
Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain Raw, it is set to 0. Otherwise, it is set to the image center.
centerY
Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain Inverse). Otherwise, it is set to the image center.
angle
Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle
Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle
Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength
Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength
Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.
opticalCenterX
X Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
opticalCenterY
Y Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
calibrationModes
Desired calibration mode effects to be combined, as defined by ECalibrationMode. By default (argument omitted), the simplest model compatible with the given parameters is chosen.
Remarks
The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter EWorldShape::CalibrationModes, not a simpler one.