pdftools_sdk.pdf_a.conversion.conversion_options

Classes

ConversionOptions()

The PDF/A conversion options

class pdftools_sdk.pdf_a.conversion.conversion_options.ConversionOptions[source]

Bases: _NativeObject

The PDF/A conversion options

The options for the conversion of documents using the converter’s method pdftools_sdk.pdf_a.conversion.converter.Converter.convert()

__init__()[source]

property conformance: Conformance | None

The minimal target conformance

If a conformance is set, it is used as the minimal target conformance. The PDF/A version of the conformance must match the PDF/A version of the analysisOptions of pdftools_sdk.pdf_a.validation.validator.Validator.analyze() . If the conformance level cannot be achieved, the conversion will abort with the error pdftools_sdk.conformance_error.ConformanceError . If a higher conformance level can be achieved, it is used automatically.

If None is used, the optimal conformance determined in the analysis (i.e. pdftools_sdk.pdf_a.validation.analysis_result.AnalysisResult.recommended_conformance ) is used. It is highly recommended to use None.

Default value: None

Returns:: Optional[pdftools_sdk.pdf.conformance.Conformance]

property copy_metadata: bool

Whether to copy metadata

Copy document information dictionary and XMP metadata. Default: True.

Returns:: bool

property image_quality: float

Image quality of recompressed images

The image quality for images that use a prohibited lossy compression type and must be recompressed. Supported values are 0.01 to 1.0. A higher value means better visual quality at the cost of a larger file size. Recommended values range from 0.7 to 0.9.

Example: JPX (JPEG2000) is not allowed in PDF/A-1. If a PDF contains a JPX compressed image, its compression type must be altered. Thus the image is converted to an image with JPEG compression using the image quality defined by this property. Default value: 0.8

Returns:: float