Spec-Zone.ru › Qt 5.11

Тип QML ConicalGradient

Рисует конический градиент. Подробнее...

Заявление об импорте: import QtGraphicalEffects 1.0
С момента: QtGraphicalEffects 1.0
Наследует:

Item

  • Список всех членов, включая унаследованные члены

Свойства

  • angle : real
  • cached : bool
  • gradient : Gradient
  • horizontalOffset : real
  • source : variant
  • verticalOffset : real

Подробное описание

Градиент определяется двумя или более цветами, которые плавно смешиваются. Цвета начинаются от указанного угла и заканчиваются на 360 градусов большем значении угла.

Примененный эффект

Примечание: Этот эффект доступен при работе с OpenGL.

Пример

Следующий пример демонстрирует, как применить эффект.

import QtQuick 2.0
import QtGraphicalEffects 1.0

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: undefined source:
angle: 0 angle: 0
horizontalOffset: 0 horizontalOffset: 0
verticalOffset: 0 verticalOffset: 0

Примечание: Не поддерживается включение эффекта в себя, например, путем установки источника в родителя эффекта.

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/archives/qt-5.11/qml-qtgraphicaleffects-conicalgradient.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API