Vai al contenuto principale
Questo metodo è implementato in FRE per Windows
Questo metodo restituisce una parte dell’immagine come DIB (Device-Independent Bitmap) top-down. Per le immagini in scala di grigi e in bianco e nero, viene utilizzata la tavolozza in cui 0 corrisponde al nero. Il metodo restituisce il DIB come oggetto Handle. Questo oggetto gestisce l’allocazione della memoria e rilascia le risorse quando non sono più utilizzate.

Sintassi

C++

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

C#

IHandle GetBitmap( IImageModification Modification );

Visual Basic .NET

Function GetBitmap(Modification As IImageModification) As IHandle

Parametri

Modification [in] Questo parametro di tipo ImageModification definisce le modifiche da applicare all’immagine. Può includere rettangoli di ritaglio, nel qual caso vengono passate solo le parti specificate dell’immagine, un rapporto di ridimensionamento, rettangoli di riempimento per colorare alcune parti dell’immagine e così via. Questo parametro può essere 0 e, in tal caso, non verrà applicata alcuna modifica alla pagina dell’immagine, che verrà passata “così com’è”. Result [out, retval] Un puntatore a una variabile puntatore IHandle* che riceve il puntatore all’interfaccia dell’oggetto Handle risultante, che rappresenta l’handle del bitmap associato.

Valori di ritorno

Osservazioni

Questo metodo non funziona se Engine viene caricato come server out-of-process in Linux o se l’oggetto viene creato tramite l’oggetto OutprocLoader in Windows.

Esempi

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// Si presume che il documento sia già stato creato e che vi siano state aggiunte delle immagini
// Ottiene l'handle della bitmap del piano immagine a colori di una pagina del documento
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// Lavora con la bitmap
System.Drawing.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );
Il metodo viene utilizzato nei seguenti strumenti demo di Windows: Engine Predefined Processing Profiles.

Vedi anche

ImageModification IImage::EstimateBitmapSize