Método ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U*) (d2d1_3.h)

Esse método corta as regiões preenchidas do cache de origem da imagem apenas para o retângulo especificado.

Sintaxe

HRESULT TrimCache(
  [in, optional] const D2D1_RECT_U *rectangleToPreserve
);

Parâmetros

[in, optional] rectangleToPreserve

Tipo: const D2D1_RECT_U*

Especifica a região da imagem, em pixels, que deve ser preservada no cache de origem da imagem. Regiões que estão fora do retângulo são removidas do cache. Por padrão, esse é um retângulo vazio, o que significa que toda a imagem é removida do cache.

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

A região fornecida deve ser construída para incluir a escala na qual a origem da imagem será desenhada. 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.

Esse método falhará se o cache sob demanda não tiver sido solicitado quando a origem da imagem foi criada.

Assim como acontece com ID2D1Device::ClearResources, o chamador pode precisar emitir posteriormente uma liberação D3D antes que o uso da memória seja reduzido.

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