emulate_rendering_to_size_on_page_resolution property

MetafileRenderingOptions.emulate_rendering_to_size_on_page_resolution property

Gets or sets the resolution in pixels per inch for the emulation of metafile rendering to the size on page.

@property
def emulate_rendering_to_size_on_page_resolution(self) -> int:
    ...

@emulate_rendering_to_size_on_page_resolution.setter
def emulate_rendering_to_size_on_page_resolution(self, value: int):
    ...

Remarks

This option is used only when MetafileRenderingOptions.emulate_rendering_to_size_on_page is set to True.

The default value is 96. This is a default display resolution. I.e. metafile rendering will emulate the display of the metafile in MS Word with a 100% zoom factor.

Examples

Shows how to display of the metafile according to the size on page.

doc = aw.Document(MY_DIR + "WMF with text.docx")

# Create a "PdfSaveOptions" object that we can pass to the document's "save" method
# to modify how that method converts the document to .PDF.
save_options = aw.saving.PdfSaveOptions()

# Set the "EmulateRenderingToSizeOnPage" property to "true"
# to emulate rendering according to the metafile size on page.
# Set the "EmulateRenderingToSizeOnPage" property to "false"
# to emulate metafile rendering to its default size in pixels.
save_options.metafile_rendering_options.emulate_rendering_to_size_on_page = render_to_size
save_options.metafile_rendering_options.emulate_rendering_to_size_on_page_resolution = 50

doc.save(ARTIFACTS_DIR + "PdfSaveOptions.EmulateRenderingToSizeOnPage.pdf", save_options)

See Also

MetafileRenderingOptions.emulate_rendering_to_size_on_page property MetafileRenderingOptions.rendering_mode property