DmlEffectsRenderingMode enumeration

DmlEffectsRenderingMode enumeration

Specifies how DrawingML effects are rendered to fixed page formats.


SIMPLIFIEDRendering of DrawingML effects are simplified.
NONENo DrawingML effects are rendered.
FINEDrawingML effects are rendered in fine mode which involves advanced processing. In this mode rendering of effects gives better results but at a higher performance cost than DmlEffectsRenderingMode.SIMPLIFIED mode.


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

doc = aw.Document(MY_DIR + "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.
options = aw.saving.PdfSaveOptions()

# Set the "dml_effects_rendering_mode" property to "DmlEffectsRenderingMode.NONE" to discard all DrawingML effects.
# Set the "dml_effects_rendering_mode" property to "DmlEffectsRenderingMode.SIMPLIFIED"
# to render a simplified version of DrawingML effects.
# Set the "dml_effects_rendering_mode" property to "DmlEffectsRenderingMode.FINE" to
# render DrawingML effects with more accuracy and also with more processing cost.
options.dml_effects_rendering_mode = effects_rendering_mode

self.assertEqual(aw.saving.DmlRenderingMode.DRAWING_ML, options.dml_rendering_mode) + "PdfSaveOptions.drawing_ml_effects.pdf", options)

See Also