메인 콘텐츠로 건너뛰기
이 객체를 사용하면 인식 매개변수를 조정할 수 있습니다. 레이아웃의 각 텍스트 블록과 표 셀에는 각각 RecognizerParams 형식의 자체 하위 객체가 있습니다. 또한 이 객체는 PageProcessingParams 객체의 하위 객체로 ABBYY FineReader Engine의 레이아웃 분석 및 인식 함수에 전달됩니다. 인식 함수는 텍스트 블록과 표 셀의 RecognizerParams 형식 하위 객체에 정의된 인식 매개변수를 사용합니다. 레이아웃 분석 중 텍스트 블록이나 표 셀이 생성될 때마다 해당 RecognizerParams 형식 하위 객체의 속성은 분석 함수에 전달된 RecognizedParams 객체 속성 값으로 초기화됩니다. LayoutBlocks 객체의 AddNew 메서드로 생성된 블록 하위 객체의 속성은 적절한 기본값으로 설정됩니다. 특정 속성의 기본값은 해당 설명을 참조하세요. RecognizerParams 객체는 영속 객체입니다. 즉, 객체의 현재 상태를 영구 저장소에 기록할 수 있습니다. 나중에 영구 저장소에서 객체의 상태를 읽어 객체를 다시 생성할 수 있습니다. 다음 메서드는 객체의 영속성을 제공합니다. Linux: SaveToFile, LoadFromFile Windows: SaveToFile, LoadFromFile, SaveToMemory, LoadFromMemory.

속성

,read-only

Engine 객체를 반환합니다.

인식에 사용할 언어를 지정합니다. 이 속성은메서드를 통해 간편하게 설정할 수 있습니다.

이 속성은 상수 객체를 반환합니다. 인식 언어를 변경하려면 먼저 적절한 생성 메서드를 사용하여 중간 TextLanguage 객체를 가져온 후 필요한 매개변수를 변경하고, 해당 객체를 속성에 할당해야 합니다.

기본적으로 이 매개변수는 영어로 초기화됩니다.

자동 언어 감지를 관리합니다.

언어 자동 감지가 켜져 있으면 텍스트의 각 단어에 대해 인식 언어가 자동으로 감지됩니다. 인식 언어는 TextLanguage 속성에 지정된 언어 목록에서 선택됩니다. 자동 감지는 언어를 알 수 없는 문서를 인식할 때 사용하도록 설계되었습니다.

언어 자동 감지는 사전 정의된 언어만 처리합니다(전체 목록은Predefined Languages in ABBYY FineReader Engine)참조).

지정한 모든 언어가 문서에 포함되어 있음을 확실히 알고 있다면 자동 감지는 불필요합니다. 이 속성을 TSPV_No로 설정하여 자동 감지를 비활성화하십시오.

인식된 문서 또는 페이지에서 감지된 언어 목록은또는객체의 DetectedLanguages속성을 사용하여 확인할 수 있습니다.

기본적으로 이 속성 값은 TSPV_Auto입니다.

이 속성의 값은 인식에 사용되는 텍스트 유형을 나타내는열거형 상수의 OR 조합입니다. 예를 들어 TT_Normal | TT_Index로 설정하면 ABBYY FineReader Engine은 텍스트에 일반 인쇄 텍스트와 ZIP 코드 형식의 숫자만 포함된 것으로 간주하고 다른 모든 변형을 무시합니다. 다음도 참조하십시오:Using Text Type Autodetection.

참고:

  • 이 속성이 TT_Matrix, TT_Typewriter, TT_OCR_A, TT_OCR_B의 임의 조합으로 설정된 경우, ProhibitItalic, ProhibitSubscript ProhibitSuperscript 속성 값에 관계없이 이탤릭체 글꼴과 위첨자/아래첨자는 인식되지 않습니다.
  • 이 속성이 TT_Handwritten이면 이미지 방향을 수정할 수 없습니다.
  • Windows의 경우:
    • 이 속성이 TT_Handwritten 또는 TT_Index로 설정된 경우 TrainUserPatterns 속성을 TRUE로 설정할 수 없습니다.
    • TrainUserPatterns 속성이 TRUE로 설정된 경우 TextTypes 속성에는 텍스트 유형이 하나만 포함되어야 합니다.

기본적으로 이 속성은 TT_Normal로 설정됩니다.

각 텍스트 블록에 대해 텍스트 유형을 개별적으로 결정하도록 지정합니다. 이 설정은 텍스트 유형이 서로 다른 비교적 작은 텍스트 블록이 있을 때 유용하지만, 처리 속도가 약간 느려질 수 있습니다.

이 속성의 기본값은 FALSE입니다.

대상 문서에 적용할 인식 모드를 지정합니다. 각 모드는 다양한 특성을 가진 이미지 및 문서에서 만족스러운 결과를 얻을 수 있도록 고유한 수준의 인식 속도와 정확도를 제공합니다.

기본적으로 이 속성은 RM_Normal로 설정되어 있습니다.

정확 모드에서는 항상 기본 제공 패턴이 사용됩니다. 기본 제공 패턴 사용을 비활성화하려면 일반 모드(RM_Normal)로 전환하세요.

저해상도 이미지의 텍스트 인식 여부를 지정합니다. 이 속성은 팩스, 소형 인쇄물, 저해상도 이미지 또는 인쇄 품질이 낮은 이미지를 인식할 때 유용합니다.

기본적으로 이 속성의 값은 FALSE입니다.

이 속성을 TRUE로 설정하면 ABBYY FineReader Engine은 현재 RecognizerParams 객체가 속한 블록의 텍스트가 한 줄을 넘지 않는다고 가정합니다.

기본적으로 이 속성은 FALSE입니다.

이 속성을 TRUE로 설정하면 ABBYY FineReader Engine은 각 텍스트 줄에 단어가 하나만 포함된다고 가정하며, 텍스트 줄 전체가 단일 단어로 인식됩니다.

기본적으로 이 속성은 FALSE입니다.

이 속성을 TRUE로 설정하면 ABBYY FineReader Engine이 이탤릭체로 인쇄된 문자를 인식하지 않습니다. 이탤릭체 문자가 없다고 가정되는 텍스트를 인식할 때 유용하며, 인식 속도가 향상될 수 있습니다. 이미지에 이탤릭체 문자가 존재하는 상태에서 이 속성이 TRUE이면 해당 문자가 잘못 인식됩니다.

기본적으로 이 속성은 FALSE입니다.

이 속성을 TRUE로 설정하면 ABBYY FineReader Engine이 아래 첨자 문자를 인식하지 않습니다. 아래 첨자가 없다고 가정되는 텍스트를 인식할 때 유용하며, 인식 속도가 향상될 수 있습니다. 이미지에 아래 첨자 문자가 존재하는 상태에서 이 속성이 TRUE이면 해당 문자가 잘못 인식됩니다.

기본적으로 이 속성은 FALSE입니다.

이 속성을 TRUE로 설정하면 ABBYY FineReader Engine이 위 첨자 문자를 인식하지 않습니다. 위 첨자가 없다고 가정되는 텍스트를 인식할 때 유용하며, 인식 속도가 향상될 수 있습니다. 이미지에 위 첨자 문자가 존재하는 상태에서 이 속성이 TRUE이면 해당 문자가 잘못 인식됩니다.

기본적으로 이 속성은 FALSE입니다.

이 속성을 TRUE로 설정하면 줄 간 하이픈 연결 인식이 비활성화됩니다. 하이픈 연결이 없다고 가정되는 텍스트를 인식할 때 유용하며, 인식 속도가 향상될 수 있습니다. 인식된 블록에 하이픈 연결이 존재하는 상태에서 이 속성이 TRUE이면 하이픈으로 연결된 단어가 잘못 인식됩니다.

기본적으로 이 속성은 FALSE입니다.

이 속성을 TRUE로 설정하면 ABBYY FineReader Engine이 작은 대문자를 인식하지 않습니다.

기본적으로 이 속성은 FALSE입니다.

이 속성을 TRUE로 설정하면 ABBYY FineReader Engine은 한 블록의 텍스트가 다음 블록으로 넘어가지 않는다고 가정합니다.

기본적으로 이 속성은 FALSE입니다.

이 속성은 대소문자 인식 모드를 지정합니다.

기본적으로 이 속성의 값은 CRM_AutoCase이며, 자동 대소문자 인식에 해당합니다.

이 속성은 문자 주변의 표식 유형을 지정합니다(예: 밑줄, 프레임, 박스 등).

각 문자가 별도의 셀에 위치하는 표식 유형의 경우, CellsCount 속성을 사용하여 인식된 블록의 문자 셀 수를 설정하세요.

기본적으로 이 속성의 값은 FMT_SimpleText이며, 표식 없음을 의미합니다.

블록 내 문자 셀의 수를 지정합니다.

이 속성은 모든 문자가 별도의 셀에 작성되는 field 표식 유형( FieldMarkingType 속성)에만 의미가 있습니다.

이 속성의 기본값은 1이지만, 텍스트를 올바르게 인식하려면 적절한 값으로 설정해야 합니다.

Windows 전용.

이 속성은 인식 중에 사용자 패턴을 학습할지 여부를 지정합니다. 인식 중에Pattern Training대화 상자가 표시됩니다.

패턴 학습 프로세스가 올바르게 작동하려면 다음을 수행해야 합니다:

  • 부모 창 HWND 핸들 값 설정 (속성)
  • UserPatternsFile 속성에 사용자 패턴 파일 지정

다음도 참조하세요:Recognizing with Training.

이 속성이 TRUE로 설정된 경우:

  • the TextTypes 속성에는 텍스트 유형이 하나만 포함되어야 하며, 해당 텍스트 유형은 TT_Handwritten 또는 TT_Index일 수 없습니다.
  • thePagePreprocessingParams 객체의 속성을 TRUE로 설정할 수 없습니다.
패턴 학습은 중국어, 일본어, 한국어를 지원하지 않습니다.

기본적으로 이 속성은 FALSE입니다.

이 속성을 TRUE로 설정하면 ABBYY FineReader Engine이 인식 시 자체 내장 패턴을 사용합니다. 패턴은 문자 이미지와 문자 자체 간의 관계를 정의하는 파일입니다. 문자 인식에 표준 ABBYY FineReader Engine 패턴 대신 사용자 패턴만 사용하려는 경우 이 속성을 FALSE로 설정할 수 있습니다. 이는 장식체 또는 비표준 폰트로 작성된 텍스트를 인식할 때 유용합니다. 이 경우 ABBYY FineReader Engine 내장 패턴 대신 해당 폰트에 맞게 학습된 사용자 정의 패턴을 사용하는 것이 좋습니다.

사용자 정의 패턴 파일의 경로는 UserPatternsFile 속성에 저장됩니다. UserPatternsFile 속성이 비어 있으면 UseBuiltInPatterns 속성은 무시됩니다. Windows의 경우 다음도 참조하세요:Recognizing with Training.

기본적으로 이 속성은 TRUE입니다.

일반 및 빠른 인식 모드에서는 이 속성을 FALSE로 설정할 수 있습니다. 정확도 우선 모드에서는 내장 패턴 사용을 비활성화할 수 없습니다(Mode속성 설명 참조).

인식에 사용되는 user pattern 파일의 전체 경로를 포함합니다. 이 속성의 값이 비어 있지 않으면 인식 중에 user pattern 파일의 정보가 사용됩니다.

UseBuiltInPatterns 속성이 FALSE인 경우, 즉 인식 중에 표준 ABBYY FineReader Engine 패턴이 사용되지 않는 경우, 이 속성에는 사용자 정의 pattern 파일의 경로를 지정해야 합니다. 해당 파일에 저장된 정보만 사용되기 때문입니다. Windows의 경우 다음도 참조하십시오.Recognizing with Training.

기본적으로 이 속성은 빈 string을 저장합니다.

ABBYY FineReader Engine 10 이하에서 생성된 user pattern 파일은 FineReader Engine 12 Release 6 이상에서 열 수 없습니다. 계속 사용하려면 이전 user pattern 파일을 새 형식으로 저장하십시오:
  • FineReader Engine 11 또는 FineReader Engine 12 Release 5 이하를 사용하십시오.
  • 객체의메서드를 호출하여, 이전 pattern 파일의 이름과 새 파일의 전체 경로를 담은 string 컬렉션을 전달하십시오.

불확실하게 인식된 문자의 IsSuspicious 속성을 TRUE로 설정할지 여부를 지정합니다.

이 속성의 이름은 ABBYY FineReader가 텍스트에서 의심스러운 문자를 배경 컬러로 강조 표시하여 운영자가 수동으로 검증하기 쉽도록 한다는 사실을 반영합니다.

기본적으로 이 속성은 TRUE입니다.

이 속성은 더 이상 사용되지 않으며 향후 버전에서 삭제될 예정입니다.

정확한 문자 영역()을 저장할지 여부를 지정합니다.

기본값은 FALSE입니다.

문자 인식 후보를 저장할지 여부를 지정합니다.

ICharParams::CharacterRecognitionVariants속성은 문자에 대한 인식 후보 컬렉션을 반환합니다. 다음도 참조하십시오.Using Voting API.

기본값은 FALSE입니다.

단어의 인식 후보를 저장할지 여부를 지정합니다.

IParagraph::GetWordRecognitionVariants메서드와ICharParams::WordRecognitionVariants속성은 단어에 대한 인식 후보 컬렉션을 반환합니다. 다음도 참조하십시오.Using Voting API.

기본값은 FALSE입니다.

메서드

이름설명
CopyFrom다른 객체의 해당 속성 값을 사용하여 현재 객체의 속성을 초기화합니다.
LoadFromFile디스크의 파일에서 객체 내용을 복원합니다.
LoadFromMemory <Note> Windows 전용입니다. </Note>전역 메모리에서 객체 내용을 복원합니다.
SaveToFile객체 내용을 디스크의 파일에 저장합니다.
SaveToMemory <Note> Windows 전용입니다. </Note>객체 내용을 전역 메모리에 저장합니다.
SetPredefinedTextLanguage인식 언어를 미리 정의된 ABBYY FineReader Engine 언어 중 하나로 설정합니다.
RecognizerParams 객체 다이어그램

출력 매개변수

이 객체는 엔진 객체의 CreateRecognizerParams 메서드의 출력 매개변수입니다.

입력 매개변수

이 객체는 다음 메서드에 입력 매개변수로 전달됩니다.

샘플

FREngine.IEngine engine;
string fileName;
// 인식 중 사용자 패턴 학습
FREngine.IDocumentProcessingParams processingParams = Engine.CreateDocumentProcessingParams();
FREngine.IRecognizerParams recognizerParams = processingParams.PageProcessingParams.RecognizerParams;
Engine.CreateEmptyUserPattern( fileName );
Engine.MultiProcessingParams.MultiProcessingMode = FREngine.MultiProcessingModeEnum.MPM_Sequential;
recognizerParams.UserPatternsFile = fileName;
recognizerParams.TrainUserPatterns = true;
Document.Process(processingParams);
이 객체는 다음 코드 샘플에서 사용됩니다.

참고 항목

전처리, 분석, 인식 및 합성 매개변수 조정 손글씨 텍스트 인식 PageProcessingParams TextBlock 속성 사용하기