Pular para o conteúdo principal
Este método não é implementado para Linux ou macOS
Este método cria uma cópia dos dados de bitmap especificados no formato de imagem interno do FineReader Engine e oferece suporte aos seguintes formatos de imagem:
  • monocromático de 1 bit (cada pixel é representado por 1 bit).
  • escala de cinza de 8 bits (cada pixel é representado por 8 bits).
  • colorido de 24 bits (cada grupo de 24 bits usa 8 bits de cada componente R, G e B).
A imagem de saída obtida por esse método pode ser aberta usando o método IEngine::LoadImageDoc.

​
Sintaxe

​
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] _
)

​
Parâmetros

Format [in] Este parâmetro do tipo BitmapBitsFormatEnum especifica o formato dos dados de bitmap a serem preparados. Width [in] Especifica a largura do bitmap em pixels. Este parâmetro não deve ser 0. Height [in] Especifica a altura do bitmap em pixels. Este parâmetro não deve ser 0. ByteWidth [in] Especifica a largura da linha do bitmap em bytes. Ela deve levar em conta o alinhamento. Este parâmetro não deve ser 0. XResolution [in] Especifica a resolução horizontal do bitmap em pontos por polegada. YResolution [in] Especifica a resolução vertical do bitmap em pontos por polegada. RawDataPtr [in] Este parâmetro é tratado como um handle para o buffer de memória que contém os dados de bitmap. O handle é passado como __int64. Consulte a descrição das constantes de BitmapBitsFormatEnum para obter detalhes sobre o formato dos dados. DestinationFolderName [in] Especifica o caminho completo para a pasta onde a imagem em formato interno deve ser salva. Essa pasta deve existir; caso contrário, um código de erro será retornado. PrepareMode [in] Refere-se ao objeto PrepareImageMode, que define o modo de preparação da imagem. Ele pode ser 0; nesse caso, serão usados os valores padrão das propriedades de PrepareImageMode ou, se um perfil tiver sido carregado, serão usados os parâmetros definidos por esse perfil.

​
Valores de retorno

Windows: este método não possui valores de retorno específicos. Ele retorna os valores de retorno padrão das funções do ABBYY FineReader Engine. Linux e macOS: este método retorna E_NOTIMPL.

​
Observações

  • Se você precisar excluir os arquivos com as imagens preparadas quando eles não forem mais necessários, implemente esse procedimento no seu aplicativo. Esses arquivos não serão removidos automaticamente do disco pelo ABBYY FineReader Engine.
  • Este método não funciona se o Engine for carregado como um servidor out-of-process no Linux ou se o objeto for criado usando o objeto OutprocLoader no Windows.

​
Veja também

Engine OpenBitmapBits LoadImageDoc BitmapBitsFormatEnum Como trabalhar com perfis