Checklist for KADMOS Integration

The following checklist is to help programmers solve problems with the integration of KADMOS. Have also a look for bugfixes and news under Bugs & News.

Problem: Installation

Install your developer kit with the delivered setup file and save the KADMOS.LIC (DLL version only) once before the authorization and a once after the authorization. The authorization must be done as Administrator. Before installing an update, first delete all old KADMOS files. Ensure that all the files listed under KADMOS files are available after installation.

Problem: Compiler

Check if your compiler and your compiler version is compatible with the KADMOS version.

Problem: Recognition

The developer kit contains sample programs. For Windows you will find a related project file *.vcprj for every sample program. Use your developer workbench to retrieve from these files the relevant compiler and linker switch settings. Compile, link, and test these programs in your development environment in the order REC, REL, REP. You can also set different compiler switch settings from those of the KADMOS default settings. But check them first with our demo programs.
Check the provided image data. If possible, try to integrate the sample images supplied with the toolkit into your own program. Ensure that you handle and deliver these images in the same way as shown in the sample programs. Check especially the following points:
- The data of the image must be stored under image to use re?_do() 🗏
- Direct before the recognition the image can be written into a Bmp file with the function re_writeimage() 🗏
These data should be checked for example with the program famulus.exe.
The image data can be written into a raster image file with the functions rec_collect_kernel(), and rel_collect_kernel() 🗏
This file can be checked with the program sichten.exe from the SDK. If you observe errors or odd effects with the recognition of single images, please proceed as follows:
Save the images from your program as Bmp files onto your harddisk.
Use the program famulus.exe from your developer kit to view these files.
The program famulus.exe from your developer kit is linked with exactly the same library that is contained in your kit. This way you can always check if the observed error was caused by KADMOS or if it is to be found somewhere else. If an error is found in KADMOS, please send the related Bmp file to Kadmos GmbH so that it can be analysed and the error can be fixed.

⚠️ The DLL version contains a software copy protection. Please keep in mind that you have only 30 days to get a triggercode.

Problem: Parameter Setting

Check the sequence of the steps up to the recognition.

Initialization

These parameters of ReInit 🗏 must be set before the initialization. These parameters are:
rel_grid_maxlen contains the number of actually recognized structure elements.
rel_graph_maxlen Maximum length (number of nodes) of the result graph.
rel_result_maxlen Maximum number of elements in rel_result.
rep_memory To record the results rep_result(s).
rep_memory_size Available memory size for rep_do().
The initialization with rec_init() , rel_init() or rep_init() sets the parameters of ReParm with default values. 🗏 🗏

Recognition

Setting of the parameters of ReParm 🗏 when it is necessary. These parameters are for preprocessing, segmentation, classification, codepages ...
They can be changed before every call of rec_do() , rel_do() or rep_do(). 🗏
When they are set before initialization, the call of re?_init() will overwrite them with the default setting.