EmulateRasterOperations

MetafileRenderingOptions.EmulateRasterOperations property

Obtient ou définit une valeur déterminant si les opérations raster doivent être émulées ou non.

public bool EmulateRasterOperations { get; set; }

Remarques

Des opérations raster spécifiques peuvent être utilisées dans les métafichiers. Elles ne peuvent pas être restituées directement en images vectorielles. L’émulation d’opérations raster nécessite une rastérisation partielle des images vectorielles obtenues, ce qui peut affecter les performances de rendu des métafichiers.

Lorsque cette valeur est définie survraiAspose.Words émule les opérations raster. Le résultat peut être partiellement rastérisé et les performances peuvent être ralenties.

Lorsque cette valeur est définie surFAUXAspose.Words n’émule pas les opérations raster. Lorsqu’Aspose.Words rencontre une opération raster dans un métafichier, il restitue le métafichier en bitmap à l’aide du système d’exploitation .

Cette option est utilisée uniquement lorsque le métafichier est rendu sous forme de graphiques vectoriels.

La valeur par défaut estvrai.

Exemples

Affiche un retour au rendu bitmap et un changement de type d’avertissements concernant les enregistrements de métafichiers non pris en charge.

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

    MetafileRenderingOptions metafileRenderingOptions = new MetafileRenderingOptions();

    // Définissez la propriété « EmulateRasterOperations » sur « false » pour revenir au bitmap lorsque
    // il rencontre un métafichier, qui nécessitera des opérations raster pour être rendu dans le PDF de sortie.
    metafileRenderingOptions.EmulateRasterOperations = false;

    // Définissez la propriété « RenderingMode » sur « VectorWithFallback » pour essayer de restituer chaque métafichier à l'aide de graphiques vectoriels.
    metafileRenderingOptions.RenderingMode = MetafileRenderingMode.VectorWithFallback;

    // Créez un objet « PdfSaveOptions » que nous pouvons transmettre à la méthode « Save » du document
    // pour modifier la façon dont cette méthode convertit le document en .PDF et applique la configuration
    // dans notre objet MetafileRenderingOptions pour l'opération de sauvegarde.
    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>
/// Imprime et collecte les avertissements liés à la perte de formatage qui se produisent lors de l'enregistrement d'un document.
/// </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();
}

Voir également