Método ID2D1ImageSourceFromWic::EnsureCached(constD2D1_RECT_U&) (d2d1_3.h)

Garante que uma região especificada do cache de origem da imagem seja preenchida. Esse método pode ser usado para minimizar falhas executando um trabalho caro para preencher caches fora de um loop de renderização. Esse método também pode ser usado para carregar dados de imagem especulativamente antes que eles sejam necessários por rotinas de desenho.

Sintaxe

HRESULT EnsureCached(
  [ref] const D2D1_RECT_U & rectangleToFill
);

Parâmetros

[ref] rectangleToFill

Tipo: const D2D1_RECT_U

Especifica a região da imagem, em pixels, que deve ser preenchida no cache. Por padrão, essa é toda a extensão da imagem.

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

Essa API carregará dados de imagem em caches de fontes de imagem, caso esses dados ainda não tenham sido armazenados em cache. Ele não corta caches pré-existentes, se houver.
Mais áreas dentro do cache podem ser preenchidas do que realmente solicitado.

A região fornecida deve ser construída para incluir a escala com a qual a origem da imagem será desenhada posteriormente.
Essas coordenadas devem ser fornecidas em coordenadas locais.
Isso significa que eles devem ser ajustados antes de chamar a API de acordo com o DPI e outras transformações relevantes, que podem incluir a transformação mundial e as transformações de pincel.

Essa operação só tem suporte quando a origem da imagem é inicializada usando a opção D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND.

Requisitos

Confira também

ID2D1ImageSourceFromWic