readField method

TextField readField(
  1. DocumentImage image,
  2. String? documentName,
  3. String? fieldName
)

Reads a single field in a document.

param image The image that contains the document. Must be a realigned BGR image of the document. param documentName The name of the document to be searched. Must be a key loaded in DocumentLibrary. param fieldName The name of the field to search. return Read Text in the specified field. throws DocumentException An error has occurred during Document Library execution.

Implementation

TextField readField(DocumentImage image, String? documentName, String? fieldName) {
  Pointer<Char>? pDocumentName = documentName?.toNativeUtf8().cast<Char>();
  Pointer<Char>? pFieldName = fieldName?.toNativeUtf8().cast<Char>();
  TextField readText = TextField();
  try {
    var err = documentSDK.id3DocumentReader_ReadField(_pHandle.value, image.handle, pDocumentName ?? nullptr, pFieldName ?? nullptr, readText.handle);
    if (err != DocumentError.success.value) {
      readText.dispose();
      throw DocumentException(err);
    }
    return readText;
  } finally {
    if (pDocumentName != null) {
      calloc.free(pDocumentName);
    }
    if (pFieldName != null) {
      calloc.free(pFieldName);
    }
  }
}