Creates a word finder that is used to extract text in the host encoding from a PDF file.
|
Copy Code
|
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_PDF_doc_create_wordfinder_ucs(
HIG_PDF_DOC hDoc,
SHORT nAlgVersion,
WORD nFlags,
LPVOID lpClientData,
LPHIG_PDF_WORDFINDER lphWordFinder
);
|
|
| Name | Type | Description |
|---|---|---|
| hDoc | HIG_PDF_DOC | The document on which the word finder is used. |
| nAlgVersion | SHORT | The version of the word-finding algorithm to use. |
| nFlags | WORD | Word-finding options that determine the tables filled when using IG_PDF_wordfinder_acquire_word_list. Must be an OR of one or more of enumIGPDFWordFlags. |
| lpClientData | LPVOID | Pointer to user-supplied data to pass to the newly created word finder. Set to NULL. |
| lphWordFinder | LPHIG_PDF_WORDFINDER | Handle to the new WordFinder. |
Error count.
This function does not process image pixels.
The word finder also extracts text from Form XObjects that are executed in the page contents. For information about Form XObjects, see Section 4.9 in the PDF Reference.
This function also works for non-Roman (CJK or Chinese-Japanese-Korean) viewers. In this case, words are extracted to the host encoding. Users desiring Unicode output must use IG_PDF_doc_create_wordfinder_ucs, which does the extraction for Roman or non-Roman text.
The type of WordFinder determines the encoding of the string returned by IG_PDF_word_get_string. For instance, if IG_PDF_doc_create_wordfinder_ucs is used to create the word finder, IG_PDF_word_get_string returns only Unicode.
For CJK viewers, words are stored internally using CID encoding. For more information on CIDFonts and related topics, see Section 5.6 in the PDF Reference. For detailed information on CIDFonts, see Technical Note #5092, CID-Keyed Font Technology Overview, and Technical Note #5014, Adobe CMap and CIDFont Files Specification.