Тип QML ConicalGradient
Отображает конический градиент. Подробнее...
| Оператор импорта: | import QtGraphicalEffects 1.12 |
| С тех пор: | QtGraphicalEffects 1.0 |
| Наследует: |
Свойства
- angle : real
- cached : bool
- gradient : Gradient
- horizontalOffset : real
- source : variant
- verticalOffset : real
Подробное описание
Градиент определяется двумя или более цветами, которые плавно смешиваются. Цвета начинаются от указанного угла и заканчиваются на угле на 360 градусов больше.
| Применяемый эффект |
|---|
Примечание: Этот эффект доступен при работе с OpenGL.
Пример
Следующий пример демонстрирует, как применить эффект.
import QtQuick 2.12
import QtGraphicalEffects 1.12
Item {
width: 300
height: 300
ConicalGradient {
anchors.fill: parent
angle: 0.0
gradient: Gradient {
GradientStop { position: 0.0; color: "white" }
GradientStop { position: 1.0; color: "black" }
}
}
} Документация по свойствам
angle : real
Это свойство определяет начальный угол, где цвет в позиции градиента 0.0 отображается. Цвета в позициях с большими значениями отображаются в углах с большими значениями и плавно смешиваются. Значения углов увеличиваются по часовой стрелке.
| Примеры вывода с различными значениями угла | ||
|---|---|---|
| angle: 0 | angle: 45 | angle: 185 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
cached : bool
Это свойство позволяет кэшировать выходные пиксели эффекта для повышения производительности рендеринга.
Каждый раз, когда изменяются свойства источника или эффекта, пиксели в кэше должны быть обновлены. Потребление памяти увеличивается, так как для хранения выходных данных эффекта требуется дополнительный буфер памяти.
Рекомендуется отключать кэширование, когда свойства источника или эффекта анимируются.
По умолчанию свойство установлено в false.
gradient : Gradient
Градиент определяется двумя или более цветами, которые плавно смешиваются. Цвета задаются набором дочерних элементов GradientStop, каждый из которых определяет позицию на градиенте (от 0,0 до 1,0) и цвет. Позиция каждого GradientStop определяется свойством position. Цвет определяется свойством color.
| Примеры вывода с различными значениями градиента | ||
|---|---|---|
gradient:Gradient {
GradientStop {
position: 0.000
color: Qt.rgba(1, 0, 0, 1)
}
GradientStop {
position: 0.167
color: Qt.rgba(1, 1, 0, 1)
}
GradientStop {
position: 0.333
color: Qt.rgba(0, 1, 0, 1)
}
GradientStop {
position: 0.500
color: Qt.rgba(0, 1, 1, 1)
}
GradientStop {
position: 0.667
color: Qt.rgba(0, 0, 1, 1)
}
GradientStop {
position: 0.833
color: Qt.rgba(1, 0, 1, 1)
}
GradientStop {
position: 1.000
color: Qt.rgba(1, 0, 0, 1)
}
} |
gradient:Gradient {
GradientStop {
position: 0.0
color: "#F0F0F0"
}
GradientStop {
position: 0.5
color: "#000000"
}
GradientStop {
position: 1.0
color: "#F0F0F0"
}
} |
gradient:Gradient {
GradientStop {
position: 0.0
color: "#00000000"
}
GradientStop {
position: 1.0
color: "#FF000000"
}
} |
| angle: 0 | angle: 0 | angle: 0 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
horizontalOffset : real
Свойства horizontalOffset и verticalOffset определяют смещение в пикселях центральной точки градиента относительно центра элемента.
Значение находится в диапазоне от -inf до inf. По умолчанию свойства установлены в 0.
| Примеры вывода с различными значениями horizontalOffset | ||
|---|---|---|
| horizontalOffset: -50 | horizontalOffset: 0 | horizontalOffset: 50 |
| angle: 0 | angle: 0 | angle: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
source : variant
Это свойство определяет элемент, который будет заполнен градиентом. Элемент источника отображается в промежуточном буфере пикселей, а значения альфа из результата используются для определения видимости пикселей градиента на дисплее. Значение по умолчанию для source — неопределенное, и в этом случае вся область эффекта заполняется градиентом.
| Примеры вывода с различными значениями source | |
|---|---|
| source: undefined | source: |
| angle: 0 | angle: 0 |
| horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 |
Примечание: Не поддерживается включение эффекта в себя, например, путем задания source для родителя эффекта.
verticalOffset : real
Свойства horizontalOffset и verticalOffset определяют смещение в пикселях центральной точки градиента относительно центра элемента.
Значение находится в диапазоне от -inf до inf. По умолчанию свойства установлены в 0.
| Примеры вывода с различными значениями horizontalOffset | ||
|---|---|---|
| horizontalOffset: -50 | horizontalOffset: 0 | horizontalOffset: 50 |
| angle: 0 | angle: 0 | angle: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qml-qtgraphicaleffects-conicalgradient.html