Exit Codes and Messages
Exit codes
A batch file or a calling program should always test the exit code. Only 0 means that a new output file was written.
| Exit code | Meaning |
|---|---|
0 | The conversion succeeded. The output file is new. |
-1 | The conversion failed. No output file is left. |
1028 | ODB++ export is not possible because the path of the program folder is too long. See path rules. |
After a failed run, ImgScan deletes the output file, so an older file of the same name cannot be mistaken for a new result.
In a batch file, test with if %errorlevel% neq 0, as the first conversion does. The common if errorlevel 1 means “1 or higher” and misses -1, so it would report a failed run as a success.
Error messages
Every failed run ends with -*** ERROR : ImageScan was failed. The message before it names the cause.
| Message | Cause and remedy |
|---|---|
License is not set to this PC | No valid licence for this computer, or it has expired. Contact your supplier. |
Accuracy Level should be 1 or 2 | ACCURACY is out of range. |
BandWd shpould be 2000 or less | BDWIDTH is too large. |
Output folder does not exist or Output file( … ) is opened by the other program | Create the output folder, or close the program that has the output file open. |
ODB++ export needs a shorter program folder | Move the ImgScan folder closer to the root of the drive. Exit code 1028. |
Image data Importing was failed | The image cannot be read: it does not exist, its path contains a space, or it uses an encoding ImgScan cannot read. Save it as an uncompressed 8-bit .bmp and try again. |
CAD conversion (Pre-process) was failed, CAD conversion was failed, Intermediate Cad conversion nwas failed | Processing a band failed. Check the free space in %TEMP% and the free memory, or lower BDWIDTH. |
Post Merging was failed | The bands could not be joined. Check the free space in %TEMP%. |
No output file ( … ) | The export finished but wrote no file. Check the free space and the permissions of the output folder. |
Internal process was failed | A helper program in Exe failed. Check that the Exe folder is complete and that ImgScan was started from the ImgScan folder. |
Messages are shown exactly as ImgScan prints them, including their spelling, so that you can search for them.