Passer au contenu principal
Cette méthode est implémentée dans FRE pour Windows
Cette méthode renvoie une partie de l’image sous la forme d’un DIB (Device-Independent Bitmap) de haut en bas. La palette, dans laquelle 0 correspond à la couleur noire, est utilisée pour les images en niveaux de gris et en noir et blanc. La méthode renvoie le DIB sous la forme de l’objet Handle. Cet objet gère l’allocation de la mémoire et libère les ressources lorsqu’elles ne sont plus utilisées.

Syntaxe

C++

HRESULT GetBitmap(
  IImageModification* Modification,
  IHandle**           Result
);

C#

IHandle GetBitmap( IImageModification Modification );

Visual Basic .NET

Function GetBitmap(Modification As IImageModification) As IHandle

Paramètres

Modification [in] Ce paramètre de type ImageModification définit les modifications appliquées à l’image. Il peut inclure des rectangles de découpe, auquel cas seules les parties spécifiées de l’image sont transmises, un facteur d’étirement, des rectangles de remplissage pour colorer certaines parties de l’image, etc. Ce paramètre peut valoir 0 ; dans ce cas, aucune modification n’est appliquée à la page d’image, qui est transmise « telle quelle ». Result [out, retval] Pointeur vers une variable pointeur IHandle* qui reçoit le pointeur d’interface de l’objet Handle résultant, représentant le handle du bitmap associé.

Valeurs de retour

Remarques

Cette méthode ne fonctionne pas si l’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.

Exemples

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// Nous supposons que le document a été créé et que des images y ont été ajoutées
// Obtenir le handle de bitmap d'un plan d'image couleur d'une page du document
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// Utiliser le bitmap
System.Drawing.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );
La méthode est utilisée dans les outils de démonstration Windows suivants : Engine Predefined Processing Profiles.

Voir aussi

ImageModification IImage::EstimateBitmapSize