Método ID2D1RenderTarget::CreateCompatibleRenderTarget(constD2D1_SIZE_F*,constD2D1_SIZE_U*,constD2D1_PIXEL_FORMAT*,D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS,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(
  const D2D1_SIZE_F                     *desiredSize,
  const D2D1_SIZE_U                     *desiredPixelSize,
  const D2D1_PIXEL_FORMAT               *desiredFormat,
  D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
  ID2D1BitmapRenderTarget               **bitmapRenderTarget
);

Parâmetros

desiredSize

Tipo: [in] const 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] const 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.

desiredFormat

Tipo: [in] const D2D1_PIXEL_FORMAT*

O formato de pixel desejado e o modo alfa do novo destino de renderização. Se o formato de pixel estiver definido como DXGI_FORMAT_UNKNOWN, o novo destino de renderização usará o mesmo formato de pixel que o destino de renderização original. Se o modo alfa for D2D1_ALPHA_MODE_UNKNOWN, o modo alfa do novo destino de renderização usará como padrão D2D1_ALPHA_MODE_PREMULTIPLIED. Para obter informações sobre formatos de pixel com suporte, consulte Formatos de pixel com suporte e modos alfa.

options

Tipo: [in] D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS

Um valor que especifica se o novo destino de renderização deve ser compatível com o GDI.

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.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d2d1.h
Biblioteca D2d1.lib
DLL D2d1.dll

Confira também

ID2D1RenderTarget