Vai al contenuto principale
Questo metodo non è implementato per Linux o macOS
Questo metodo crea una copia dei dati bitmap specificati nel formato immagine interno di FineReader Engine e supporta i seguenti formati di immagine:
  • monocromatico a 1 bit (ogni pixel è rappresentato da 1 bit).
  • in scala di grigi a 8 bit (ogni pixel è rappresentato da 8 bit).
  • a colori a 24 bit (ogni gruppo di 24 bit utilizza 8 bit per ciascun componente R, G e B).
L’immagine di output ottenuta con questo metodo può quindi essere aperta mediante il metodo IEngine::LoadImageDoc.

​
Sintassi

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

​
Parametri

Format [in] Questo parametro di tipo BitmapBitsFormatEnum specifica il formato dei dati bitmap da preparare. Width [in] Specifica la larghezza del bitmap in pixel. Questo parametro non deve essere 0. Height [in] Specifica l’altezza del bitmap in pixel. Questo parametro non deve essere 0. ByteWidth [in] Specifica la larghezza in byte della riga del bitmap. Deve tenere conto dell’allineamento. Questo parametro non deve essere 0. XResolution [in] Specifica la risoluzione orizzontale del bitmap in punti per pollice. YResolution [in] Specifica la risoluzione verticale del bitmap in punti per pollice. RawDataPtr [in] Questo parametro è trattato come un handle a un buffer di memoria contenente dati bitmap. L’handle viene passato come __int64. Per i dettagli sul formato dei dati, vedere la descrizione delle costanti BitmapBitsFormatEnum. DestinationFolderName [in] Specifica il percorso completo della cartella in cui salvare l’immagine in formato interno. Questa cartella deve esistere; in caso contrario, viene restituito un codice di errore. PrepareMode [in] Fa riferimento all’oggetto PrepareImageMode, che definisce la modalità di preparazione dell’immagine. Può essere 0; in tal caso verranno utilizzati i valori predefiniti delle proprietà di PrepareImageMode oppure, se è stato caricato un profilo, i parametri impostati da tale profilo.

​
Valori di ritorno

Windows: questo metodo non ha valori di ritorno specifici. Restituisce i valori di ritorno standard delle funzioni di ABBYY FineReader Engine. Linux e macOS: questo metodo restituisce E_NOTIMPL.

​
Osservazioni

  • Se devi eliminare i file con le immagini preparate quando non sono più necessari, implementa questa procedura nella tua applicazione. Questi file non verranno rimossi automaticamente dal disco da ABBYY FineReader Engine.
  • Questo metodo non funziona se l’Engine è caricato come server out-of-process in Linux o se l’oggetto viene creato tramite l’oggetto OutprocLoader in Windows.

​
Vedi anche

Engine OpenBitmapBits LoadImageDoc BitmapBitsFormatEnum Lavorare con i profili