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
- module aspose.words.loading
- class LoadOptions