SetCalibCoeffs

Declaration:

TMetaData.SetCalibCoeffs(Dim: TDims; idx: integer; Offs, Fact, Shft: double; Coeffs: TDoubleArray; InvOffs, InvFact, InvShft: double; InvCoeffs: TDoubleArray): integer;

Sets the calibration coefficients for a particular axis specified by the parameter Dim. The parameter idx is the (pixel) index along the specified axis. The calibration values contain the parameters of both the forward (pixel index to real-world coordinates, see IndexToWorld) and the reverse calibration (real-world coordinates to pixel index, see WorldToIndex): Forward calibration: Offs ... the offset Fact ... the scale factor Shft ... the shift factor Coeffs ... the coefficients of the calibration polynomial (max. order = 6) Reverse calibration: InvOffs ... the offset InvFact ... the scale factor InvShft ... the shift factor InvCoeffs ... the coefficients of the calibration polynomial (max. order = 6) The function returns the following error codes:  0 ... everything is OK -1 ... idx is out of range Hint 1: Please take care that the forward and the reverse calibration are matched. Otherwise the behavior of Epina ImageLab can become erratic. Hint 2: ATTENTION: The function SetCalibCoeffs does not adjust the table of calibration pieces. Thus you have to call RecalcCalibPieces after the last call of SetCalibCoeffs. If you fail to recalculate the calibration pieces, parts of Epina ImageLab might behave unpredictably. Hint 3: In order to directly access the metadata of the currently loaded dataset you can use the pre-declared global variable MData.