Função RenderTargetProperties (d2d1helper.h)

Cria uma estrutura D2D1_RENDER_TARGET_PROPERTIES .

Sintaxe

D2D1_RENDER_TARGET_PROPERTIES RenderTargetProperties(
       D2D1_RENDER_TARGET_TYPE   type,
  [in] const D2D1_PIXEL_FORMAT & pixelFormat,
       FLOAT                     dpiX,
       FLOAT                     dpiY,
       D2D1_RENDER_TARGET_USAGE  usage,
       D2D1_FEATURE_LEVEL        minLevel
);

Parâmetros

type

Tipo: D2D1_RENDER_TARGET_TYPE

Um valor que especifica se o destino de renderização deve usar renderização de hardware ou renderização de software. O valor padrão, D2D1_RENDER_TARGET_TYPE_DEFAULT, especifica que a renderização de hardware seja usada; se a renderização de hardware não estiver disponível, o destino de renderização usará a renderização de software. Observe que os destinos de renderização de bitmap wic não dão suporte à renderização de hardware.

[in] pixelFormat

Tipo: const D2D1_PIXEL_FORMAT

O formato de pixel e o modo alfa do destino de renderização. O formato de pixel padrão é D2D1::P ixelFormat, que informa ao Direct2D para selecionar um formato de pixel compatível com o destino de renderização. Para obter uma lista de formatos de pixel e modos alfa compatíveis com cada destino de renderização, consulte Formatos de pixel com suporte e modos alfa.

dpiX

Tipo: FLOAT

A DPI horizontal do destino de renderização. O valor padrão é 0,0. Se dpiX e dpiY estiverem definidos como 0,0, o destino de renderização usará seu DPI padrão. Para obter mais informações, consulte D2D1_RENDER_TARGET_PROPERTIES.

dpiY

Tipo: FLOAT

A DPI vertical do destino de renderização. O valor padrão é 0,0. Se dpiX e dpiY estiverem definidos como 0,0, o destino de renderização usará seu DPI padrão. Para obter mais informações, consulte D2D1_RENDER_TARGET_PROPERTIES.

usage

Tipo: D2D1_RENDER_TARGET_USAGE

Especifica como o destino de renderização é renderizado remotamente e se ele deve ser compatível com GDI. O valor padrão, D2D1_RENDER_TARGET_USAGE_NONE, cria um destino de renderização que não é compatível com GDI e que usa a renderização remota de fluxo de comando Direct3D, se estiver disponível.

minLevel

Tipo: D2D1_FEATURE_LEVEL

O nível mínimo de recurso direct3D necessário para a renderização de hardware. O valor padrão, D2D1_FEATURE_LEVEL_DEFAULT, indica que o Direct2D deve determinar se o nível de recurso Direct3D do dispositivo é adequado. Esse campo é usado somente quando objetos ID2D1HwndRenderTarget e ID2D1DCRenderTarget são criados. Para obter mais informações, consulte D2D1_RENDER_TARGET_PROPERTIES.

Valor retornado

Tipo: D2D1_RENDER_TARGET_PROPERTIES

Um D2D1_RENDER_TARGET_PROPERTIES que contém as configurações especificadas.

Requisitos

Confira também

Estrutura D2D1_RENDER_TARGET_PROPERTIES

Formatos de pixel e modos alfa com suporte