Método ID2D1RenderTarget::D rawBitmap(ID2D1Bitmap,constD2D1_RECT_F,FLOAT,D2D1_BITMAP_INTERPOLATION_MODE,constD2D1_RECT_F*) (d2d1.h)

Artigo
02/28/2024

Desenha o bitmap especificado depois de dimensioná-lo para o tamanho do retângulo especificado.

Sintaxe

void DrawBitmap(
  [in]           ID2D1Bitmap                    *bitmap,
  [in, optional] const D2D1_RECT_F              *destinationRectangle,
                 FLOAT                          opacity,
                 D2D1_BITMAP_INTERPOLATION_MODE interpolationMode,
  [in, optional] const D2D1_RECT_F              *sourceRectangle
);

Parâmetros

[in] bitmap

Tipo: ID2D1Bitmap*

O bitmap a ser renderizado.

[in, optional] destinationRectangle

Tipo: const D2D1_RECT_F*

O tamanho e a posição, em pixels independentes de dispositivo no espaço de coordenadas do destino de renderização, da área para a qual o bitmap é desenhado; NULL para desenhar a parte selecionada do bitmap na origem do destino de renderização. Se o retângulo for especificado, mas não bem ordenado, nada será desenhado, mas o destino de renderização não inserirá um estado de erro.

opacity

Tipo: FLOAT

Um valor entre 0.0f e 1.0f, inclusive, que especifica um valor de opacidade a ser aplicado ao bitmap. Esse valor é multiplicado em relação aos valores alfa do conteúdo do bitmap. O valor padrão é 1.0f.

interpolationMode

Tipo: D2D1_BITMAP_INTERPOLATION_MODE

O modo de interpolação a ser usado, se o bitmap for dimensionado ou girado pela operação de desenho. O valor padrão é D2D1_BITMAP_INTERPOLATION_MODE_LINEAR.

[in, optional] sourceRectangle

Tipo: const D2D1_RECT_F*

O tamanho e a posição, em pixels independentes do dispositivo no espaço de coordenadas do bitmap, da área dentro do bitmap a ser desenhada; NULL para desenhar todo o bitmap.

Retornar valor

Nenhum

Comentários

Esse método não retornará um código de erro se falhar. Para determinar se uma operação de desenho (como DrawBitmap) falhou, marcar o resultado retornado pelos métodos ID2D1RenderTarget::EndDraw ou ID2D1RenderTarget::Flush.

Exemplos

Para obter um exemplo, consulte Como desenhar um bitmap. Para obter um exemplo que mostra como carregar um bitmap de um recurso ou de um arquivo, consulte Como carregar um bitmap de um recurso e Como carregar um bitmap de um arquivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d2d1.h
Biblioteca	D2d1.lib
DLL	D2d1.dll