pdftools_sdk.optimization.removal_options
Classes
|
The parameters defining the optional data to remove or flatten |
- class pdftools_sdk.optimization.removal_options.RemovalOptions(handle)[source]
Bases:
_NativeObject
The parameters defining the optional data to remove or flatten
Removal options specify the PDF data structures to copy or remove, e.g. article threads, metadata, or alternate images.
In addition, the visual appearances of signatures, annotations, form fields, and links can be flattened.
Flattening means, that the appearance of such a data structure is drawn as non-editable graphic onto the page; for visual appearances of signatures, flattening has a slightly different meaning (see property
pdftools_sdk.optimization.removal_options.RemovalOptions.remove_signature_appearances
).- property remove_alternate_images: bool
Whether to remove additional or alternative versions of images
Default is False except in the profile
pdftools_sdk.optimization.profiles.print.Print
.- Returns:
bool
- property remove_article_threads: bool
Whether to remove the sequential flows (threads) of articles
Default is True except in the profile
pdftools_sdk.optimization.profiles.archive.Archive
.- Returns:
bool
- property remove_metadata: bool
Whether to remove document’s XMP metadata
Default:
pdftools_sdk.optimization.profiles.web.Web
profile: Truepdftools_sdk.optimization.profiles.print.Print
profile: Falsepdftools_sdk.optimization.profiles.archive.Archive
profile: Falsepdftools_sdk.optimization.profiles.minimal_file_size.MinimalFileSize
profile: Truepdftools_sdk.optimization.profiles.mrc.Mrc
profile: False
- Returns:
bool
- property remove_output_intents: bool
Whether to remove all output intents
Output intents provide a means for matching the color characteristics of PDF page content with those of a target output device or production environment in which the document will be printed.
Default is False except in the profile
pdftools_sdk.optimization.profiles.minimal_file_size.MinimalFileSize
.- Returns:
bool
- property remove_piece_info: bool
Whether to remove the piece-info dictionary (private PDF processor data)
The removal of this proprietary application data has no effect on the document’s visual appearance.
Default is True except in the profile
pdftools_sdk.optimization.profiles.archive.Archive
.- Returns:
bool
- property remove_structure_tree: bool
Whether to remove the data describing the logical structure of a PDF
The logical structure of the document is a description of the content of its pages. It consists of a fine granular hierarchical tagging that distinguishes between the actual content and artifacts (such as page numbers, layout artifacts, etc.). The tagging provides a meaningful description, for example “This is a header”, “This color image shows a small sailing boat at sunset”, etc. This information can be used e.g. to read the document to the visually impaired.
Default is True except in the profile
pdftools_sdk.optimization.profiles.archive.Archive
.- Returns:
bool
- property remove_thumbnails: bool
Whether to remove thumbnail images which represent the PDF pages in miniature form
Default is True in all profiles.
- Returns:
bool
- property remove_signature_appearances: RemovalStrategy
Whether to remove or flatten signature appearances
A signature in a PDF consist of two parts:
(a) The invisible digital signature in the PDF.
(b) The visual appearance that was attributed to the signature.
Part (a) can be used by a viewing application, to verify that the PDF has not changed since it has been signed and report this to the user.
During optimizing, the PDF is altered and hence its digital signature (a) is broken and must be removed.
pdftools_sdk.optimization.removal_strategy.RemovalStrategy.FLATTEN
: (a) is removed and (b) is drawn as non-editable graphic onto the page. Within the context of signatures this is called “flattening”.pdftools_sdk.optimization.removal_strategy.RemovalStrategy.REMOVE
: (a) and (b) are removed.
Default is
pdftools_sdk.optimization.removal_strategy.RemovalStrategy.FLATTEN
in all profiles.- Returns:
pdftools_sdk.optimization.removal_strategy.RemovalStrategy
- property annotations: ConversionStrategy
The conversion strategy for annotations
The conversion strategy for annotations.
Annotations in PDF are interactive elements on the pages, such as:
Sticky notes
Free text annotations
Line, square, circle, and polygon annotations
Highlight, underline and strikeout annotations
Stamp annotations
Ink annotations
File attachment annotation
Sound and movie annotations
3D annotations
Note that this does not include form fields (see
pdftools_sdk.optimization.removal_options.RemovalOptions.form_fields
) and links (seepdftools_sdk.optimization.removal_options.RemovalOptions.links
).Default is
pdftools_sdk.optimization.conversion_strategy.ConversionStrategy.COPY
in all profiles.- Returns:
pdftools_sdk.optimization.conversion_strategy.ConversionStrategy
- property form_fields: ConversionStrategy
The conversion strategy for interactive forms
Default is
pdftools_sdk.optimization.conversion_strategy.ConversionStrategy.COPY
in all profiles.- Returns:
pdftools_sdk.optimization.conversion_strategy.ConversionStrategy
- property links: ConversionStrategy
The conversion strategy for links
Default is
pdftools_sdk.optimization.conversion_strategy.ConversionStrategy.COPY
in all profiles.- Returns:
pdftools_sdk.optimization.conversion_strategy.ConversionStrategy