C# 工程图纸数字化入库实战：Aspose.Imaging 自动抠图、多页 TIFF 合卷与坏页容错

工程图纸数字化入库，本质是把扫描散页处理成「可归档、可调阅、可分发」的标准档案。本文用一个完整可运行实例，演示如何用 Aspose.Imaging for .NET（一个支持图像遮罩、多页合成、格式转换与数据恢复的 .NET 图像处理库）解决其中的四类典型问题：扫描杂边自动去除、散页合卷、一图多格式输出、坏页容错不中断。示例代码基于官方 API 编写，类名与命名空间均按真实库还原。

一、要解决的四类问题

扫描杂边：装订孔、胶带痕迹、空白边距，几万页手动裁不现实；
散页管不住：一案卷几百个文件，迁移丢几页无人知晓；
一套图纸多种交付：归档 TIFF、业务 PDF、门户 WebP、设计 PSD；
老档案有坏页：数据区损坏一打开就抛异常，整批任务卡死。

注：此处「设计 PSD」指将图纸导出为可导入 Photoshop 继续编辑的扁平化（光栅）PSD；图层级 PSD 编辑属于 Aspose.PSD 的能力范畴。

二、环境准备

通过 NuGet 安装库，再在程序启动时应用授权（不授权也能跑，但导出图会带评估水印）：

csharp 复制代码

// 通过 NuGet 安装（Package Manager Console）
// PM> Install-Package Aspose.Imaging
// 或 .NET CLI：dotnet add package Aspose.Imaging

using Aspose.Imaging;

// 授权未应用或过晚，输出会带评估水印
License lic = new License();
lic.SetLicense("Aspose.Imaging.lic");

下面分四步演示核心实现：抠、合、转、救。

三、核心实现：四步------抠、合、转、救

1. 抠：GraphCut 自动遮罩去杂边

扫描件的装订孔、胶带痕迹可用 GraphCut 自动遮罩分离前景（图纸内容）与背景（杂边），输出透明背景的干净图。前景分离属于计算机视觉任务，Aspose.Imaging 直接内置了 GraphCut 自动遮罩，无需额外引入 OpenCV 等库。

csharp 复制代码

using System;
using Aspose.Imaging;
using Aspose.Imaging.Masking;
using Aspose.Imaging.Masking.Options;
using Aspose.Imaging.ImageOptions;
using Aspose.Imaging.FileFormats.Png;

// 自动抠图：GraphCut 分离图纸内容与扫描杂边
using (RasterImage image = (RasterImage)Image.Load("扫描页.jpg"))
{
    var options = new AutoMaskingGraphCutOptions
    {
        CalculateDefaultStrokes = true,                // 自动计算笔划，无需手动标注
        FeatheringRadius = 2,                           // 边缘羽化半径
        Method = SegmentationMethod.GraphCut,
        BackgroundReplacementColor = Color.Transparent  // 背景替换为透明
    };

    // Decompose 返回数组：results[0] 为原图，results[1] 为前景分离后的结果
    MaskingResult[] results = new ImageMasking(image).Decompose(options);
    using (RasterImage resultImage = (RasterImage)results[1].GetImage())
    {
        resultImage.Save("抠图结果.png", new PngOptions
        {
            ColorType = PngColorType.TruecolorWithAlpha  // 保留透明背景
        });
    }
}

|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------|
| 原始图像 | 手动遮罩 | 自动遮罩 |

遮罩效果取决于扫描件对比度，投产前建议用真实样张实测。

2. 合：散页合成多页 TIFF

把清洗后的散页合成一个多页 TIFF------一个案卷一个文件，丢页从「悄无声息少一个文件」变成「文件内页数不对，一眼可查」。合成靠 AddFrame，压缩靠 TiffOptions。Aspose 官方 TIFF 压缩教程即采用 4 位灰度 + LZW（通过调色板/灰度获得更轻的占用空间）。

csharp 复制代码

using Aspose.Imaging;
using Aspose.Imaging.FileFormats.Tiff;
using Aspose.Imaging.FileFormats.Tiff.Enums;
using Aspose.Imaging.ImageOptions;

// 首页建卷，后续逐页 AddFrame，压缩方案按扫描件类型选
using (TiffImage archive = new TiffImage(new TiffFrame((RasterImage)Image.Load("首页.jpg"))))
{
    archive.AddFrame(new TiffFrame((RasterImage)Image.Load("第二页.jpg")));  // 逐页加帧

    var tiffOptions = new TiffOptions(TiffExpectedFormat.Default);
    tiffOptions.Compression = TiffCompressions.CcittFax4;   // 黑白件用 Fax4
    tiffOptions.BitsPerSample = new ushort[1];
    tiffOptions.BitsPerSample[0] = 1;
    tiffOptions.Photometric = TiffPhotometrics.MinIsWhite;  // 黑白图须设光度解释，避免部分查看器不渲染

    archive.Save("案卷.tiff", tiffOptions);
}

扫描件类型	推荐方案	说明
文字、印章、线条图	CCITT Fax4（1 位黑白）	无损，体积更小
工程图纸、灰度照片	4 位灰度 + LZW	无损，Aspose 官方压缩教程采用此配置
需保留完整色彩	LZW RGB	无损，体积较大
仅供预览副本	JPEG RGB	有损，不建议原始归档

3. 转：一份图纸出多种格式

同一份图纸输出 TIFF 归档、PDF 查阅、WebP 门户加速、PNG 缩略预览，只需换 Options，无需为每种格式分别引入图像库。

csharp 复制代码

using Aspose.Imaging;
using Aspose.Imaging.ImageOptions;

// 同一份图纸，换 Options 即可输出多种格式
using (var img = Image.Load("案卷.tiff"))
{
    // ① 归档：Fax4 仅支持 1 位黑白。按官方文档，彩色/灰度图保存时会自动转为黑白
    //    （此为该选项组合的预期行为，不会抛异常）；这里先在独立副本上做 Otsu 二值化，
    //    是为了获得比默认转换更好的黑白阈值效果，同时不影响后续彩色输出。
    using (var archiveImg = (RasterImage)img.Clone())
    {
        if (archiveImg.BitsPerPixel > 1)
            archiveImg.BinarizeOtsu();

        archiveImg.Save("归档.tiff", new TiffOptions(TiffExpectedFormat.TiffCcittFax4));
    }

    var pdfOpts = new PdfOptions { FullFrame = true };
    img.Save("业务.pdf", pdfOpts);
    img.Save("门户.webp", new WebPOptions());
    img.Save("缩略图.png", new PngOptions());
}

4. 救：坏页不中断整批

TIFF 以条带（strip）为单位存储，一个条带损坏时其余仍可能完好。启用恢复后坏块被替换成指定颜色，不再抛异常------对老档案项目是常见需求。

csharp 复制代码

using Aspose.Imaging;

var loadOptions = new LoadOptions();
loadOptions.DataRecoveryMode = DataRecoveryMode.ConsistentRecover;  // 批量场景建议显式开启（默认 None）
loadOptions.DataBackgroundColor = Color.Red;                        // 坏块标记色

using (Image image = Image.Load("受损案卷.tiff", loadOptions))
{
    // 正常处理，不会因坏块抛异常
}

四、完整示例：批量合卷 + 多格式分发 + 坏页容错

下面把「合、转、救」串成一个可直接运行的方法：扫描某个案卷目录下的 .jpg，按文件名排序合卷为多页 TIFF（Fax4 压缩），再同一份图输出 PDF 与 WebP，载入时开启坏页容错。复制后把路径换成自己的即可跑。

csharp 复制代码

using System;
using System.IO;
using System.Linq;
using Aspose.Imaging;
using Aspose.Imaging.FileFormats.Tiff;
using Aspose.Imaging.FileFormats.Tiff.Enums;
using Aspose.Imaging.ImageOptions;

// 将某个案卷目录下的扫描散页，处理为：多页归档 TIFF + 业务 PDF + 门户 WebP
static void BuildArchive(string caseDir, string outDir)
{
    var scans = Directory.EnumerateFiles(caseDir, "*.jpg")
                          .OrderBy(f => f, StringComparer.OrdinalIgnoreCase)
                          .ToList();
    if (scans.Count == 0) return;

    // 1) 合卷：首页建卷，后续逐页 AddFrame
    using (var archive = new TiffImage(new TiffFrame((RasterImage)Image.Load(scans[0]))))
    {
        for (int i = 1; i < scans.Count; i++)
            archive.AddFrame(new TiffFrame((RasterImage)Image.Load(scans[i])));

        var tiffOptions = new TiffOptions(TiffExpectedFormat.Default)
        {
            Compression = TiffCompressions.CcittFax4,
            BitsPerSample = new ushort[] { 1 },
            Photometric = TiffPhotometrics.MinIsWhite
        };
        archive.Save(Path.Combine(outDir, "案卷.tiff"), tiffOptions);
    }

    // 2) 转 + 救：载入时开启坏页容错，同一份图纸输出多种交付格式
    var loadOptions = new LoadOptions
    {
        DataRecoveryMode = DataRecoveryMode.ConsistentRecover,
        DataBackgroundColor = Color.Red
    };
    using (var img = Image.Load(Path.Combine(outDir, "案卷.tiff"), loadOptions))
    {
        img.Save(Path.Combine(outDir, "业务.pdf"), new PdfOptions { FullFrame = true });
        img.Save(Path.Combine(outDir, "门户.webp"), new WebPOptions());
    }
}

流水线串起来即：扫描散页 → 自动抠图 → 合卷归档 → 多格式分发 → 坏页容错。抠图（第一步）通常按单页预处理，合卷与分发（第二、三步）按案卷批量执行，坏页容错（第四步）贯穿载入环节。

横向对比：Aspose.Imaging 与开源方案

把"工程图纸数字化入库"拆成四件事（抠、合、转、救），看 Aspose.Imaging 与两个常见的 .NET 开源/自由库的能力差异。以下对比仅针对文档数字化这一场景，不评价通用图像编辑能力。

能力（本场景）	Aspose.Imaging	ImageMagick（Magick.NET）	LibTiff.Net
自动前景分离（抠图）	内置 GraphCut（`AutoMaskingGraphCutOptions`）	无内置；需自写阈值/边缘或外接 OpenCV 等 CV 库	不涉及（仅 TIFF 读写）
多页 TIFF 合卷	`TiffImage.AddFrame`	`MagickImageCollection` 多页 TIFF	支持多帧 TIFF 读写（较底层 API）
格式转换与压缩	内置 TIFF / PDF / WebP / PNG / PSD 等多种 `ImageOptions`	支持大量格式与压缩（含 Fax4 / LZW / WebP）	仅 TIFF，不能转其他格式
条带级坏页恢复	`DataRecoveryMode.ConsistentRecover` / `MaximalRecover`	无对应机制	无对应机制
授权	商业库，需授权（可申请临时评估授权）	自由开源（ImageMagick 许可）	自由开源（New BSD）
跨平台	Windows / Linux / macOS（.NET Standard 2.0）	Windows / Linux / macOS	纯托管代码、无外部依赖，但项目多年未更新、官方仅提供有限支持

几点如实说明（均来自各库官方/公开资料）：

抠图差异是核心：Aspose.Imaging 把 GraphCut 遮罩作为内置能力；ImageMagick 官方能力列表包含色彩阈值、边缘检测、连通组件标注等传统算法，但没有"自动前景/背景分离"，要抠图需自行基于阈值/边缘或外接 OpenCV；LibTiff.Net 专注 TIFF 读写，不含任何图像处理。
合卷与转格式，开源方案普遍够用：若只是把扫描散页合卷成多页 TIFF 再分发 PDF / WebP，ImageMagick 与 LibTiff.Net 都能完成且免费；区别主要在 API 风格与是否需额外编解码器包（ImageMagick 读部分格式需显式注册）。
坏页恢复：在对比的三个库中，只有 Aspose.Imaging 提供现成的条带级恢复 API ：ConsistentRecover / MaximalRecover 在 ImageMagick 与 LibTiff.Net 中没有对应机制；若用开源库实现类似能力，需自行基于 TIFF 条带结构解析。
选型建议（供判断，非推荐）：纯合卷 / 转格式、预算敏感 → 优先开源；需要一站式"自动抠图 + 多格式分发 + 坏页恢复"且愿付授权费 → Aspose.Imaging 把这些都内置，省去组合多个库。

注：上表为场景化能力对比，非性能或质量排名。具体行为以各库当前版本文档与自有样张实测为准。

五、FAQ 常见问题

Q1：自动遮罩是什么？适合什么场景？

AutoMaskingGraphCutOptions 使用 GraphCut 算法自动分离图像前景与背景，无需手动标注 ROI。在图纸数字化中可用于去除扫描件装订孔、胶带痕迹等杂边。效果取决于扫描件对比度，建议投产前用真实样张实测。

Q2：多页 TIFF 归档为什么用一个文件而不是散页？

一个案卷一个文件，丢页从「悄无声息少一个文件」变成「文件内页数不对，一眼可查」。Aspose 官方多页 TIFF 教程指出，把多张图像合成一个多页 TIFF「特别适合文档归档、减少需管理的文件数量」，并举例「将扫描文档存为单一多页 TIFF 以便保存」。归档体积可结合上方压缩方案选型进一步减小。

Q3：压缩方案怎么选？

文字、印章、线条图用 CCITT Fax4（1 位黑白），体积更小；工程图纸、灰度照片用 4 位灰度 + LZW（Aspose 官方 TIFF 压缩教程采用此配置）；需保留完整色彩用 LZW RGB。压缩比取决于原始扫描件质量，请用自有样张实测。

Q4：老档案有坏页怎么办？

TIFF 以条带为单位存储，一个条带损坏时其余仍可能完好。启用 DataRecoveryMode.ConsistentRecover 后坏块被替换成指定颜色，不再抛异常。批量场景建议显式设置 ConsistentRecover（其默认值是 None，不设置坏页仍会抛异常）；MaximalRecover 仅用于抢救性读取，结果可能不可预期。

Q5：支持哪些部署环境？

官方系统要求标明兼容 Windows、Linux 与 macOS（基于 .NET Standard 2.0 跨平台），可放进容器化归档服务。具体 .NET 版本支持请对照目标版本文档。Aspose.Imaging 为商业库，生产环境需授权，评估阶段可申请免费临时授权。

提示：压缩比与处理性能取决于原始扫描件质量与运行环境，建议用自有样张实测；TIFF 坏页恢复为尽力修复，关键档案请保留原件。文中「GraphCut 自动前景分离」「4 位灰度 + LZW 为 Aspose 官方 TIFF 压缩教程所采用的配置」「TIFF 按条带存储故坏一条其他仍可读」均出自 Aspose 官方文档，API 行为与版本特性以官方最新文档为准。