MetafileRenderingOptions.UseGdiRasterOperationsEmulation

MetafileRenderingOptions UseGdiRasterOperationsEmulation property. Gets or sets a value determining whether or not to use the GDI for raster operations emulation.

MetafileRenderingOptions.UseGdiRasterOperationsEmulation property

Gets or sets a value determining whether or not to use the GDI+ for raster operations emulation.

public bool UseGdiRasterOperationsEmulation { get; set; }

Remarks

Windows GDI+ library could be used to emulate raster operations. It provides support for all raster operation comparing to Wordize own emulation but performance may be slower in some cases.

When this value is set to true, Wordize uses GDI+ for raster operations emulation.

When this value is set to false, Wordize uses its own implementation of raster operations emulation.

This option is used only when metafile is rendered as vector graphics.

The default value is false.

Examples

Shows how to configure metafile rendering.

PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();

// 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.
pdfSaveOptions.MetafileRenderingOptions.EmulateRasterOperations = false;

// Set the "RenderingMode" property to "VectorWithFallback" to try to render every metafile using vector graphics.
pdfSaveOptions.MetafileRenderingOptions.RenderingMode = MetafileRenderingMode.VectorWithFallback;

// Set the "EmfPlusDualRenderingMode" property to "EmfPlusDualRenderingMode.Emf"
// to only render the EMF part of an EMF+ dual metafile.
pdfSaveOptions.MetafileRenderingOptions.EmfPlusDualRenderingMode = MetafileEmfPlusDualRenderingMode.Emf;

// Set the "UseEmfEmbeddedToWmf" property to "true" to render embedded EMF data
// for metafiles that we can render as vector graphics.
pdfSaveOptions.MetafileRenderingOptions.UseEmfEmbeddedToWmf = true;

// Set the "EmulateRenderingToSizeOnPage" property to "false" to emulate metafile rendering to its default size in pixels.
pdfSaveOptions.MetafileRenderingOptions.EmulateRenderingToSizeOnPage = false;
pdfSaveOptions.MetafileRenderingOptions.EmulateRenderingToSizeOnPageResolution = 50;

// Wordize uses GDI+ for raster operations emulation, when value is set to true.
pdfSaveOptions.MetafileRenderingOptions.UseGdiRasterOperationsEmulation = true;

Converter.Create()
    .From(MyDir + "Simple.docx")
    .To(ArtifactsDir + "FixedPageSaveOptions.MetafileRenderingOptions.pdf", pdfSaveOptions)
    .Execute();

MetafileRenderingOptions.UseGdiRasterOperationsEmulation