DmlRenderingMode

Inheritance: java.lang.Object

public class DmlRenderingMode

Specifies how DrawingML shapes are rendered to fixed page formats.

Examples:

Shows how to render fallback shapes when saving to PDF.


 Document doc = new Document(getMyDir() + "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.
 PdfSaveOptions options = new 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.setDmlRenderingMode(dmlRenderingMode);

 doc.save(getArtifactsDir() + "PdfSaveOptions.DrawingMLFallback.pdf", options);
 

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


 Document doc = new Document(getMyDir() + "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.setDmlEffectsRenderingMode(effectsRenderingMode);

 Assert.assertEquals(DmlRenderingMode.DRAWING_ML, options.getDmlRenderingMode());

 doc.save(getArtifactsDir() + "PdfSaveOptions.DrawingMLEffects.pdf", options);
 

Fields

FieldDescription
DRAWING_MLAspose.Words ignores fall-back shape of DrawingML and renders DrawingML itself.
FALLBACKIf fall-back shape is available for DrawingML, Aspose.Words renders fall-back shape instead of the DrawingML.
length

Methods

MethodDescription
fromName(String dmlRenderingModeName)
getName(int dmlRenderingMode)
getValues()
toString(int dmlRenderingMode)

DRAWING_ML

public static int DRAWING_ML

Aspose.Words ignores fall-back shape of DrawingML and renders DrawingML itself. This is the default mode.

FALLBACK

public static int FALLBACK

If fall-back shape is available for DrawingML, Aspose.Words renders fall-back shape instead of the DrawingML.

Remarks:

Please note that after saving a document to a fixed page format with fall-back DML rendering mode, DML shapes in the AW document model are permanently replaced with their fall-back counterparts. As a result, saving the same document again will always use fall-back shapes, even if DmlRenderingMode is set to DRAWING_ML.

length

public static int length

fromName(String dmlRenderingModeName)

public static int fromName(String dmlRenderingModeName)

Parameters:

ParameterTypeDescription
dmlRenderingModeNamejava.lang.String

Returns: int

getName(int dmlRenderingMode)

public static String getName(int dmlRenderingMode)

Parameters:

ParameterTypeDescription
dmlRenderingModeint

Returns: java.lang.String

getValues()

public static int[] getValues()

Returns: int[]

toString(int dmlRenderingMode)

public static String toString(int dmlRenderingMode)

Parameters:

ParameterTypeDescription
dmlRenderingModeint

Returns: java.lang.String