Метод ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U*) (d2d1_3.h)
Этот метод обрезает заполненные области исходного кэша изображений только до указанного прямоугольника.
Синтаксис
HRESULT TrimCache(
[in, optional] const D2D1_RECT_U *rectangleToPreserve
);
Параметры
[in, optional] rectangleToPreserve
Тип: const D2D1_RECT_U*
Указывает область изображения в пикселях, которая должна сохраняться в исходном кэше изображения. Регионы, которые находятся за пределами прямоугольника, удаляются из кэша. По умолчанию это пустой прямоугольник, то есть весь образ вытесниется из кэша.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Указанная область должна быть сконструирована таким образом, чтобы она включала масштаб, в котором будет нарисован источник изображения. Эти координаты должны быть указаны в локальных координатах.
Это означает, что они должны быть скорректированы перед вызовом API в соответствии с DPI и другими соответствующими преобразованиями, которые могут включать преобразование мира и преобразования кисти.
Этот метод завершится ошибкой, если при создании источника образа не было запрошено кэширование по запросу.
Как и в случае с ID2D1Device::ClearResources, вызывающей объекту может потребоваться впоследствии выдать диск D3D, прежде чем будет сокращено использование памяти.
Эта операция поддерживается только в том случае, если источник образа инициализирован с помощью параметра D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | d2d1_3.h |
| Библиотека | D2d1_3.lib |
| DLL | D2d1_3.dll |