Spec-Zone.ru › Qt 5.15

Тип QML ConicalGradient

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

Заявление об импорте: import QtGraphicalEffects 1.15
С тех пор: 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 определяют смещение в пикселях для центральной точки градиента по сравнению с центром элемента.

Значение изменяется от -беск. до +беск. По умолчанию свойства установлены в 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

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

verticalOffset : real

Свойства horizontalOffset и verticalOffset определяют смещение в пикселях для центральной точки градиента по сравнению с центром элемента.

Значение изменяется от -беск. до +беск. По умолчанию свойства установлены в 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.15/qml-qtgraphicaleffects-conicalgradient.html

Spec-Zone.ru

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