FRPage 객체 (IFRPage 인터페이스)

속성
메서드
관련 객체
출력 매개변수
입력 매개변수
관련 Visual Components
샘플
참고 항목

이 객체는 페이지에 해당합니다.

Linux 및 Windows에서 이는 문서의 페이지이거나 배치 프로세서에서 생성된 페이지일 수 있습니다.

이 객체는 페이지 전처리, 분석, 인식, 페이지 합성 및 내보내기를 위한 메서드 집합을 제공합니다. 이 객체의 메서드는 문서 합성을 수행하지 않습니다(Synthesize 메서드 제외). 결과를 내보내기 전에 문서 합성을 수행하는 메서드를 명시적으로 호출해야 합니다. 자세한 내용은 전처리, 분석, 인식 및 합성 매개변수 조정을 참조하십시오. FRPage 객체는 소위 “연결 가능한 객체”입니다. Windows용 FRE에서 Visual Basic의 경우 WithEvents로 선언할 수 있습니다. C++(지원되는 모든 운영 체제)의 경우 IConnectionPointContainer 인터페이스를 지원함을 의미합니다. 처리 중 알림 이벤트를 수신하려면 C++ 사용자는 IFRPageEvents 인터페이스에서 파생된 객체를 생성한 후…

Linux 및 macOS에서는 AdviseFREngineObject 전역 함수를 호출하여 FRPage 객체에 등록합니다.
Windows에서는 표준 COM 방식을 사용하여 FRPage 객체에 구현된 이벤트 소스와의 연결을 설정합니다.

Windows에서: FRPage 객체의 메서드는 특수 발신 인터페이스를 통해 페이지 처리 진행 상황에 대한 정보를 보고합니다. 이러한 인터페이스는 IFRPageEvents(C++ 용)와 디스패치 인터페이스 DIFRPageEvents(Visual Basic 용)입니다. Visual Basic 사용자는 이벤트 인터페이스 구현의 세부 사항을 신경 쓸 필요가 없습니다. 이 개발 플랫폼에서 이벤트를 간편하게 처리할 수 있는 수단을 제공하기 때문입니다.

속성


	,읽기 전용	Engine 객체를 반환합니다.

	,읽기 전용	해당 페이지를 포함하는 문서를 반환합니다.
	,읽기 전용	페이지 이미지에 액세스할 수 있습니다.
		페이지의 Layout에 액세스할 수 있습니다. 이 속성에 Layout 객체를 할당하면(예: 한 페이지에서 다른 페이지로 데이터를 전송하는 경우), 해당 문서의 논리적 구조가 유효하지 않게 됩니다. synthesis 메서드 중 하나를 호출하여 문서 구조를 복원해야 합니다. 단, 전체 문서에 대해 synthesis를 수행할 필요는 없으며, 변경된 페이지만 synthesis하면 됩니다. 예를 들어Synthesize메서드를 사용할 수 있습니다.
	,읽기 전용	페이지의 텍스트를 특수한 “plain text” 형식으로 반환합니다.
	, 읽기 전용	페이지 원본 이미지의 전체 경로를 지정합니다.

	, 읽기 전용	인식된 페이지의 기본 언어를 지정합니다. 이 속성에는 감지된 언어 컬렉션(DetectedLanguages 속성)의 첫 번째 언어 내부 이름이 포함됩니다. 이 속성은 자동 언어 감지를 활성화한 상태에서 인식을 수행한 경우에만 유효한 값을 가집니다(자세한 내용은속성을 참조하십시오). 기본값은 빈 문자열입니다.
	,읽기 전용	인식된 페이지에서 감지된 인식 언어 컬렉션에 액세스할 수 있습니다. 컬렉션 내 언어는 출현 빈도 순으로 정렬됩니다(빈도가 높은 언어부터 낮은 언어 순). 이 속성은 자동 언어 감지를 활성화한 상태에서 인식을 수행한 경우에만 유효한 값을 가집니다(자세한 내용은속성을 참조하십시오). 언어 목록은 인식 후에만 업데이트됩니다. 즉, 페이지의 layout을 수동으로 편집해도 컬렉션은 변경되지 않습니다.

	, 읽기 전용	페이지의 논리적 구조가 최신 상태인지 여부를 지정합니다. 이 속성이 TRUE이면 내보내기 전에 해당 페이지에 대해 문서 합성을 수행해야 합니다. 그렇지 않으면 내보내기 중에 오류가 발생합니다. 이 속성은 Visual Components를 사용할 때 유용합니다. 사용자가 Visual Components의 GUI를 통해 페이지 레이아웃을 변경하면 해당 페이지의 논리적 구조가 유효하지 않게 됩니다. Visual Components에서 제공하는 명령을 사용하여 해당 페이지를 내보내는 경우, Visual Components가 자동으로 페이지를 합성합니다. 그러나 내보내기에 FineReader Engine API 메서드를 사용하는 경우에는 내보내기 전에 해당 페이지에 대해 문서 합성을 직접 수행해야 합니다.
	, 읽기 전용	소스 파일에서 해당 페이지의 인덱스를 반환합니다.
	, 읽기 전용	이 페이지의 소스 파일이 디지털 서명된 PDF인지 여부를 나타냅니다.

	,읽기 전용	페이지에서 감지된 명함 컬렉션에 접근할 수 있습니다.

		Visual Components는 현재 Windows에서만 지원됩니다. Undo 및 Redo 메서드의 허용 여부를 지정합니다. 이 속성의 값이 TRUE이면, 페이지를 수정할 수 있는 메서드(예: FRPage 또는객체의 메서드)를 통해 호출되거나 Windows Visual Components에서 호출된 모든 명령을 실행 취소 스택에 추가할 수 있습니다. 이 경우, Visual Components에서 호출된 명령은 자동으로 스택에 추가됩니다. API에서 호출된 명령을 스택에 추가하려면 Update 메서드를 사용하세요. Visual Components에서 열린 페이지에 대해서는 이 속성을 FALSE로 설정할 수 없습니다.
	, 읽기 전용	Visual Components는 현재 Windows에서만 지원됩니다. 페이지를 수정할 수 있는 메서드(예: FRPage 또는객체의 메서드)를 통해 호출되거나 Visual Components 중 하나에서 호출된 가장 최근에 실행 취소된 명령에 대해 Redo 메서드를 실행할 수 있는지 여부를 지정합니다.
	, 읽기 전용	Visual Components는 현재 Windows에서만 지원됩니다. 페이지를 수정할 수 있는 메서드(예: FRPage 또는객체의 메서드)를 통해 호출되거나 Visual Components 중 하나에서 호출된 가장 최근의 명령에 대해 Undo 메서드를 실행할 수 있는지 여부를 지정합니다.

메서드

이름	설명
AddWordsToCacheDictionary	이 메서드는 여러 word를 캐시 사전에 추가합니다.
AddWordToCacheDictionary	이 메서드는 캐시 사전에 단어를 하나 추가합니다.
Analyze	페이지를 분석합니다.
AnalyzeRegion	지정된 영역 내 이미지의 레이아웃을 분석합니다.
AnalyzeTable	지정된 블록을 테이블 블록으로 대체하고 테이블 구조를 분석합니다.
CleanCacheDictionary	이 메서드는 캐시 사전에 있는 모든 단어를 삭제합니다.
DetectOrientation	페이지 방향을 감지합니다.
DetectResolution	지정된 범위에서 가장 적합한 해상도를 선택합니다.
Export	페이지를 외부 형식 파일로 저장합니다.
ExtractBarcodes	모든 Barcode 블록을 찾아 인식합니다.
ExtractMrz	기계 판독 영역(MRZ)에서 데이터를 추출합니다.
FindPageSplitPosition	이미지를 분할할 위치를 찾습니다.
Flush	이들에 대한 참조가 없는 경우, FRPage 객체에 해당하는 ImageDocument 및 Layout 객체를 메모리에서 해제하고, 필요한 경우 디스크에 저장합니다. 디스크 저장은 선택 사항이므로 데이터가 변경되지 않았다면 이 단계를 생략할 수 있습니다.
IsEmpty	페이지가 비어 있는지 확인합니다.
LearnCheckmarks	FineReader Engine이 사용자 정의 유형의 체크마크를 인식하도록 학습합니다.
PreprocessAnalyzeRecognize	페이지에 대해 전처리, 레이아웃 분석, 인식 및 페이지 합성을 수행합니다.
Preprocess	페이지를 전처리합니다. 즉, 페이지 방향, 반전, 기하학적 왜곡을 보정합니다. 페이지 전처리는 페이지 분석 전에 수행됩니다.
Recognize	페이지를 인식한 후 페이지 합성을 수행합니다.
RecognizeBlocks	명시적으로 지정한 블록 집합에서 텍스트를 인식하고 페이지 합성을 수행합니다.
Redo	<Warning>Visual Components는 현재 Windows에서만 지원됩니다.</Warning> FineReader Engine API에서 호출된 가장 최근의 실행 취소 명령을 다시 실행합니다.
Synthesize	개별 페이지의 문서 합성을 수행합니다. Linux와 Windows에서는 배치 프로세서를 사용해 한 페이지 문서를 처리할 때 이 메서드가 유용할 수 있습니다.
SynthesizeBusinessCard	지정된 인식 영역에서 명함 field를 찾습니다.
SynthesizeBusinessCardEx	합성 매개변수를 사용하여 지정된 인식 영역에서 명함 field를 찾으려고 시도합니다.
Undo	<Warning> Visual Components는 현재 Windows에서만 지원됩니다. </Warning> FineReader Engine API를 통해 마지막으로 호출된 명령을 실행 취소합니다.
Update	<Warning> Visual Components는 현재 Windows에서만 지원됩니다. </Warning> Linux 및 macOS: 페이지 layout의 변경 사항을 실행 취소 스택에 저장합니다. Windows: FineReader Engine API를 통해 페이지 layout에 적용된 변경 사항을 Visual Components로 전송하고, 이러한 변경 사항을 실행 취소 스택에 저장합니다. <Note> 이 메서드를 호출하면 해당 문서의 논리 구조가 더 이상 유효하지 않게 됩니다. 합성 메서드 중 하나를 호출하여 문서 구조를 복원해야 합니다. 하지만 전체 문서에 대해 합성을 수행할 필요는 없으며, 변경된 페이지에 대해서만 합성하면 됩니다. 예를 들어 Synthesize 메서드를 사용할 수 있습니다. </Note>

객체 다이어그램

출력 매개변수

이 객체는 다음 메서드의 출력 매개변수입니다:

FRPages 객체의 Item 메서드
Linux 및 Windows: BatchProcessor 객체의 GetNextProcessedPage 메서드

입력 매개변수

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

FRPages 객체의 IndexOf 메서드
FRDocument 객체의 AddPage 메서드
ExportFileWriter 객체의 AddPage 메서드
ClassificationEngine 객체의 CreateObjectFromPage 메서드
IFRPageEvents 인터페이스의 OnProgress, OnWarning, OnRegionProcessed, OnPageProcessed 메서드
IFRPagesEvents 인터페이스의 PageRemoved 메서드
Comparator 객체의 ComparePages 메서드
Linux 및 Windows: BatchProcessor 객체의 ProcessPageAsync 메서드
Windows에서 Visual Components 사용 시:
- DocumentViewerEvents 인터페이스의 OnActivePageChanged, OnActivePageChanging 메서드
- IImageViewerEvents 인터페이스의 OnActivePageChanged, OnActivePageChanging 메서드
- IZoomViewerEvents 인터페이스의 OnActivePageChanged 메서드
- ITextEditorEvents 인터페이스의 OnActivePageChanged, OnActivePageChanging 메서드
- ITextValidatorEvents 인터페이스의 OnActivePageChanged 메서드

샘플

C# 코드

FREngine.IEngine engine;
string fileName;
FREngine.IBatchProcessor batchProcessor;
// 배치 프로세서가 생성되고 시작되었다고 가정합니다
// 인식된 페이지를 가져와 PDF 형식으로 내보냅니다
FREngine.IFRPage page = batchProcessor.GetNextProcessedPage();
while( page != null ) {
 // 내보내기 전에 페이지를 합성합니다
 page.Synthesize(null);
 // 페이지를 파일로 내보냅니다
 page.Export(fileName, FREngine.FileExportFormatEnum.FEF_PDF, null);
 page = batchProcessor.GetNextProcessedPage();
}

이 객체는 다음 코드 샘플에서 사용됩니다:

macOS: 명함 인식 및 RecognizedTextProcessing
Linux: BCR, BatchProcessing, CustomLanguage, CommandLineInterface
Windows: BatchProcessing, CustomLanguage, CommandLineInterface, RecognizedTextProcessing, VisualComponents 및 데모 도구: BatchProcessingRecognition, Engine Predefined Processing Profiles.

참고 항목

FRPages Working with Connectable Objects 속성 사용하기

FRPages 객체의 Swap 메서드

FRPage 객체의 AddWordsToCacheDictionary 메서드

⌘I

개요

기능

엔진 객체(IEngine 인터페이스)

엔진 로더

이미지 관련 객체

Layout 관련 객체

언어 관련 객체

텍스트 관련 객체

문서 관련 객체

Batch Processor

메커니즘 객체

Parameter 객체

분류 관련 객체

라이선스 관련 객체

문서 비교 객체

보조 객체 및 메서드

열거형

FRPage 객체 (IFRPage 인터페이스)

속성

메서드

출력 매개변수

입력 매개변수

샘플

참고 항목

개요

기능

엔진 객체(IEngine 인터페이스)

엔진 로더

이미지 관련 객체

Layout 관련 객체

언어 관련 객체

텍스트 관련 객체

문서 관련 객체

Batch Processor

메커니즘 객체

Parameter 객체

분류 관련 객체

라이선스 관련 객체

문서 비교 객체

보조 객체 및 메서드

열거형

​속성

​메서드

​관련 객체

​출력 매개변수

​입력 매개변수

​관련 Visual Components

​샘플

​참고 항목

속성

메서드

관련 객체

출력 매개변수

입력 매개변수

관련 Visual Components

샘플

참고 항목