PDF、SVG 与文本转换

安装 Ofdrw.Net.Converter 元包，或按方向安装 Ofdrw.Net.Converter.Pdf / Ofdrw.Net.Converter.Svg。以下 API 的页索引均从 0 开始；CLI 页号从 1 开始。

方向	入口	默认行为
PDF → OFD	`PdfToOfdConverter`	页面图 + 透明文字层
OFD → PDF	`OfdToPdfConverter`	按页导出 PDF 预览
OFD → SVG	`OfdToSvgConverter`	导出自包含单页 SVG
OFD → 文本	`OfdTextExtractor`	根据页面文字对象和坐标重建文本

PDF 转 OFD

using Ofdrw.Net.Converter.Pdf.Converters;

await using var input = File.OpenRead("input.pdf");
await using var output = File.Create("output.ofd");
await new PdfToOfdConverter().ConvertAsync(input, output);

默认双层转换用渲染页面保持视觉内容，同时保留可抽取的 PDF 文字作为定位透明文字：

扫描 PDF 不会自动获得 OCR 文本。
PDF 默认抽取顺序不保证多栏、双向文字或复杂页面的逻辑阅读顺序。
可选原生 PathObject / TextObject 输出见PDF 矢量扩展，它是独立源码扩展，不是默认路径。
书签和附件迁移默认关闭，需显式启用；见PDF 导航与附件。

OFD 转 PDF

using Ofdrw.Net.Converter.Pdf.Converters;

await using var input = File.OpenRead("input.ofd");
await using var output = File.Create("preview.pdf");

// 省略第三个参数可导出全部页面；这里导出第 3 页、第 1 页、第 3 页。
await new OfdToPdfConverter().ConvertAsync(input, output, new[] { 2, 0, 2 });

页选择保留列表顺序和重复页。渲染失败不会用丢失正文的空白页冒充成功。

签章外观无法解析或绘制时，默认仍会写出 PDF 并跳过该外观。需要知道是否丢失签章时，使用 ConvertWithResultAsync（自 0.2.0 起）：

var result = await new OfdToPdfConverter().ConvertWithResultAsync(input, output);
Console.WriteLine($"已绘制签章外观：{result.RenderedSignatureAppearances}");
foreach (var diagnostic in result.Diagnostics)
    Console.WriteLine($"{diagnostic.Code} 页 {diagnostic.PageIndex}: {diagnostic.Message}");

OFD 转 SVG

using Ofdrw.Net.Converter.Svg.Converters;

await using var input = File.OpenRead("input.ofd");
await using var output = File.Create("page.svg");
await new OfdToSvgConverter().ConvertAsync(input, output, pageIndex: 0);

SVG 是自包含的单页输出。多页静态预览请使用 HTML 导出，位图预览请使用图片导出。

读取 OFD 文本

安装 Ofdrw.Net.Reader 后：

using Ofdrw.Net.Reader.Extraction;
using Ofdrw.Net.Reader.Readers;

await using var input = File.OpenRead("input.ofd");
var package = await new OfdReader().ReadAsync(input);
var pages = new OfdTextExtractor().ExtractPages(package, includeTemplates: true);

foreach (var page in pages)
    Console.WriteLine(page);

文本提取按照页面模型和坐标重建行，不保证恢复原始文件的换行、空格或阅读顺序。纯文本生成 OFD 见纯文本指南。

对应的 CLI 命令

ofdrw pdf-to-ofd -i input.pdf -o output.ofd
ofdrw ofd-to-pdf -i input.ofd -o preview.pdf --pages 3,1,3
ofdrw ofd-to-svg -i input.ofd -o page.svg --pages 1
ofdrw extract-text input.ofd output.txt --include-templates

PDF、SVG、HTML 和图片出口有各自的支持边界，某一出口成功不能证明其他出口也正确。完整的拒绝、回退、取消、流写入和资源限制见转换约定与能力契约。