LoadOptionsConvertMetafilesToPng Property

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

Namespace:  Aspose.Words
Assembly:  Aspose.Words (in Aspose.Words.dll) Version: 21.2.0


public bool ConvertMetafilesToPng { get; set; }

Property Value

Type: Boolean


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.


Shows how to convert WMF/EMF to PNG during loading document.
Document doc = new Document();

            Shape shape = new Shape(doc, ShapeType.Image);
            shape.ImageData.SetImage(ImageDir + "Windows MetaFile.wmf");
            shape.Width = 100;
            shape.Height = 100;


            doc.Save(ArtifactsDir + "Image.CreateImageDirectly.docx");

            shape = (Shape)doc.GetChild(NodeType.Shape, 0, true);

            TestUtil.VerifyImageInShape(1600, 1600, ImageType.Wmf, shape);

            LoadOptions loadOptions = new LoadOptions();
            loadOptions.ConvertMetafilesToPng = true;

            doc = new Document(ArtifactsDir + "Image.CreateImageDirectly.docx", loadOptions);
            shape = (Shape)doc.GetChild(NodeType.Shape, 0, true);

#if NET462
            TestUtil.VerifyImageInShape(1666, 1666, ImageType.Png, shape);
            TestUtil.VerifyImageInShape(1600, 1600, ImageType.Png, shape);

ExpandedSee Also