DmlRenderingMode enumeration

DmlRenderingMode enumeration

Specifies how DrawingML shapes are rendered to fixed page formats.

Members

NameDescription
FALLBACKIf fall-back shape is available for DrawingML, Aspose.Words renders fall-back shape instead of the DrawingML.
DRAWING_MLAspose.Words ignores fall-back shape of DrawingML and renders DrawingML itself. This is the default mode.

Examples

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

doc = aw.Document(file_name=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 "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.dml_effects_rendering_mode = effects_rendering_mode
self.assertEqual(aw.saving.DmlRenderingMode.DRAWING_ML, options.dml_rendering_mode)
doc.save(file_name=ARTIFACTS_DIR + 'PdfSaveOptions.DrawingMLEffects.pdf', save_options=options)

Shows how to render fallback shapes when saving to PDF.

doc = aw.Document(file_name=MY_DIR + 'DrawingML shape fallbacks.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 "DmlRenderingMode" property to "DmlRenderingMode.Fallback"
# to substitute DML shapes with their fallback shapes.
# Set the "DmlRenderingMode" property to "DmlRenderingMode.DrawingML"
# to render the DML shapes themselves.
options.dml_rendering_mode = dml_rendering_mode
doc.save(file_name=ARTIFACTS_DIR + 'PdfSaveOptions.DrawingMLFallback.pdf', save_options=options)

See Also