Тип QML ConicalGradient
Рисует конический градиент. Подробнее...
| Оператор импорта: | import QtGraphicalEffects 1.13 |
| С тех пор: | QtGraphicalEffects 1.0 |
| Наследует: |
Свойства
- угол : вещественное число
- кэшированный : логическое значение
- градиент : Gradient
- горизонтальноеСмещение : вещественное число
- источник : вариант
- вертикальноеСмещение : вещественное число
Подробное описание
Градиент определяется двумя или более цветами, которые плавно смешиваются. Цвета начинаются от указанного угла и заканчиваются через 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" }
}
}
} Документация по свойствам
угол : вещественное число
Это свойство определяет начальный угол, где цвет в позиции градиента 0,0 отображается. Цвета с большими значениями позиции отображаются в более крупных значениях угла и плавно смешиваются. Значения угла увеличиваются по часовой стрелке.
| Примеры вывода с различными значениями угла | ||
|---|---|---|
| угол: 0 | угол: 45 | угол: 185 |
| горизонтальноеСмещение: 0 | горизонтальноеСмещение: 0 | горизонтальноеСмещение: 0 |
| вертикальноеСмещение: 0 | вертикальноеСмещение: 0 | вертикальноеСмещение: 0 |
кэшированный : логическое значение
Это свойство позволяет кэшировать выходные пиксели эффекта для повышения производительности рендеринга.
Каждый раз, когда изменяются свойства источника или эффекта, пиксели в кэше должны обновляться. Потребление памяти увеличивается, так как для хранения выходных данных эффекта требуется дополнительный буфер памяти.
Рекомендуется отключить кэш при анимации свойств источника или эффекта.
По умолчанию свойство установлено в false.
градиент : Gradient
Градиент определяется двумя или более цветами, которые плавно смешиваются. Цвета задаются набором элементов дочерних элементов GradientStop, каждый из которых определяет позицию на градиенте (от 0,0 до 1,0) и цвет. Позиция каждого GradientStop определяется свойством position. Цвет определяется свойством color.
| Примеры вывода с различными значениями градиента | ||
|---|---|---|
градиент: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 {
GradientStop {
position: 0.0
color: "#F0F0F0"
}
GradientStop {
position: 0.5
color: "#000000"
}
GradientStop {
position: 1.0
color: "#F0F0F0"
}
} |
градиент:Gradient {
GradientStop {
position: 0.0
color: "#00000000"
}
GradientStop {
position: 1.0
color: "#FF000000"
}
} |
| угол: 0 | угол: 0 | угол: 0 |
| горизонтальноеСмещение: 0 | горизонтальноеСмещение: 0 | горизонтальноеСмещение: 0 |
| вертикальноеСмещение: 0 | вертикальноеСмещение: 0 | вертикальноеСмещение: 0 |
горизонтальноеСмещение : вещественное число
Свойства horizontalOffset и вертикальноеСмещение определяют смещение в пикселях для центральной точки градиента по сравнению с центром элемента.
Значение изменяется от -inf до inf. По умолчанию свойства установлены в 0.
| Примеры вывода с различными значениями horizontalOffset | ||
|---|---|---|
| горизонтальноеСмещение: -50 | горизонтальноеСмещение: 0 | горизонтальноеСмещение: 50 |
| угол: 0 | угол: 0 | угол: 0 |
| вертикальноеСмещение: 0 | вертикальноеСмещение: 0 | вертикальноеСмещение: 0 |
источник : вариант
Это свойство определяет элемент, который будет заполнен градиентом. Элемент источника отображается в промежуточном буфере пикселей, а значения альфа из результата используются для определения видимости пикселей градиента на дисплее. Значение по умолчанию для источника — неопределенное, и в этом случае вся область эффекта заполняется градиентом.
| Примеры вывода с различными значениями источника | |
|---|---|
| источник: неопределенный | источник: |
| угол: 0 | угол: 0 |
| горизонтальноеСмещение: 0 | горизонтальноеСмещение: 0 |
| вертикальноеСмещение: 0 | вертикальноеСмещение: 0 |
Примечание: Не поддерживается включение эффекта в себя, например, путем установки источника в родителя эффекта.
вертикальноеСмещение : вещественное число
Свойства горизонтальноеСмещение и verticalOffset определяют смещение в пикселях для центральной точки градиента по сравнению с центром элемента.
Значение изменяется от -inf до inf. По умолчанию свойства установлены в 0.
| Примеры вывода с различными значениями горизонтальногоСмещения | ||
|---|---|---|
| горизонтальноеСмещение: -50 | горизонтальноеСмещение: 0 | горизонтальноеСмещение: 50 |
| угол: 0 | угол: 0 | угол: 0 |
| вертикальноеСмещение: 0 | вертикальноеСмещение: 0 | вертикальноеСмещение: 0 |
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qml-qtgraphicaleffects-conicalgradient.html