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