Pular para o conteúdo principal
Este método é implementado no FRE para Windows.
Este método retorna uma parte da imagem como um DIB top-down (Device-Independent Bitmap). A paleta, na qual 0 corresponde à cor preta, é usada para imagens em tons de cinza e em preto e branco. O método retorna o DIB como o objeto Handle. Esse objeto gerencia a alocação de memória e libera os recursos quando eles não estão mais em uso.

Sintaxe

C++

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

C#

IHandle GetBitmap( IImageModification Modification );

Visual Basic .NET

Function GetBitmap(Modification As IImageModification) As IHandle

Parâmetros

Modification [in] Este parâmetro do tipo ImageModification define as modificações aplicadas à imagem. Ele pode incluir retângulos de recorte, caso em que apenas as partes especificadas da imagem são passadas, proporção de redimensionamento, retângulos de pintura para preencher partes da imagem com cor, entre outros. Este parâmetro pode ser 0 e, nesse caso, nenhuma modificação será aplicada à página da imagem, que será passada “como está”. Result [out, retval] Um ponteiro para uma variável de ponteiro IHandle* que recebe o ponteiro de interface do objeto Handle resultante, representando o identificador do bitmap associado.

Valores de retorno

Observações

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.

Exemplos

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// Pressupõe-se que o documento já tenha sido criado e que imagens tenham sido adicionadas a ele
// Obter o identificador do bitmap de um plano de imagem colorida de uma página do documento
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// Trabalhar com o bitmap
System.Drawing.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );
O método é usado nas seguintes ferramentas de demonstração do Windows: Engine Predefined Processing Profiles.

Veja também

ImageModification IImage::EstimateBitmapSize