EmulateRasterOperations

MetafileRenderingOptions.EmulateRasterOperations property

获取或设置确定是否应模拟光栅操作的值。

public bool EmulateRasterOperations { get; set; }

评论

可以在元文件中使用特定的光栅操作。它们不能直接渲染为矢量图形。 模拟光栅操作需要对结果矢量图形进行部分光栅化,这可能会影响 元文件渲染性能。

当此值设置为 true 时,Aspose.Words模拟光栅操作。结果输出可能 部分光栅化并且性能可能会更慢。

当此值设置为 false 时,Aspose.Words 不会模拟光栅操作。当 Aspose.Words 在元文件中遇到光栅操作时,它会回退到使用 操作系统将元文件渲染为位图。

此选项仅在元文件呈现为矢量图形时使用。

默认值为 true

例子

显示添加了位图渲染的后备和更改有关不受支持的元文件记录的警告类型。

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

    MetafileRenderingOptions metafileRenderingOptions = new MetafileRenderingOptions();

    // 将 "EmulateRasterOperations" 属性设置为 "false" 以在以下情况下回退到位图
    // 它遇到一个元文件,这将需要光栅操作才能在输出 PDF 中呈现。
    metafileRenderingOptions.EmulateRasterOperations = false;

    // 将“RenderingMode”属性设置为“VectorWithFallback”以尝试使用矢量图形渲染每个图元文件。
    metafileRenderingOptions.RenderingMode = MetafileRenderingMode.VectorWithFallback;

    // 创建一个“PdfSaveOptions”对象,我们可以将它传递给文档的“Save”方法
    // 修改该方法如何将文档转换为 .PDF 并应用配置
    // 在我们的 MetafileRenderingOptions 对象中进行保存操作。
    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 partly supported.",
        callback.Warnings[0].Description);
}

/// <summary>
/// 打印并收集保存文档时出现的与格式丢失相关的警告。
/// </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();
}

也可以看看