rel_textline(), repr_textline(), rep_textline()

extern KADMOS_ERROR KADMOS_API rel_textline
  (const RelData *reldata, void *buffer, int buffsize,
  long buffer_code, unsigned char reject_level,
  int reject_char, long text_format);

extern KADMOS_ERROR KADMOS_API repr_textline
  (const RepResult *repdata, void *buffer, int buffsize,
  long buffer_code, unsigned char reject_level,
  int reject_char, long text_format);

extern KADMOS_ERROR KADMOS_API rep_textline
  (const RepData *repdata, int line_number, void *buffer, int buffsize,
  long buffer_code, unsigned char reject_level,
  int reject_char, long text_format);

Parameter:

reldata, repdata
Pointer to a structure RelData or RepData.
line_number
Line number in the data structure rep_data.
buffer
Pointer to a memory to take the result.
buffsize
Size of buffer in bytes.
buffer_code
Code page for the character coding.
reject_level
Minimum confidence level to output the recognized character.
reject_char
Character to display a reject.
text_format
Return the text line as TEXT_FORMAT_ANSI or TEXT_FORMAT_KADMOS_MulTIBYTE. TEXT_FORMAT_RELRESulT_INDICES can be used as parameter text_format with the functions re*_textline(). With the call buffer delivers the sequence of RelResult data of the recognised characters. The result graphs of rel_do() or rep_do() are sorted in a way that the recognised characters are arranged from left to right, with the output of the components of accented characters from top to bottom. In some languages accented characters must be written in different order. In Thai for instance the main character first, then the upper accents from bottom to top, and then the lower accent. The functions re*_textline() order the output characters automatical. But some users need the exact position of the characters and accents and therefore need access to the structures RelResult. The related indices can be retrieved by a call of re*_textline() with the parameter text_format set to TEXT_FORMAT_RELRESulT_INDICES.

Return value:

RE_SUCCESS or KADMOS error type.

Comment:

This function generates a string with the recognition results of one line after a call to re?_do(). The output starts when the function re?_do() is finished. With rep_textline() the textlines can be processed line by line using line_number. With repr_textline() the recognition results can be evaluated as soon as rep_do() has recognized single lines. The result string contains the best choice of the segmentation and also the best of the alternative single character results. If reject_level is specified different from zero, all characters with a confidence level (rec_value) larger than this reject level will also be represented by reject_char. The parameter code is to specify a code page for the character output. If no special setting is required, use the code page setting from rep.parm.code.

Reference: