Método ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,ID2D1BitmapRenderTarget**) (d2d1.h)

  • Artigo

Cria um destino de renderização de bitmap para uso durante o desenho intermediário fora da tela que é compatível com o destino de renderização atual.

Sintaxe

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

Parâmetros

desiredSize

Tipo: [in] D2D1_SIZE_F

O tamanho desejado do novo destino de renderização (em pixels independentes de dispositivo), se ele deve ser diferente do destino de renderização original. Para obter mais informações, consulte a seção Comentários.

desiredPixelSize

Tipo: [in] D2D1_SIZE_U

O tamanho desejado do novo destino de renderização em pixels se ele deve ser diferente do destino de renderização original. Para obter mais informações, consulte a seção Comentários.

bitmapRenderTarget

Tipo: [out] ID2D1BitmapRenderTarget**

Quando esse método retorna, contém um ponteiro para um ponteiro para um novo destino de renderização de bitmap. Este parâmetro é passado não inicializado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

O tamanho do pixel e o DPI do novo destino de renderização podem ser alterados especificando valores para desiredSize ou desiredPixelSize.

  • Se desiredSize for especificado, mas desiredPixelSize não for, o tamanho do pixel será calculado do tamanho desejado usando o DPI de destino pai. Se desiredSize for mapeado para um tamanho de pixel inteiro, o DPI do destino de renderização compatível será o mesmo que o DPI do destino pai. Se desiredSize for mapeado para um tamanho de pixel fracionário, o tamanho do pixel será arredondado para cima até o inteiro mais próximo e o DPI para o destino de renderização compatível será ligeiramente maior que o DPI do destino de renderização pai. Em todos os casos, a coordenada (desiredSize.width, desiredSize.height) é mapeada para o canto inferior direito do destino de renderização compatível.
  • Se desiredPixelSize for especificado e desiredSize não for, o DPI do novo destino de renderização será o mesmo que o destino de renderização original.
  • Se desiredSize e desiredPixelSize forem especificados, o DPI do novo destino de renderização será calculado para considerar a diferença na escala.
  • Se nem desiredSize nem desiredPixelSize for especificado, o novo tamanho de destino de renderização e o DPI corresponderão ao destino de renderização original.

O destino de renderização de bitmap criado por esse método não é compatível com a GDI.

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

Confira também

ID2D1RenderTarget