Интерфейс ID2D1RadialGradientBrush (d2d1.h)
Закраска области с применением радиального градиента
Наследование
Интерфейс ID2D1RadialGradientBrush наследуется от ID2D1Brush. ID2D1RadialGradientBrush также содержит следующие типы элементов:
Методы
Интерфейс ID2D1RadialGradientBrush содержит следующие методы.
| ID2D1RadialGradientBrush::GetCenter Извлекает центр эллипса градиента. |
| ID2D1RadialGradientBrush::GetGradientOriginOffset Извлекает смещение источника градиента относительно центра эллипса градиента. |
| ID2D1RadialGradientBrush::GetGradientStopCollection Извлекает id2D1GradientStopCollection, связанный с этим объектом кисти радиального градиента. |
| ID2D1RadialGradientBrush::GetRadiusX Извлекает радиус x эллипса градиента. |
| ID2D1RadialGradientBrush::GetRadiusY Извлекает радиус Y эллипса градиента. |
| ID2D1RadialGradientBrush::SetCenter Задает центр эллипса градиента в пространстве координат кисти. |
| ID2D1RadialGradientBrush::SetGradientOriginOffset Указывает смещение источника градиента относительно центра эллипса градиента. |
| ID2D1RadialGradientBrush::SetRadiusX Задает радиус x эллипса градиента в пространстве координат кисти. |
| ID2D1RadialGradientBrush::SetRadiusY Указывает радиус Y эллипса градиента в пространстве координат кисти. |
Комментарии
ID2D1RadialGradientBrush похож на ID2D1LinearGradientBrush тем, что они сопоставляют коллекцию остановок градиента с градиентом. Однако линейный градиент имеет начальную и конечную точки для определения вектора градиента, в то время как радиальный градиент использует многоточие и источник градиента для определения его поведения градиента. Чтобы определить положение и размер эллипса, используйте методы SetCenter, SetRadiusX и SetRadiusY , чтобы указать центр, радиус x и радиус y эллипса. Источником градиента является центр эллипса, если смещение градиента не указано с помощью метода SetGradientOriginOffset .
Кисть сопоставляет позицию остановки градиента 0,0f источника градиента, а позиция 1,0f сопоставляется с границей эллипса. Если источник градиента находится в пределах эллипса, содержимое эллипса заключает весь диапазон [0, 1] градиента кисти. Если источник градиента находится за пределами эллипса, кисть по-прежнему работает, но ее градиент не определен правильно.
Начальная и конечная точки описываются в пространстве кисти и сопоставляются с целевым объектом отрисовки при использовании кисти. Обратите внимание, что начальная и конечная координаты являются абсолютными, а не относительно размера целевого объекта отрисовки. Значение (0, 0) сопоставляется с левым верхним углом целевого объекта отрисовки, а значение (1, 1) сопоставляет только один пиксель по диагонали от (0, 0). Если имеется преобразование кисти неидентности или преобразование целевого объекта отрисовки, также преобразуются эллипс кисти и источник градиента.
Можно указать эллипс, который не полностью заполняет закрашиваемую область. В этом случае D2D1_EXTEND_MODE и параметр (заданный в кисти ID2D1GradientStopCollection) определяет, как закрашивается оставшаяся область.
Создание объектов ID2D1RadialGradientBrush
Чтобы создать радиальную кисть градиента, используйте метод ID2D1RenderTarget::CreateRadialGradientBrush целевого объекта отрисовки, в котором будет использоваться кисть. Кисть может использоваться только с целевым объектом отрисовки, который ее создал, или с совместимыми целевыми объектами для этого целевого объекта отрисовки.Радиальная градиентная кисть — это ресурс, зависящий от устройства. Приложение должно создавать радиальные градиентные кисти после инициализации целевого объекта отрисовки, с помощью которого будут использоваться кисти, и повторно создавать кисти, когда требуется воссоздать целевой объект отрисовки. (Дополнительные сведения о ресурсах см. в разделе Общие сведения о ресурсах.)
Примеры
Пример создания радиальной градиентной кисти см. в разделе Создание кисти радиального градиента .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | d2d1.h |