Spec-Zone.ru › Qt 5.13

Тип QML ConicalGradient

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

Оператор импорта: import QtGraphicalEffects 1.13
С тех пор: QtGraphicalEffects 1.0
Наследует:

Item

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

Свойства

  • угол : вещественное число
  • кэшированный : логическое значение
  • градиент : 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

Spec-Zone.ru

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