The function LoadIGTIF loads the IGTIF file specified by FName. The parameter Append controls whether the imported data are to be appended to the existing dataset.
If the parameter Feedback is TRUE a visual feedback of the progress is provided. Please note that unless the script progress bar is already visible you have to make it visible before calling LoadIGTIF, otherwise the feedback will not be displayed. You can activate the script progress bar by calling the function ScriptBar(0).
If the parameter Append is TRUE the data cube to be imported has to be of the same size as the existing one. The new data is imported as a new spectral group.
The function returns the following error codes:
0 ... everything is OK
-1 ... file does not exist or is locked
-2 ... the specified file is not an IGTIF file
-3 ... all group numbers are already used
-4 ... content type is not supported
-5 ... the spatial range does not match the existing dataset
-6 ... the range of time slots does not match the existing dataset
-7 ... one of the required keywords is missing
-8 ... the number of specified x- or y-coordinates does not match the lateral size of the dataset
-9 ... the number of specified time coordinates does not match the number of time slots
-10 ... the number of wavelenths does not match the number of layers
-11 ... the specification of the units is invalid (warning only!)
-12 ... the number of specified layers and the spectral data do not match