MetafileRenderingOptions class

MetafileRenderingOptions class

Allows to specify additional metafile rendering options. To learn more, visit the Handling Windows Metafiles documentation article.

Constructors

Name	Description
MetafileRenderingOptions()	The default constructor.

Properties

Name	Description
emf_plus_dual_rendering_mode	Gets or sets a value determining how EMF+ Dual metafiles should be rendered.
emulate_raster_operations	Gets or sets a value determining whether or not the raster operations should be emulated.
emulate_rendering_to_size_on_page	Gets or sets a value determining whether metafile rendering emulates the display of the metafile according to the size on page or the display of the metafile in its default size.
emulate_rendering_to_size_on_page_resolution	Gets or sets the resolution in pixels per inch for the emulation of metafile rendering to the size on page.
rendering_mode	Gets or sets a value determining how metafile images should be rendered.
use_emf_embedded_to_wmf	Gets or sets a value determining how WMF metafiles with embedded EMF metafiles should be rendered.
use_gdi_raster_operations_emulation	Gets or sets a value determining whether or not to use the GDI+ for raster operations emulation.

Examples

Shows added a fallback to bitmap rendering and changing type of warnings about unsupported metafile records.

doc = aw.Document(file_name=MY_DIR + 'WMF with image.docx')
metafile_rendering_options = aw.saving.MetafileRenderingOptions()
# Set the "EmulateRasterOperations" property to "false" to fall back to bitmap when
# it encounters a metafile, which will require raster operations to render in the output PDF.
metafile_rendering_options.emulate_raster_operations = False
# Set the "RenderingMode" property to "VectorWithFallback" to try to render every metafile using vector graphics.
metafile_rendering_options.rendering_mode = aw.saving.MetafileRenderingMode.VECTOR_WITH_FALLBACK
# Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
# to modify how that method converts the document to .PDF and applies the configuration
# in our MetafileRenderingOptions object to the saving operation.
save_options = aw.saving.PdfSaveOptions()
save_options.metafile_rendering_options = metafile_rendering_options
callback = self.HandleDocumentWarnings()
doc.warning_callback = callback
doc.save(file_name=ARTIFACTS_DIR + 'PdfSaveOptions.HandleBinaryRasterWarnings.pdf', save_options=save_options)
self.assertEqual(1, callback.warnings.count)
self.assertEqual("'R2_XORPEN' binary raster operation is not supported.", callback.warnings[0].description)

Shows added a fallback to bitmap rendering and changing type of warnings about unsupported metafile records (HandleDocumentWarnings).

class HandleDocumentWarnings(aw.IWarningCallback):

    def __init__(self):
        self.warnings = aw.WarningInfoCollection()

    def warning(self, info):
        if info.warning_type == aw.WarningType.MINOR_FORMATTING_LOSS:
            print('Unsupported operation: ' + info.description)
            self.warnings.warning(info)

See Also

• module aspose.words.saving