跳转到主要内容
此方法用于清除当前识别会话。在处理文档时,FineReader Engine 会针对当前文档类型的识别自动调整自身设置 (如亮度、文本类型、字体等) 。这些信息会在一次识别会话中使用,有助于提高识别质量。调用 CleanRecognizerSession 方法时,此类自动调整过程中获得的所有信息都会被清除。 默认情况下,FineReader Engine 会在每个页面识别完成后清除识别会话 (IEngine::AutoCleanRecognizerSession 属性为 TRUE) ,因此在大多数情况下,您无需手动调用 CleanRecognizerSession 方法。 以下情况中,您可能需要调用此方法:
  • 如果您需要在多个页面之间保留识别会话,例如使用缓存字典时。在这种情况下,应将 AutoCleanRecognizerSession 属性设为 FALSE,并在需要时通过调用 CleanRecognizerSession 方法手动清除识别会话 (例如,当您不再需要缓存字典,或即将处理与前面页面参数〈亮度、文本类型、字体等〉差异极大的页面时) 。
  • 如果您需要在识别单个页面的过程中清除识别会话,例如当页面中某些文本块的参数 (文本类型、字体等) 与其他文本块的参数存在显著差异时。
不过,如果 AutoCleanRecognizerSession 属性为 FALSE,FineReader Engine 仍会在以下情况下自动清除其识别会话: Windows 和 Linux
  • 如果页面在单个进程中按顺序识别,且没有更多页面需要处理 (例如,已调用 IFRDocument::Close 方法,或者该文档已被释放,且没有其他文档) 。
  • 如果没有更多页面需要处理 (例如,已调用 IFRDocument::Close 方法,或者该文档已被释放,且没有其他文档) 。
  • 如果页面在并行进程中识别,则会在每个并行进程结束后清除识别会话。
  • 如果页面通过 BatchProcessor 在并行进程中识别,且没有更多页面需要处理 (IBatchProcessor::GetNextProcessedPage 返回 0) 。
  • 如果调用了 Engine 对象的 LoadPredefinedProfileLoadProfile 方法。
macOS

语法

C++

HRESULT CleanRecognizerSession();

C#

void CleanRecognizerSession();

Visual Basic .NET

Sub CleanRecognizerSession()

返回值

该方法没有特定的返回值。它会返回 ABBYY FineReader Engine 函数的标准返回值

备注

调用此方法会自动清理缓存字典

另请参阅

Engine