PDFlib Text Extraction Toolkit (TET) Manual

tected PDF (after the search engine indexed the contents and the hit list contained a link
to the PDF), the document’s internal permission settings will protect the document as
usual when accessed by the user.
The shrug feature for protected documents. TET offers a feature which can be used to
extract text and images from protected documents, assuming the TET user accepts responsibility
for respecting the document author’s rights. This feature is called shrug,
and works as follows: by supplying the shrug option to TET_open_document( ) the user asserts
that he or she will not violate any document authors’ rights. PDFlib GmbH’s terms
and conditions require that TET customers respect PDF permission settings.
If all of the following conditions are true, the shrug feature will be enabled:
> The shrug option has been supplied to TET_open_document( ).
> The document requires a master password but it has not been supplied to TET_open_
document( ).
> If the document requires a user (open) password, it must have been supplied to TET_
open_document( ).
> Text extraction is not allowed in the document’s permission settings, i.e.
nocopy=true.
The shrug feature will have the following effects:
> Extracting content from the document is allowed despite nocopy=true. The user is responsible
for respecting the document author’s rights.
> The pCOS pseudo object shrug will be set to true/1.
> pCOS runs in full mode (instead of restricted mode), i.e. the pcosmode pseudo object
will be set to 2.
The shrug pseudo object can be used according to the following idiom to determine
whether or not the contents can directly be made available to the user, or should only
be used for indexing and similar indirect purposes:
int doc = tet.open_document(filename, "shrug");
...
if ((int) tet.pcos_get_number(doc, "shrug") == 1)
{
/* only indexing allowed */
}
else
{
/* content may be delivered to the user */
}
50 Chapter 5: Configuration