Passer au contenu principal
Cette méthode n’est pas implémentée pour Linux ou macOS.
Cette méthode crée une copie des données bitmap spécifiées dans le format d’image interne de FineReader Engine et prend en charge les formats d’image suivants :
  • monochrome 1 bit (chaque pixel est représenté par 1 bit) ;
  • niveaux de gris 8 bits (chaque pixel est représenté par 8 bits) ;
  • couleur 24 bits (chaque groupe de 24 bits utilise 8 bits pour chacune des composantes R, G et B).
L’image de sortie obtenue avec cette méthode peut ensuite être ouverte à l’aide de la méthode IEngine::LoadImageDoc.

​
Syntaxe

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

​
Paramètres

Format [in] Ce paramètre, de type BitmapBitsFormatEnum, spécifie le format des données bitmap à préparer. Width [in] Spécifie la largeur du bitmap en pixels. Ce paramètre ne doit pas être 0. Height [in] Spécifie la hauteur du bitmap en pixels. Ce paramètre ne doit pas être 0. ByteWidth [in] Spécifie la largeur, en octets, d’une ligne du bitmap. Elle doit tenir compte du remplissage. Ce paramètre ne doit pas être 0. XResolution [in] Spécifie la résolution horizontale du bitmap en points par pouce. YResolution [in] Spécifie la résolution verticale du bitmap en points par pouce. RawDataPtr [in] Ce paramètre est traité comme un handle vers un tampon mémoire contenant les données bitmap. Le handle est transmis sous la forme d’un __int64. Voir la description des constantes BitmapBitsFormatEnum pour plus de détails sur le format des données. DestinationFolderName [in] Spécifie le chemin complet du dossier dans lequel l’image au format interne doit être enregistrée. Ce dossier doit exister ; sinon, un code d’erreur est renvoyé. PrepareMode [in] Fait référence à l’objet PrepareImageMode, qui définit le mode de préparation de l’image. Il peut être égal à 0 ; dans ce cas, les valeurs par défaut des propriétés de PrepareImageMode sont utilisées. Si un profil a été chargé, les paramètres définis par ce profil sont utilisés.

​
Valeurs de retour

Windows : cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les valeurs de retour standard des fonctions ABBYY FineReader Engine. Linux et macOS : cette méthode renvoie E_NOTIMPL.

​
Remarques

  • Si vous devez supprimer les fichiers d’images préparées lorsqu’ils ne sont plus nécessaires, prévoyez cette procédure dans votre application. Ces fichiers ne seront pas automatiquement supprimés du disque par ABBYY FineReader Engine.
  • Cette méthode ne fonctionne pas si le Engine est chargé en tant que serveur hors processus sous Linux ou si l’objet est créé à l’aide de l’objet OutprocLoader sous Windows.

​
Voir aussi

Engine OpenBitmapBits LoadImageDoc BitmapBitsFormatEnum Travailler avec les profils