EmulateRasterOperations

MetafileRenderingOptions.EmulateRasterOperations property

Ottiene o imposta un valore che determina se le operazioni raster devono essere emulate o meno.

public bool EmulateRasterOperations { get; set; }

Osservazioni

È possibile utilizzare operazioni raster specifiche nei metafile. Non è possibile eseguirne il rendering direttamente in grafica vettoriale. L’emulazione delle operazioni raster richiede una rasterizzazione parziale della grafica vettoriale risultante che potrebbe influire sulle prestazioni di rendering del metafile.

Quando questo valore è impostato suVERO, Aspose.Words emula le operazioni raster. L’output risultante potrebbe parzialmente rasterizzato e le prestazioni potrebbero essere più lente.

Quando questo valore è impostato sufalso, Aspose.Words non emula le operazioni raster. Quando Aspose.Words incontra un’operazione raster in un metafile, esegue il fallback per eseguire il rendering del metafile in una bitmap utilizzando il sistema operativo .

Questa opzione viene utilizzata solo quando il metafile viene visualizzato come grafica vettoriale.

Il valore predefinito èVERO.

Esempi

Mostra aggiunto un fallback al rendering bitmap e modificando il tipo di avvisi sui record di metafile non supportati.

public void HandleBinaryRasterWarnings()
{
    Document doc = new Document(MyDir + "WMF with image.docx");

    MetafileRenderingOptions metafileRenderingOptions = new MetafileRenderingOptions();

    // Imposta la proprietà "EmulateRasterOperations" su "false" per tornare alla bitmap quando
    // incontra un metafile, che richiederà operazioni raster per il rendering nel PDF di output.
    metafileRenderingOptions.EmulateRasterOperations = false;

    // Imposta la proprietà "RenderingMode" su "VectorWithFallback" per provare a eseguire il rendering di ogni metafile utilizzando la grafica vettoriale.
    metafileRenderingOptions.RenderingMode = MetafileRenderingMode.VectorWithFallback;

    // Crea un oggetto "PdfSaveOptions" che possiamo passare al metodo "Save" del documento
    // per modificare il modo in cui il metodo converte il documento in .PDF e applica la configurazione
    // nel nostro oggetto MetafileRenderingOptions all'operazione di salvataggio.
    PdfSaveOptions saveOptions = new PdfSaveOptions();
    saveOptions.MetafileRenderingOptions = metafileRenderingOptions;

    HandleDocumentWarnings callback = new HandleDocumentWarnings();
    doc.WarningCallback = callback;

    doc.Save(ArtifactsDir + "PdfSaveOptions.HandleBinaryRasterWarnings.pdf", saveOptions);

    Assert.AreEqual(1, callback.Warnings.Count);
    Assert.AreEqual("'R2_XORPEN' binary raster operation is not supported.",
        callback.Warnings[0].Description);
}

/// <summary>
/// Stampa e raccoglie gli avvisi relativi alla perdita di formattazione che si verificano durante il salvataggio di un documento.
/// </summary>
public class HandleDocumentWarnings : IWarningCallback
{
    public void Warning(WarningInfo info)
    {
        if (info.WarningType == WarningType.MinorFormattingLoss)
        {
            Console.WriteLine("Unsupported operation: " + info.Description);
            Warnings.Warning(info);
        }
    }

    public WarningInfoCollection Warnings = new WarningInfoCollection();
}

Guarda anche

MetafileRenderingOptions.EmfPlusDualRenderingMode MetafileRenderingOptions.EmulateRenderingToSizeOnPage