re_collect_init(), re_collect_winit()

extern KADMOS_ERROR KADMOS_API re_collect_init
(const char *image_file_title, unsigned char save_value_min,
unsigned char save_value_max);

extern KADMOS_ERROR KADMOS_API re_collect_winit
(const wchar_t *image_file_title, unsigned char save_value_min,
unsigned char save_value_max);

Parameter:

image_file_title
String mit dem Namen einer Datei, in die die gesammelten Bilder geschrieben werden sollen. Die Datei wird im Rasterbild-Format von KADMOS angelegt.
save_value_min
Untergrenze (rec_value), ab der Bilder gesammelt werden sollen.
save_value_max
Obergrenze (rec_value), bis zu der Bilder gesammelt werden sollen.

Rückgabewert:

RE_SUCCESS oder KADMOS-Fehlertyp.

Bemerkung:

Der Rückgabewert signalisiert mit RE_SUCCESS eine erfolgreiche Initialisierung, im Fehlerfall wird ein Fehlertyp zurückgeliefert. Unter image_file_title spezifiziere man den Namen der zu erzeugenden Datei, in welcher die Bilder anschliessend gesammelt werden sollen. Sind save_value_min bzw. save_value_max von Null verschieden, so werden im folgenden nur solche Bilder gesammelt, deren Vertrauenswert (rec_value) grösser oder gleich save_value_min bzw. kleiner oder gleich save_value_max ist. Sind beide Werte Null, so werden alle Bilder gesammelt. Das Sammeln der Bildüer erfolgt durch Aufrufe von rec_collect_kernel() oder rel_collect_kernel().

Verweise: