DocumentReader.extractFace Method

Module: DocumentReader

Definition

Extracts a crop of the face in a document.

extract_face(self, image: DocumentImage, document_name: str) -> DocumentImage

Parameters

in The image that contains the document. Must be a realigned BGR image of the document.

document_name str
in The name of the document to be searched. Must be a key loaded in DocumentLibrary.

Returns

The cropped image of the face.

Exceptions

An error has occurred during Document Library execution.
DocumentImage extractFace(DocumentImage image, String? documentName)

Parameters

in The image that contains the document. Must be a realigned BGR image of the document.

documentName String
in The name of the document to be searched. Must be a key loaded in DocumentLibrary.

Returns

The cropped image of the face.

Exceptions

An error has occurred during Document Library execution.
public DocumentImage ExtractFace(DocumentImage image, string documentName)

Parameters

in The image that contains the document. Must be a realigned BGR image of the document.

documentName string
in The name of the document to be searched. Must be a key loaded in DocumentLibrary.

Returns

The cropped image of the face.

Exceptions

An error has occurred during Document Library execution.
public DocumentImage extractFace(DocumentImage image, String documentName) throws DocumentException

Parameters

in The image that contains the document. Must be a realigned BGR image of the document.

documentName String
in The name of the document to be searched. Must be a key loaded in DocumentLibrary.

Returns

The cropped image of the face.

Exceptions

An error has occurred during Document Library execution.
public func extractFace(image: DocumentImage, documentName: String) throws -> DocumentImage

Parameters

in The image that contains the document. Must be a realigned BGR image of the document.

documentName String
in The name of the document to be searched. Must be a key loaded in DocumentLibrary.

Returns

The cropped image of the face.

Exceptions

An error has occurred during Document Library execution.
int id3DocumentReader_ExtractFace (
    ID3_DOCUMENT_READER hDocumentReader,
    ID3_DOCUMENT_IMAGE hImage,
    const char * documentName,
    ID3_DOCUMENT_IMAGE hCroppedFace)

Parameters

hDocumentReader ID3_DOCUMENT_READER
in Handle to the DocumentReader object.

in The image that contains the document. Must be a realigned BGR image of the document.

documentName const char *
in The name of the document to be searched. Must be a key loaded in DocumentLibrary.

hCroppedFace ID3_DOCUMENT_IMAGE
out The cropped image of the face.

Returns

int
An error code.
See id3DocumentError file for the list of possible error codes.