use_gdi_emf_renderer property

ImageSaveOptions.use_gdi_emf_renderer property

Gets or sets a value determining whether to use GDI+ or Aspose.Words metafile renderer when saving to EMF.

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

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

Remarks

If set to True GDI+ metafile renderer is used. I.e. content is written to GDI+ graphics object and saved to metafile.

If set to False Aspose.Words metafile renderer is used. I.e. content is written directly to the metafile format with Aspose.Words.

Has effect only when saving to EMF.

GDI+ saving works only on .NET.

The default value is True.

Examples

Shows how to choose a renderer when converting a document to .emf.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.paragraph_format.style = doc.styles.get_by_name("Heading 1")
builder.writeln("Hello world!")
builder.insert_image(IMAGE_DIR + "Logo.jpg")

# When we save the document as an EMF image, we can pass a SaveOptions object to select a renderer for the image.
# If we set the "use_gdi_emf_renderer" flag to "True", Aspose.Words will use the GDI+ renderer.
# If we set the "use_gdi_emf_renderer" flag to "False", Aspose.Words will use its own metafile renderer.
save_options = aw.saving.ImageSaveOptions(aw.SaveFormat.EMF)
save_options.use_gdi_emf_renderer = use_gdi_emf_renderer

doc.save(ARTIFACTS_DIR + "ImageSaveOptions.renderer.emf", save_options)

# The GDI+ renderer usually creates larger files.
if use_gdi_emf_renderer:
    self.assertGreater(30000, os.path.getsize(ARTIFACTS_DIR + "ImageSaveOptions.renderer.emf"))
else:
    self.assertGreater(30000, os.path.getsize(ARTIFACTS_DIR + "ImageSaveOptions.renderer.emf"))

See Also

• module aspose.words.saving
• class ImageSaveOptions