메인 콘텐츠로 건너뛰기
이 메서드는 Linux 또는 macOS에서는 구현되지 않았습니다
이 메서드는 지정된 비트맵 데이터의 복사본을 FineReader 엔진 내부 이미지 형식으로 생성하며, 다음 이미지 형식을 지원합니다:
  • 1비트 흑백(각 픽셀은 1비트로 표현됨)
  • 8비트 회색조(각 픽셀은 8비트로 표현됨)
  • 24비트 컬러(24비트는 각각 R, G, B 구성 요소에 8비트씩 사용됨)
이 메서드로 생성된 출력 이미지는 이후 IEngine::LoadImageDoc 메서드로 열 수 있습니다.

구문

C++

HRESULT PrepareBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  __int64              RawDataPtr,
  BSTR                 DestinationFolderName,
  IPrepareImageMode*   PrepareMode
);

C#

void PrepareBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  Int64                RawDataPtr,
  string               DestinationFolderName,
  IPrepareImageMode     PrepareMode
);

Visual Basic .NET

Sub PrepareBitmapBits( _
  Format As BitmapBitsFormatEnum, _
  Width As Integer, _
  Height As Integer, _
  ByteWidth As Integer_
  XResolution As Integer, _
  YResolution As Integer, _
  RawDataPtr As Int64, _
  DestinationFolderName As String, _
  [PrepareMode As IPrepareImageMode = Nothing] _
)

매개변수

Format [in] BitmapBitsFormatEnum 형식의 이 매개변수는 준비할 비트맵 데이터의 형식을 지정합니다. Width [in] 비트맵의 너비를 픽셀 단위로 지정합니다. 이 매개변수는 0일 수 없습니다. Height [in] 비트맵의 높이를 픽셀 단위로 지정합니다. 이 매개변수는 0일 수 없습니다. ByteWidth [in] 비트맵 한 줄의 너비를 바이트 단위로 지정합니다. 여기에는 정렬이 반영되어야 합니다. 이 매개변수는 0일 수 없습니다. XResolution [in] 비트맵의 가로 해상도를 인치당 도트 수로 지정합니다. YResolution [in] 비트맵의 세로 해상도를 인치당 도트 수로 지정합니다. RawDataPtr [in] 이 매개변수는 비트맵 데이터가 들어 있는 메모리 버퍼에 대한 핸들로 처리됩니다. 이 핸들은 __int64로 전달됩니다. 데이터 형식에 대한 자세한 내용은 BitmapBitsFormatEnum 상수 설명을 참조하세요. DestinationFolderName [in] 내부 형식의 이미지를 저장할 폴더의 전체 경로를 지정합니다. 이 폴더는 반드시 존재해야 하며, 그렇지 않으면 오류 코드가 반환됩니다. PrepareMode [in] 이미지 준비 모드를 정의하는 PrepareImageMode 객체를 참조합니다. 이 값은 0일 수 있으며, 이 경우 PrepareImageMode Properties의 기본값이 사용됩니다. 또는 프로필이 로드된 경우에는 해당 프로필에 설정된 매개변수가 사용됩니다.

반환 값

Windows: 이 메서드는 별도의 특정 반환 값을 제공하지 않습니다. ABBYY FineReader 엔진 함수의 표준 반환 값을 반환합니다. Linux 및 macOS: 이 메서드는 E_NOTIMPL을 반환합니다.

비고

  • 준비된 이미지 파일이 더 이상 필요 없을 때 이를 삭제해야 한다면, 해당 절차를 애플리케이션에 구현해야 합니다. 이 파일은 ABBYY FineReader 엔진이 디스크에서 자동으로 삭제하지 않습니다.
  • Linux에서 엔진이 out-of-process 서버로 로드된 경우 또는 Windows에서 OutprocLoader 객체를 통해 이 객체가 생성된 경우에는 이 메서드가 작동하지 않습니다.

참고 항목

엔진 OpenBitmapBits LoadImageDoc BitmapBitsFormatEnum 프로필 사용하기