Revert

Declaration:

Revert (FeedBack: boolean): integer;

Reloads the currently open data file. The name and path of the data file is taken from the meta information. Thus this function might fail if the data has been imported but not yet saved as an Epina ImageLab file. If the parameter FeedBack is TRUE a visual feedback of the loading progress is provided. Please note that unless the script progress bar is already visible you have to make it visible before calling Revert, otherwise the feedback will not be displayed. You can activate the script progress bar by calling the function ScriptBar(0). The function returns the following error codes:  0 ... everything is OK -1 ... the meta file contains a wrong or undefined content type -2 ... the metadata contains an invalid property id -3 ... invalid date time format in the metadata -4 ... cannot revert other than .ilab data -5 ... the metadata and the data cube do not match -6 ... the corresponding data file (.cube) is missing -7 ... the CRC checksum is missing -8 ... not enough memory, cannot load raw data(1) Please note that the data is not loaded if any error occurs except for error -7 (missing CRC). In this case the data is completely loaded (error -7 may occur with older .ilab files which do not contain the CRC checksum).

(1)

The error code -8 occurs only in 32 bit operating systems, because 64 bit OSes start paging the virtual memory to the harddisk if the memory request exceeds the available free physical memory. While this prevents a crash of the program, it does not really solve the problem of low memory since paging is several orders of magnitude slower than RAM access - which basically means that the computer slows down to an unacceptable level. Thus speaking in practical terms the system Epina ImageLab is running on should provide enough memory (at least twice the size of the biggest data file to be loaded).