rep_text()

extern void * KADMOS_API rep_text
  (const RepData *, long output_code, unsigned char reject_level,
  int reject_char, char *indent, int indent_count, long text_format);
      

Parameter:

repdata
Pointer to a structure RepData.
output_code
The code page in which the text is displayed.
reject_level
Minimum confidence level to output the recognized character..
reject_char
Character to be used in case of rejection.
indent
Leading characters such as Spaces.
indent_count
Number of ident.
text_format
Output format of the text line as TEXT_FORMAT_ANSI or TEXT_FORMAT_KADMOS_MULTIBYTE. TEXT_FORMAT_RELRESULT_INDICES provides the output sequence of the individual recognized characters under 'buffer'. The result graphs of rel_do() or rep_do() are always arranged so that the recognized characters are lined up from left to right. For accented characters, the components are output from top to bottom.
In Thai e.g. For texts, the main character must always be written first, then the upper accents from bottom to top, then the lower accent. The functions re * _textline() also do this automatically. However, some integrators explicitly need the positions of the characters and accents, so they must access the associated RelResult structures. This is possible by calling re * _textline() with the parameter TEXT_FORMAT_RELRESULT_INDICES.

Return value:

RE_SUCCESS or KADMOS error type.

Comment:

rep_text() returns the full result text of a paragraph. rep.init.rep_memory must be allocated before this. With a call to free (return_value), the allocated memory can be freed again.

If successful, the function RE_SUCCESS returns, in case of error a corresponding error type. Clear text information about errors that have occurred can be queried with re_GetErrorText() or displayed with re_DisplayErrorText().

Reference: