转换选项：包含图像和注释

概述

在将 PDF 文档转换为各种格式的过程中，ComPDF Conversion SDK 为用户提供了两个额外选项：一个用于确定生成的文档中是否包含图像，另一个用于决定是否保留 PDF 文件中的注释。

• 启用"包含图像"选项后，ComPDF Conversion SDK 将从 PDF 文档中提取图像，并将其嵌入到输出文件中相应的页面和位置。对于存在重叠图像的区域，ComPDF Conversion SDK 会将这些图像合并为一个，并将其嵌入到输出文件对应页面的精确位置。

• 选择"包含注释"选项时，大多数注释会被转换为光栅图像并嵌入到文档中的相应位置。然而，某些类型的注释（如高亮、下划线、删除线和波浪线）会被转换为转换后的 Word、PPT 和 HTML 文档中相应的格式等效项，并标记在相应的文本上。需要注意的是，转换并非在所有情况下都是 100% 精确的。

在 ComPDF Conversion SDK 中，包含图像和注释的选项通常用于以下格式转换：

• PDF 转 Word
• PDF 转 Excel
• PDF 转 PowerPoint
• PDF 转 HTML
• PDF 转 RTF
• PDF 转 JSON
• PDF 转 Markdown

关于文本标记注释

• 高亮： 当将 PDF 转换为 Word 格式并保留高亮标记时，需要注意的是，Microsoft Word 仅支持 15 种高亮颜色。为了尽可能接近原始文档的外观，Word 文档中的文本将使用与原始文档高亮注释颜色匹配的文本背景颜色进行标记。对于转换为 Microsoft PPT 格式，使用该格式原生的高亮功能来标记文本。在转换为 HTML 格式的情况下，会为标记的文本创建一个独特的 <span> 标签，并将背景样式设置为与原始文档中对应注释的颜色匹配。

• 下划线和波浪线： 当将 PDF 转换为 Word 或 PPT 格式并保留下划线和波浪线标记时，标记的文本将在 Microsoft Office 中以相同的样式标记。当转换为 HTML 格式时，标记的文本将设置样式以显示相同的效果。但是，如果原始文档中的一段文本同时被下划线和波浪线标记，则该文本将仅显示一种标记类型（因为波浪线实际上是 Word、PPT 和 HTML 格式中下划线的一种类型）。

• 删除线： 当将删除线标记转换为 Word 和 PowerPoint 格式时，标记的文本将添加 Microsoft Office 原生支持的删除线。但是，在这两种文件格式中，删除线本身的颜色无法与原始 PDF 文档中的颜色相同，因为 Word 和 PPT 中的删除线颜色只会根据标记文本字体本身的颜色而变化。当转换为 HTML 格式时，将显示与原始文档相同的删除线颜色。

示例

此示例演示了如何使用 ComPDF Conversion SDK 将 PDF 文档转换为 Word 文档，并选择选项：包含图像和注释。

WordOptions *options = [[WordOptions alloc] init];
options.containImage = YES;
options.containAnnotation = YES;
[CPDFConversion startPDFToWord:@"input.pdf" password:@"password" outputPath:@"path/output.docx" options:options];