Compartilhar via


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

Cria um objeto de origem de imagem de uma origem 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,
  [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.

[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 gama ou alfa que afetam a aparência da imagem.

Esse método seleciona automaticamente um formato de armazenamento apropriado para minimizar o uso de memória de GPU, como usar texturas separadas de luminância e crominância 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