Chinese Simplified (简体中文)

English (English)

扫描

Note: Some parts of this article may be in English. We apologize for the inconvenience and are working on adding the translation as soon as possible.

在该场景中，ABBYY FineReader Engine 用在“扫描计算机”上，计算机扫描图像并将其保存为文件。

该场景可以在文档处理的初级阶段（即为了获取文档的电子版本进行进一步处理）用作其它场景的一部分。用例包括为了存档目的扫描文档、获取文档的可编辑版本以及从文档提取有具体数据。

扫描纸质文档并将图像保存为电子格式，从而生成打印文档的高质量电子版本。

文档需经过以下处理阶段：

扫描

文档可以通过扫描仪提供的两个扫描接口之一（TWAIN 或 WIA），可以使用 ABBYY 自己的扫描接口，也可以不用扫描接口进行扫描。

预处理扫描图像

扫描后，图像就可以进行预处理。预处理包括去斑、纠正变形的文本行、色彩翻转、去除黑色边缘以及纠正图像方向或分辨率。跨页可以拆分成两个单独页面。处理后的页面可以保存为 JPEG、TIFF、BMP 等各种图像格式。

场景实现

下面内容详细说明了在该场景中使用 ABBYY FineReader Engine 12 的建议方法。在建议的场景实施中省略了图像准备阶段。请参阅以下的其他优化了解实施图像准备的提示。

第1步加载 ABBYY FineReader Engine

要开始使用 ABBYY FineReader Engine，您需要创建 Engine 对象。Engine 对象是 ABBYY FineReader Engine 对象层次体系中的顶级对象，提供各种全局设置、一些处理方法和用于创建其它对象的方法。

要创建 Engine 对象，您可以使用 InitializeEngine 导出的函数。另请加载 Engine 对象的不同方式。

C#

public class EngineLoader : IDisposable
{
    public EngineLoader()
    {
        // 用 FREngine.dll 的完整路径、客户项目 ID，
        // 以及（如适用）您的在线许可证令牌文件路径和在线许可证密码初始化这些变量
        string enginePath = "";
        string customerProjectId = "";
        string licensePath = "";
        string licensePassword = "";
        // 加载 FREngine.dll 库
        dllHandle = LoadLibraryEx(enginePath, IntPtr.Zero, LOAD_WITH_ALTERED_SEARCH_PATH);
           
        try
        {
            if (dllHandle == IntPtr.Zero)
            {
                throw new Exception("无法加载" + enginePath);
            }
            IntPtr initializeEnginePtr = GetProcAddress(dllHandle, "InitializeEngine");
            if (initializeEnginePtr == IntPtr.Zero)
            {
                throw new  Exception("无法找到 InitializeEngine 函数");
            }
            IntPtr deinitializeEnginePtr = GetProcAddress(dllHandle, "DeinitializeEngine");
            if (deinitializeEnginePtr == IntPtr.Zero)
            {
                throw new Exception("无法找到 DeinitializeEngine 函数");
            }
            IntPtr dllCanUnloadNowPtr = GetProcAddress(dllHandle, "DllCanUnloadNow");
            if (dllCanUnloadNowPtr == IntPtr.Zero)
            {
                throw new Exception("无法找到 DllCanUnloadNow 函数");
            }
            // 转换指针为代理
            initializeEngine = (InitializeEngine)Marshal.GetDelegateForFunctionPointer(
                initializeEnginePtr, typeof(InitializeEngine));
            deinitializeEngine = (DeinitializeEngine)Marshal.GetDelegateForFunctionPointer(
                deinitializeEnginePtr, typeof(DeinitializeEngine));
            dllCanUnloadNow = (DllCanUnloadNow)Marshal.GetDelegateForFunctionPointer(
                dllCanUnloadNowPtr, typeof(DllCanUnloadNow));
            // 调用 InitializeEngine 函数
            // 传递路径到在线许可证文件路径和在线许可证密码
            int hresult = initializeEngine(customerProjectId, licensePath, licensePassword, 
                "", "", false, ref engine);
            Marshal.ThrowExceptionForHR(hresult);
        }
        catch (Exception)
        {
            // 释放 FREngine.dll 库
            engine = null;
            // FreeLibrary 调用前删除所有对象
            GC.Collect();
            GC.WaitForPendingFinalizers();
            GC.Collect();
            FreeLibrary(dllHandle);
            dllHandle = IntPtr.Zero;
            initializeEngine = null;
            deinitializeEngine = null;
            dllCanUnloadNow = null;
            throw;
        }
    }
    // Kernel32.dll 函数
    [DllImport("kernel32.dll")]
    private static extern IntPtr LoadLibraryEx(string dllToLoad, IntPtr reserved, uint flags);
    private const uint LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008;
    [DllImport("kernel32.dll")]
    private static extern IntPtr GetProcAddress(IntPtr hModule, string procedureName);
    [DllImport("kernel32.dll")]
    private static extern bool FreeLibrary(IntPtr hModule);
    // FREngine.dll 函数 
    [UnmanagedFunctionPointer(CallingConvention.StdCall, CharSet = CharSet.Unicode)]
    private delegate int InitializeEngine(string customerProjectId, string licensePath, 
        string licensePassword, string tempFolder, string dataFolder, bool isSharedCPUCoresMode, 
        ref FREngine.IEngine engine);
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DeinitializeEngine();
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DllCanUnloadNow();
    // 私有变量
    private FREngine.IEngine engine = null;
    // FREngine.dll 句柄 
    private IntPtr dllHandle = IntPtr.Zero;
    private InitializeEngine initializeEngine = null;
    private DeinitializeEngine deinitializeEngine = null;
    private DllCanUnloadNow dllCanUnloadNow = null;
}

第2步扫描

ABBYY FineReader Engine 提供 ScanManager 对象用来管理扫描来源。该对象的 ScanSources 属性可提供对所有可用扫描仪列表的访问，而 FindScanSources 方法可让您按它们提供的 API 类型和您希望用来设置扫描选项的用户界面类型来选择扫描仪。

若要扫描并将文件保存到磁盘，您可以使用 ScanSource 对象的两个方法中的一个：Scan 方法，直到扫描完成才会返回；BeginScan 方法，会启动异步扫描操作并立刻返回。

您可以实施 IScanCallback 接口并用它来获取扫描进度通知。

以下参数可以通过 ABBYY FineReader Engine 12 API 进行访问：亮度、色彩、分辨率、图像压缩类型、图像旋转角度、扫描区域大小、双面打印模式、自动进料模式、页面之间暂停等等。扫描参数通过使用 ScanSource 对象的 ScanSettings 属性进行设置。该属性需要用来访问 ScanSourceSettings 对象，而后者又提供对来源扫描设置的访问。

如需同步扫描图像：

创建一个 ScanManager 对象。您可以指定扫描日志是否将由 CreateScanManager 方法的输入参数写入。
使用 ScanManager 对象的 FindScanSources 方法选择扫描来源，指定扫描仪应该支持的 API 和 UI 类型。
如果您选择不显示让用户亲自设置扫描选项的对话框，使用所选 ScanSource 的 ScanSettings 属性来调节扫描选项。在 ScanSourceSettings 对象的相应属性中选择适当的亮度值、分辨率和其它参数。您可以使用 ScanSource 的 Capabilities 属性来检查哪些设置可供该扫描仪使用。
指定要在其中存储扫描页面的文件夹名称。文件夹名称应该是一个 BSTR 变量，例如 ScanFolder。
运行 ScanSource 对象的 Scan 方法，将向用户显示的对话框类型（传递 SSUIT_None c常数以不显示对话框）和 ScanFolder 文件夹路径与结果一起提供为参数。
图像文件名称将被该方法作为 StringsCollection 对象返回。您可以从该 StringsCollection 对象获取图像文件名称，然后将文件作为平常的图像文件来处理。

如需异步扫描图像：

创建一个实施 IScanCallback 界面的对象。如果进行异步扫描操作，来自回调界面的通知非常有用。
创建一个 ScanManager 对象。您可以指定扫描日志是否将由 CreateScanManager 方法的输入参数写入。
使用 ScanManager 对象的 FindScanSources 方法选择扫描来源，指定扫描仪应该支持的 API 和 UI 类型。
如果您选择不显示让用户亲自设置扫描选项的对话框，使用所选 ScanSource 的 ScanSettings 属性来调节扫描选项。在 ScanSourceSettings 对象的相应属性中选择适当的亮度值、分辨率和其它参数。您可以使用 ScanSource 的 Capabilities 属性来检查哪些设置可供该扫描仪使用。
指定要在其中存储扫描页面的文件夹名称。文件夹名称应该是一个 BSTR 变量，例如 ScanFolder。
运行 BeginScan 对象的 ScanSource 方法，将向用户显示的对话框类型（传递 SSUIT_None 常数以不显示对话框）和文件夹路径 ScanFolder 与结果一起作为参数提供。您也需要传递自己创建的回调对象的指针。
图像文件路径用 IScanCallback 对象的 OnImageScanned 通知返回，操作完成由 OnScanComplete 通知发出信号。在提供这些方法的实施时，您可以选择在每种情况下做什么。例如，收到图像文件路径时，您可以像处理磁盘的任何其它文件一样处理它，加载它以用 FineReader Engine 按通常方式进行处理。

重要事项！在扫描完成和收到 OnScanComplete 通知前，不能再次运行 BeginScan 或 Scan，即使对于其它一些扫描仪也如此。异步扫描的优点不是可以同时执行多个扫描操作，而是可以在扫描新图像时处理已经收到的图像。

以下是异步扫描方案的示例代码：

C#

// 实施 IScanCallback 界面
class ScanningCallback :FREngine.IScanCallback
{
  // 构造函数
  public ScanningCallback() {}
  ...
  // 提供 IScanCallback 方法的实施
  public void OnError(string sourceName, string message) { // 在此报告或者处理错误 }
  public void OnImageScanned(string sourceName, string Path, ref bool cancel) { // 在此插入扫描图像时需要采取的任何操作 }
  public void OnScanComplete() { // 在此插入您希望扫描完成后执行的操作 }
  // 私有变量
  ...
}
// 创建扫描管理器，关闭日志
scanManager = engineLoader.Engine.CreateScanManager(false);
// 创建一个被 API 过滤过的扫描来源和 UI 类型列表
FREngine.IScanSources sources = scanManager.FindScanSources(UIType, APIType);
// 仅为举例，从集合选择第一个扫描来源
FREngine.IScanSource selectedSource = sources[0];
// 访问扫描来源设置和能力
FREngine.IScanSourceSettings settings = selectedSource.ScanSettings;
FREngine.IScanSourceCapabilities capabilities = selectedSource.Capabilities;
// 如果扫描仪有双面打印模式的话将扫描选项设为双面打印
settings.DuplexMode = capabilities.HasDuplexMode;
// 将选项设为多页扫描和页面之间延迟10秒
settings.MultipleImagesEnabled = true;
settings.PauseBetweenPagesMode = FREngine.ScanPauseModeEnum.SPM_PresetDelay;
settings.Delay = 10;
// 用结果设置文件夹路径
string scanFolder = "D:\\SampleImages";
// 创建回调对象
IScanningCallback callback = new ScanningCallback();
// 开始扫描
selectedSource.BeginScan(SSUIT_None, scanFolder, callback);

第3步卸载 ABBYY FineReader Engine

使用 ABBYY FineReader Engine 完成工作后，您需要卸载 Engine 对象。为此，请使用 DeinitializeEngine 导出功能。

C#

public class EngineLoader : IDisposable
{
    // 卸载 FineReader Engine
    public void Dispose()
    {
        if (engine == null)
        {
            // Engine 未加载 
            return;
        }
        engine = null;
        int hresult = deinitializeEngine();
        // 在 FreeLibrary 调用前删除所有对象
        GC.Collect();
        GC.WaitForPendingFinalizers();
        GC.Collect();
        int hresult = deinitializeEngine();

        hresult = dllCanUnloadNow();
        if (hresult == 0)
        {
            FreeLibrary(dllHandle);
        }
        dllHandle = IntPtr.Zero;
        initializeEngine = null;
        deinitializeEngine = null;
        dllCanUnloadNow = null;
        // 清理后引发异常
        Marshal.ThrowExceptionForHR(hresult);
    }
    // Kernel32.dll 函数
    [DllImport("kernel32.dll")]
    private static extern IntPtr LoadLibraryEx(string dllToLoad, IntPtr reserved, uint flags);
    private const uint LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008;
    [DllImport("kernel32.dll")]
    private static extern IntPtr GetProcAddress(IntPtr hModule, string procedureName);
    [DllImport("kernel32.dll")]
    private static extern bool FreeLibrary(IntPtr hModule);
    // FREngine.dll 函数
    [UnmanagedFunctionPointer(CallingConvention.StdCall, CharSet = CharSet.Unicode)]
    private delegate int InitializeEngine( string customerProjectId, string LicensePath, string LicensePassword, , , , ref FREngine.IEngine engine);
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DeinitializeEngine();
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DllCanUnloadNow();
    // 私有变量
    private FREngine.IEngine engine = null;
    // FREngine.dll 句柄
    private IntPtr dllHandle = IntPtr.Zero;
    private InitializeEngine initializeEngine = null;
    private DeinitializeEngine deinitializeEngine = null;
    private DllCanUnloadNow dllCanUnloadNow = null;
}

所需资源

您可以使用 FREngineDistribution.csv 文件来自动创建应用程序正常工作所需的文件列表。若要用该方案进行处理，请在栏5 (RequiredByModule) 中对以下值进行选择：

Core

Core.Resources

Opening

Opening, Processing

Opening.Scanning

如果修改标准场景，请相应更改所需的模块。您还需要指定界面语言、识别语言和应用程序使用的任何其他功能（例如，如果需要识别 CJK 语言的文本，则指定 Processing.OCR.CJK）。请参见借助 FREngineDistribution.csv 文件处理进一步了解详情。

其他优化

以下是指南文件中的相关章节，您可以在其中找到不同处理步骤参数设置的更多信息：

文档拆分

In this scenario, you may need to group the incoming flow of images into documents. For example, you may know the number of pages in each document, or ensure there are separator pages with barcodes that come between the last page of the first document and the first page of the next document. Consult the 条形码识别场景。

另请参阅

基本使用场景实现

07.11.2025 12:48:30

Your use of this site is conditioned on Your continued compliance with the Terms of Use.

Terms of Use

Disclaimer of Warranty

Limitation of Liability

Transmission and Submission of Information

Downloads

Use of Content

Trademarks

Links to Third-Party Sites

Foreign Legislation

Subscription Terms

Partner Subscription Terms

扫描