PdfSaveOptions.DmlEffectsRenderingMode property

Gets or sets a value determining how DrawingML effects are rendered.

public override DmlEffectsRenderingMode DmlEffectsRenderingMode { get; set; }


The default value is Simplified.

This property is used when the document is exported to fixed page formats.

If Compliance is set to PdfA1a or PdfA1b, property always returns None.


Shows how to configure the rendering quality of DrawingML effects in a document as we save it to PDF.

Document doc = new Document(MyDir + "DrawingML shape effects.docx");

// Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
// to modify how that method converts the document to .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// Set the "DmlEffectsRenderingMode" property to "DmlEffectsRenderingMode.None" to discard all DrawingML effects.
// Set the "DmlEffectsRenderingMode" property to "DmlEffectsRenderingMode.Simplified"
// to render a simplified version of DrawingML effects.
// Set the "DmlEffectsRenderingMode" property to "DmlEffectsRenderingMode.Fine" to
// render DrawingML effects with more accuracy and also with more processing cost.
options.DmlEffectsRenderingMode = effectsRenderingMode;

Assert.AreEqual(DmlRenderingMode.DrawingML, options.DmlRenderingMode);

doc.Save(ArtifactsDir + "PdfSaveOptions.DrawingMLEffects.pdf", options);

See Also