extractFace method

DocumentImage extractFace(
  1. DocumentImage image,
  2. String? documentName
)

Extracts a crop of the face 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. return The cropped image of the face. throws DocumentException An error has occurred during Document Library execution.

Implementation

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