convert_metafiles_to_png property

LoadOptions.convert_metafiles_to_png property

Gets or sets whether to convert metafile(Wmf or Emf) images to Png image format.

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

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

Remarks

Metafiles (Wmf or Emf) is an uncompressed image format and sometimes requires to much RAM to hold and process document. This option allows to convert all metafile images to Png on document loading. Please note - conversion vector graphics to raster decreases quality of the images.

Examples

Shows how to convert WMF/EMF to PNG during loading document.

doc = aw.Document()
shape = aw.drawing.Shape(doc, aw.drawing.ShapeType.IMAGE)
shape.image_data.set_image(file_name=IMAGE_DIR + 'Windows MetaFile.wmf')
shape.width = 100
shape.height = 100
doc.first_section.body.first_paragraph.append_child(shape)
doc.save(file_name=ARTIFACTS_DIR + 'Image.CreateImageDirectly.docx')
shape = doc.get_child(aw.NodeType.SHAPE, 0, True).as_shape()
test_util.TestUtil.verify_image_in_shape(1600, 1600, aw.drawing.ImageType.WMF, shape)
load_options = aw.loading.LoadOptions()
load_options.convert_metafiles_to_png = True
doc = aw.Document(file_name=ARTIFACTS_DIR + 'Image.CreateImageDirectly.docx', load_options=load_options)
shape = doc.get_child(aw.NodeType.SHAPE, 0, True).as_shape()
test_util.TestUtil.verify_image_in_shape(1666, 1666, aw.drawing.ImageType.PNG, shape)

See Also