Método ID2D1DeviceContext2::CreateImageSourceFromWic(IWICBitmapSource*,D2D1_IMAGE_SOURCE_LOADING_OPTIONS,D2D1_ALPHA_MODE,ID2D1ImageSourceFromWic**) (d2d1_3.h)

  • Artigo

Cria um objeto de origem de imagem de uma fonte de bitmap WIC, ao mesmo tempo em que preenche toda a memória de pixel dentro da origem da imagem.
A imagem é carregada e armazenada enquanto usa uma quantidade mínima de memória.

Sintaxe

HRESULT CreateImageSourceFromWic(
  [in]  IWICBitmapSource                  *wicBitmapSource,
        D2D1_IMAGE_SOURCE_LOADING_OPTIONS loadingOptions,
        D2D1_ALPHA_MODE                   alphaMode,
  [out] ID2D1ImageSourceFromWic           **imageSource
);

Parâmetros

[in] wicBitmapSource

Tipo: IWICBitmapSource*

A origem do bitmap wic da qual criar a origem da imagem.

loadingOptions

Tipo: D2D1_IMAGE_SOURCE_LOADING_OPTIONS

Opções para criar a origem da imagem. As opções padrão serão usadas se NULL.

alphaMode

Tipo: D2D1_ALPHA_MODE

O modo alfa da imagem; isso será determinado automaticamente do formato de pixel da origem se D2D1_ALPHA_MODE_UNKNOWN for passado.

[out] imageSource

Tipo: ID2D1ImageSourceFromWic**

Recebe a nova instância de origem da imagem.

Retornar valor

Tipo: HRESULT

S_OK se tiver êxito, caso contrário, um HRESULT de falha.

Comentários

Esse método cria uma fonte de imagem que pode ser usada para desenhar a imagem.

Esse método dá suporte a imagens que excedem o tamanho máximo da textura. Imagens grandes são armazenadas internamente em um cache de blocos esparso.

Essa API dá suporte ao mesmo conjunto de formatos de pixel e modos alfa compatíveis com CreateBitmapFromWicBitmap.
Se a GPU não der suporte a um determinado formato de pixel, esse método retornará D2DERR_UNSUPPORTED_PIXEL_FORMAT. Esse método não aplica ajustes como pré-multiplicação de gama ou alfa que afetam a aparência da imagem.

O parâmetro alphaMode não deve ser definido como D2D1_ALPHA_MODE_STRAIGHT. Esse método falhará se a origem do WIC usar um formato de pixel com alfa reto, a menos que o modo alfa seja substituído definindo o parâmetro alphaMode como D2D1_ALPHA_MODE_PREMULTIPLIED ou D2D1_ALPHA_MODE_IGNORE.

Se o formato da origem tiver um canal alfa, D2D1_ALPHA_MODE_IGNORE deverá ser passado.
Se D2D1_ALPHA_MODE_IGNORE for passado e o formato da origem tiver um canal alfa, o canal alfa será ignorado.

Esse método seleciona automaticamente um formato de armazenamento apropriado para minimizar o uso de memória de GPU, como o uso de texturas separadas de luminância e chrominance para imagens JPEG.

Se o argumento loadingOptions for NULL, D2D usará D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2016 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1_3.h
DLL D2d1.dll

Confira também

ID2D1DeviceContext2