메인 콘텐츠로 건너뛰기
이 메서드는 입력 PDF 파일이 “image only” 또는 “image on text” 형식인 경우 이를 처리하여, 동일한 페이지 이미지와 문서에서 인식한 텍스트로 생성된 보이지 않는 텍스트 레이어를 포함하는 검색 가능한 PDF 파일을 만듭니다. 입력 파일에 이미 텍스트 레이어가 있으면 해당 레이어는 대체됩니다. 입력 파일에 텍스트 레이어가 포함되어 있는지 확인하려면 엔진 객체의 IsPdfWithTextualContent 메서드를 사용할 수 있습니다. 이 메서드로는 PDF 파일만 처리할 수 있습니다. 다른 이미지 형식에서 검색 가능한 PDF를 만들려면 FRDocument 객체의 메서드(예: AddImageFile, Process, Export)를 사용할 수 있습니다.
Windows에서는 이 메서드를 호출하기 전에 현재 스레드에서 COM 라이브러리를 초기화해야 합니다.

구문

C++

HRESULT InjectTextLayer(
  BSTR                       SourcePdfFile,
  BSTR                       TargetPdfFile,
  IImagePasswordCallback*    PasswordCallback,
  IPrepareImageMode*         PrepareMode,
  IDocumentProcessingParams* DocumentProcessingParams,
  IIntsCollection*           PageIndices,
  IProcessingEvents*         ProcessingEvents,
  ITextLayerInjectionParams* TextLayerInjectionParams
);

C#

void InjectTextLayer(
  string                    SourcePdfFile,
  string                    TargetPdfFile,
  IImagePasswordCallback    PasswordCallback,
  IPrepareImageMode         PrepareMode,
  IDocumentProcessingParams DocumentProcessingParams,
  IIntsCollection           PageIndices,
  IProcessingEvents         ProcessingEvents,
  ITextLayerInjectionParams TextLayerInjectionParams
);

Visual Basic .NET

 Sub InjectTextLayer( _
  SourcePdfFile As String, _
  TargetPdfFile As String, _                
  [PasswordCallback As IImagePasswordCallback = Nothing], _
  [PrepareMode As IPrepareImageMode = Nothing], _         
  [DocumentProcessingParams As IDocumentProcessingParams = Nothing], _
  [PageIndices As IIntsCollection = Nothing], _
  [ProcessingEvents As IProcessingEvents = Nothing], _
  [TextLayerInjectionParams As ITextLayerInjectionParams = Nothing] _
)

매개변수

SourcePdfFile [in] 이 변수에는 원본 PDF 파일의 전체 경로가 들어 있습니다. 다른 형식의 파일은 처리할 수 없습니다. TargetPdfFile [in] 이 변수에는 처리 결과로 생성할 검색 가능한 PDF 파일의 전체 경로가 들어 있습니다. 원본 파일과 대상 파일의 이름은 같을 수 없습니다. PasswordCallback [in] PDF 파일에 액세스할 때 발생할 수 있는 암호 요청을 처리하는 데 사용되는, 사용자가 구현한 IImagePasswordCallback 형식 객체의 인터페이스를 가리킵니다. 이 매개변수는 선택 사항이며 0일 수 있습니다. 이 경우 암호로 보호된 파일은 처리할 수 없습니다. PrepareMode [in] 이미지 파일을 ABBYY FineReader Engine 내부 형식으로 변환하는 모드를 정의하는 PrepareImageMode 객체를 가리킵니다. 이 매개변수는 0일 수 있으며, 이 경우 이미지 준비 모드의 기본 매개변수가 사용됩니다. 또는 프로필이 로드된 경우 해당 프로필에 설정된 매개변수가 사용됩니다. 기하 보정 관련 매개변수 중에서는 기울기 보정, 미러링, 회전에 해당하는 항목만 적용됩니다. 페이지 분할과 비선형 기하 보정은 수행되지 않습니다. DocumentProcessingParams [in] 모든 처리 매개변수를 저장하는 DocumentProcessingParams 객체를 가리킵니다. 이 매개변수는 0일 수 있습니다. 이 경우 문서는 기본 매개변수로 처리됩니다(모든 처리 매개변수는 기본값으로 설정됨). 또는 프로필이 로드된 경우 해당 프로필에 설정된 매개변수가 사용됩니다. 기하 보정 관련 매개변수 중에서는 이미지 기울기 보정, 미러링, 회전에 해당하는 항목만 적용됩니다. 페이지 분할과 비선형 기하 보정은 수행되지 않습니다. PageIndices [in] 이 매개변수는 텍스트를 삽입할 문서 페이지의 인덱스를 지정하는 IntsCollection 객체를 가리킵니다. 이 매개변수는 선택 사항이며 0일 수 있습니다. 이 경우 텍스트는 문서의 모든 페이지에 삽입됩니다. ProcessingEvents [in] 처리를 관리하는 데 사용되는, 사용자가 구현한 객체의 IProcessingEvents 인터페이스를 가리킵니다. 이 매개변수는 0일 수 있으며, 이 경우 콜백은 연결되지 않습니다. TextLayerInjectionParams [in] 이 변수는 텍스트 삽입 중 문서 처리 매개변수를 저장하는 TextLayerInjectionParams 객체를 가리킵니다. 이 매개변수는 0일 수 있습니다. 이 경우 객체 속성의 기본값이 사용됩니다.

반환 값

이 메서드에는 특정 반환 값이 없습니다. ABBYY FineReader 엔진 함수의 표준 반환 값을 반환합니다.

참고

이미지 기울어짐 보정, 미러링 및 회전에 해당하는 처리 매개변수가 반영됩니다. 페이지 분할과 비선형 기하 보정은 수행되지 않습니다. Linux 및 Windows에서는 IEngine::MultiProcessingParams 속성 값에 따라 ABBYY FineReader 엔진이 여러 페이지로 구성된 문서의 처리를 CPU 코어에 분산할 수 있습니다.

참고 항목

엔진 IImagePasswordCallback