re_collect_init(), re_collect

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: File title for a file in the KADMOS format for image collection.
save_value_min: The min. limit (rec_value) to collect images.
save_value_max: The max. limit (rec_value) to collect images.

Return value:

RE_SUCCESS or KADMOS error type.

Comment:

The return value RE_SUCCESS signals successful initialization, otherwise the error type is returned. image_file_title is the name of the image file and must be specified. This file will be created to take the images. If the file already exists, it first will be overwritten. If save_value_min or save_value_max are specified with a value different from zero, only images with confidence values (rec_value) within the given range will be collected. Image collection itself is performed by one of the functions rec_collect_kernel() or rel_collect_kernel().