GetPhotoCalibPars

Declaration: TMetaData.GetPhotoCalibPars (PhotoIx: integer; var CalibPars: TDouble2DArray): integer;
The function GetPhotoCalibPars returns the coregistration parameters of the photo referenced by PhotoIx. PhotoIx can assume values between 1 and NumPhotos. The array parameter CalibPars is automatically resized to 4 columns and NP rows and returns the NP reference points of the coregistration equation.

The array CalibPars exhibits the following structure: each row of the array contains a reference point, the four columns contain the following information:

  • column 0: x-value in HSI (world coordinates, hsiX)
  • column 1: y-value in HSI (world coordinates, hsiY)
  • column 2: x-coord photo (pixels, PhotX)
  • column 3: y-coord photo (pixels, PhotY)
The figure below shows an example with 8 reference points:

The function returns the following error codes:
 0 ... everything is OK, the array CalibPars contains the calibration points
-1 ... the parameter PhotoIx is out of range

Hint: In order to directly access the metadata of the currently loaded dataset you can use the pre-declared global variable MData.