preblend_images property

PdfSaveOptions.preblend_images property

Gets or sets a value determining whether or not to preblend transparent images with black background color.

@property
def preblend_images(self) -> bool:
    ...

@preblend_images.setter
def preblend_images(self, value: bool):
    ...

Remarks

Preblending images may improve PDF document visual appearance in Adobe Reader and remove anti-aliasing artifacts.

In order to properly display preblended images, PDF viewer application must support /Matte entry in soft-mask image dictionary. Also preblending images may decrease PDF rendering performance.

The default value is False.

Examples

Shows how to preblend images with transparent backgrounds while saving a document to PDF.

doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
builder.insert_image(file_name=IMAGE_DIR + 'Transparent background logo.png')
# Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
# to modify how that method converts the document to .PDF.
options = aw.saving.PdfSaveOptions()
# Set the "PreblendImages" property to "true" to preblend transparent images
# with a background, which may reduce artifacts.
# Set the "PreblendImages" property to "false" to render transparent images normally.
options.preblend_images = preblend_images
doc.save(file_name=ARTIFACTS_DIR + 'PdfSaveOptions.PreblendImages.pdf', save_options=options)

See Also

• module aspose.words.saving
• class PdfSaveOptions